Apple Ads와 Google Drive를 Hermoso에 연결하면 둘 다 같은 에이전트에서 호출할 수 있습니다. apple_ads_report가 성과 행을 가져오고, create_sheet와 append_to_sheet가 그 행을 내가 소유한 스프레드시트에 넣습니다. 내보내기 파일도, 웨어하우스도, 자격 증명을 쥔 세 번째 도구도 없습니다.
이렇게 동작합니다
“Apple Search Ads 지출을 키워드별로 가져와서 내 Apple Ads 시트에 추가해 줘.” 에이전트가 보고서를 호출하고, 행을 정리한 다음 추가합니다. 다음 월요일에 다시 요청하면 시트에 일주일분이 더해집니다.
Hermoso가 요청하는 Drive 범위는 drive.file입니다. 이것은 Hermoso가 만든 파일과 사용자가 고른 파일에만 닿으며, 전체 Drive에는 닿지 않습니다.
Apple Search Ads를 Google 시트에 연결하는 방법
- 두 계정을 연결합니다. 앱에서 커넥터를 열고 Apple Ads, 그다음 Google Drive를 연결하세요. Sheets와 Docs는 같은 Google 인증을 쓰므로 동의 화면은 세 개가 아니라 하나입니다. Apple Ads는 버튼이 아니라 키 교환입니다. Apple Search Ads 설정 가이드에서 다루며, 요청을 입력하게 될 Claude 또는 ChatGPT 연결 방법도 함께 설명합니다.
- 첫 가져오기를 요청합니다. “Apple Search Ads 성과를 최근 30일 기준 캠페인별로 가져와서 Apple Ads라는 새 시트에 넣어 줘.” 에이전트가
apple_ads_report를 호출하고,create_sheet를 실행한 다음 링크를 돌려줍니다. - 정기적으로 만듭니다. “새 시트” 대신 “추가”라고 말하는 같은 문장을, 사용하는 클라이언트의 예약 기능(Claude나 ChatGPT의 예약 작업, 또는 Hermoso CLI를 호출하는 cron 작업)으로 실행하세요. 실행할 때마다 한 블록의 행이 추가됩니다. 요청하지 않는 한 아무것도 덮어쓰지 않습니다.
- 대시보드를 시트에 연결합니다. Looker Studio, Power BI, Tableau는 모두 자체 커넥터로 Google 시트를 읽습니다.
시트의 모습
행 하나는 항목 하나와 기간 하나입니다. 열은 요청한 단위(캠페인, 광고 그룹, 광고, 키워드 또는 검색어)를 따르며, Apple이 보고하는 지표가 붙습니다. 노출, 탭, 설치, 지출, TTR, CPT, CPA. 일별 단위를 요청하면 항목마다 하루에 한 행이 생기고, 총합을 요청하면 한 행이 됩니다. 에이전트는 총계 행을 추가할 수 있고, App Store 보고서에서는 전달 실적이 없는 항목을 유지해서 일시중지된 키워드가 사라지지 않고 0으로 표시되게 할 수 있습니다.
에이전트가 행을 쓰기 전에 정리하므로, 원하는 시트를 정확히 요청할 수 있습니다. 지출 기준선을 넘는 키워드만, 캠페인 이름을 ID 옆에 나란히, 쓰기 전에 주간 변화량을 계산한 값 등이 가능합니다. CSV 내보내기라면 그 작업을 직접 해야 합니다.
추가, 교체 또는 서식
시트 도구는 편집 전 과정을 다룹니다. append_to_sheet는 행을 추가하고, update_sheet는 범위를 제자리에서 씁니다. 교체(쌓이지 않게)가 필요하면 clear_sheet_range로 먼저 비우고, format_sheet는 머리글, 너비, 숫자 형식을 처리하며, manage_sheet_tabs는 캠페인이나 월마다 탭을 따로 줍니다. “대시보드 시트 새로 고침” 요청은 지정한 탭을 비우고 다시 쓰는 작업입니다.
시트에서 Apple Search Ads를 Looker Studio로 내보내기
Hermoso에는 기본 Looker Studio 커넥터가 없으며, 시트가 다리 역할을 합니다. Looker Studio에서 데이터 소스를 만들고 Google Sheets를 고른 다음, 에이전트가 추가하는 스프레드시트와 탭을 선택하세요. 보고서는 한 번 만들어 두면 됩니다. 추가되는 모든 행은 실행 사이에 열 머리글이 같게 유지되는 한, 대시보드의 다음 데이터 새로고침 때 나타납니다. 같은 방식이 Power BI와 Tableau에서도 통합니다.
시트 대신 JSON을 원하시나요?
같은 보고서를 Hermoso API(POST /v1/tools/apple_ads_report) 또는 CLI에서 원시 JSON으로 받을 수 있습니다. Apple Search Ads를 JSON으로 내보내기를 보고, 다른 모든 대상은 Apple Search Ads에서 데이터 내보내기에서 확인하세요.
자주 묻는 질문
Apple Search Ads를 Google 시트에 어떻게 연결하나요?
Hermoso에서 Apple Ads와 Google Drive를 연결한 다음, 에이전트에게 보고서를 시트에 넣어 달라고 요청하세요. apple_ads_report로 행을 가져오고, create_sheet나 append_to_sheet로 쓴 다음 링크를 돌려줍니다.
Hermoso가 내 Google Drive 전체에 접근해야 하나요?
아니요. Hermoso는 drive.file을 요청하며, 이는 Hermoso가 만든 파일과 사용자가 명시적으로 고른 파일에만 해당합니다.
어떤 단위와 지표를 시트에 넣을 수 있나요?
캠페인, 광고 그룹, 광고, 키워드 또는 검색어 단위에서, 노출, 탭, 설치, 지출, TTR, CPT, CPA를 총합으로 또는 시간별, 일별, 주별, 월별 시계열로 가져올 수 있습니다.
예약된 보고서가 시트를 덮어쓰나요?
요청하지 않는 한 그렇지 않습니다. 추가는 행을 덧붙이고, 교체는 지정한 탭을 먼저 비운 다음 쓰는 작업입니다. 에이전트는 요청에 그렇게 하라고 적혀 있을 때만 교체합니다.
Looker Studio나 Power BI가 결과를 읽을 수 있나요?
네. Hermoso에는 둘 다를 위한 기본 커넥터가 없지만, 둘 다 자체 커넥터로 Google 시트를 읽습니다. 따라서 이 시트 위에 만든 대시보드는 에이전트가 추가할 때마다 새로 고쳐집니다.
보고서를 예약 실행할 수 있나요?
네. 에이전트가 실행되는 클라이언트에서 가능합니다. Claude나 ChatGPT의 예약 작업, 또는 Hermoso CLI나 API를 호출하는 cron 작업을 사용하세요. 실행할 때마다 새 기간을 가져와 추가합니다.