Apple Search Ads를 Sheets, Looker 또는 JSON으로 내보내기

Hermoso는 Apple Search Ads에 연결해 에이전트가 호출할 수 있는 도구로 제공합니다. Claude, ChatGPT, Cursor, Codex, Cline, CLI 또는 일반 HTTP에서 쓸 수 있습니다. apple_ads_report는 캠페인, 광고 그룹, 광고, 키워드, 검색어 단위의 성과를 가져오며, 행은 따로 옮겨 담아야 하는 CSV 파일이 아니라 데이터로 돌아옵니다.

Apple Search Ads 커넥터

Apple은 광고 API에 OAuth 흐름을 제공하지 않으므로, 연결은 버튼이 아니라 키 교환입니다. Hermoso가 서명 키를 생성하면 사용자는 그 공개 키 반쪽을 Apple Ads에 붙여넣고 ID 세 개를 다시 붙여넣습니다. Apple Search Ads 설정 가이드가 과정을 안내하며, 대부분이 찾지 못하는 Public Key 필드도 설명합니다. 한 번의 연결이 웹 앱, MCP 서버, CLI, REST API를 모두 담당하므로, 같은 내보내기를 Claude, ChatGPT 또는 Cursor에서 쓸 수 있습니다. Apple Search Ads를 Claude에 연결하거나 ChatGPT에 연결한 번만 하면, 그다음부터는 물어보기만 하면 됩니다.

보고는 그중 한 부분입니다. 같은 연결로 계정도 만들고 운영합니다. 캠페인, 광고 그룹, 키워드와 제외 키워드, 예산 주문, 타기팅, 키워드 추천, 변경 이력까지 포함합니다. Apple Ads 채널 페이지에서 모든 도구를 볼 수 있습니다.

보고서에 담기는 내용

한 번의 호출, 다섯 단계. apple_ads_report는 캠페인, 광고 그룹, 광고, 키워드 또는 검색어 단위로 보고하며, 모든 행에는 Apple 자체 대시보드가 보여 주는 지표가 담깁니다. 노출, 탭, 설치, 지출, TTR, CPT, CPA. 총합을 요청할 수도 있고, 시간별, 일별, 주별 또는 월별 시계열을 요청할 수도 있습니다. 행은 지출이 높은 순서로 정렬되어 페이지당 최대 5,000행까지 돌아오며, 요청하면 총계 행도 포함됩니다. App Store 보고서는 전달 실적이 없는 항목도 포함할 수 있어서, 일시중지된 키워드가 빠지지 않고 0으로 표시됩니다.

Apple이 강제하는 두 가지 규칙이 있는데, 도구는 이를 조용히 실패하지 않고 설명합니다. 캠페인 단위보다 낮은 수준의 보고서에는 캠페인 ID가 필요합니다. 계정 전체를 다룰 수 있는 것은 캠페인 단위 보고서뿐입니다. 그리고 검색어 보고서는 항상 조직의 시간대로 실행되며, UTC로 실행되지 않습니다. Apple Maps 광고도 포함됩니다. 비즈니스 브랜드 보고서는 같은 도구에서 매개변수 하나만 바꾸면 나옵니다.

Apple Search Ads를 Google 시트에 연결하기

이것은 Hermoso가 직접 쓰는 유일한 대상입니다. Google Drive를 Apple Ads 옆에 연결하고(Google 인증 하나로 Drive, Sheets, Docs가 모두 처리됩니다), 이렇게 요청하세요. “Apple Search Ads 성과를 최근 30일 기준 키워드별로 가져와서 ‘Apple Ads’라는 새 시트에 넣어 줘.” 에이전트는 apple_ads_report를 호출한 다음 create_sheet를 실행하고 링크를 돌려줍니다. 다음 주에 같은 요청에 “추가”라고 말하면 append_to_sheet가 행을 덧붙이고, 처음부터 다시 시작하지 않습니다.

Hermoso가 Google에 요청하는 Drive 범위는 drive.file입니다. 이것은 Hermoso가 만든 파일과 사용자가 고른 파일에만 닿으며, 전체 Drive에는 닿지 않습니다. 탭을 제자리에서 바꾸는 방법과 서식까지 포함한 전체 안내는 Apple Search Ads를 Google 시트에 연결하기에 있습니다.

Apple Search Ads를 Looker Studio로 내보내기

Hermoso에는 기본 Looker Studio 커넥터가 없으며, 있는 척하지 않겠습니다. 없어도 됩니다. Looker Studio는 자체 내장 커넥터로 Google 시트를 읽으므로, 위의 시트가 다리 역할을 합니다.

에이전트가 보고서를 한 탭에 쓰게 합니다. 일별 단위, 키워드당 날짜마다 한 행, 머리글 행과 날짜 열. 날짜 열은 날짜 형식으로 지정해 달라고 요청하세요(format_sheet가 처리합니다). 그래야 Looker Studio가 날짜로 인식합니다.
시트를 데이터 소스로 추가합니다. Looker Studio에서 데이터 소스를 만들고 Google Sheets를 고른 다음, 스프레드시트와 해당 탭을 선택하고 Use first row as headers를 켜 둡니다.
보고서를 한 번 만듭니다. 일별 지출, 키워드별 CPA, 캠페인별 설치처럼, 매주 스프레드시트에서 다시 만들던 것들을 넣으세요.
계속 추가합니다. 매주 에이전트가 같은 탭에 새 행을 덧붙이면, 대시보드가 다음 데이터 새로고침 때 가져옵니다. Looker Studio는 머리글로 필드를 매핑하므로, 실행 사이에 열 이름을 같게 유지하세요.

같은 시트는 Power BI와 Tableau에서도 쓸 수 있으며, 둘 다 자체 Google 시트 커넥터를 갖고 있습니다.

Apple Search Ads를 JSON으로 내보내기

스프레드시트가 아니라 원본 행이 필요하다면 세 가지 방법이 있으며, 모두 같은 연결을 씁니다.

REST API. 모든 Hermoso 도구는 MCP & CLI 탭에서 만든 API 키로 POST /v1/tools/{name}에서 호출할 수 있습니다. 요청 본문은 도구의 인수이고, 응답의 data 필드가 구조화된 결과이며, 행은 data.rows에 있습니다.

curl -sX POST https://app.hermoso.ai/v1/tools/apple_ads_report \
  -H "Authorization: Bearer hmk_..." -H 'content-type: application/json' \
  -d '{"level":"keyword","campaignId":"1234567890","startTime":"2026-09-01","endTime":"2026-09-07","granularity":"DAILY"}' \
  | jq '.data.rows' > apple-search-ads.json

CLI. npx -y hermoso call apple_ads_report --json '{...}' --structured는 같은 구조화된 결과를 JSON으로 출력하므로, 파일로 리다이렉트하거나 다른 스크립트로 파이프할 수 있습니다.

에이전트. 어떤 채팅에서든 행을 JSON으로 요청하면, 요청한 모양으로 정리된 채 답변에 나옵니다.

긴 보고서의 경우 limit은 페이지당 최대 5,000행을 받고, offset으로 다음 페이지로 넘어갑니다. 결과의 hasMore는 다음 페이지가 있는지 알려 줍니다. 보고서를 읽어도 크레딧은 소모되지 않습니다. 전체 API 레퍼런스는 개발자 문서에 있습니다.

다른 대상

“직접”은 Hermoso가 쓴다는 뜻입니다. 나머지는 이미 쓰고 있는 도구가 스스로 하는 한 단계입니다.

Google Sheets, Google Docs, Google Drive, OneDrive: 직접.
Looker Studio, Power BI, Tableau: 시트를 통해서, 각각 자체 Google Sheets 커넥터를 사용합니다.
BigQuery: 시트를 통해서, 또는 자체 에이전트를 통해서. BigQuery는 Google 시트를 외부 테이블로 쿼리할 수 있습니다. BigQuery 클라이언트와 프로젝트 자격 증명이 있는 곳에서 에이전트를 실행하면, Hermoso가 돌려준 행을 바로 테이블에 넣을 수 있습니다.
Excel: 시트를 통해서, 또는 파일로. 시트를 .xlsx로 내려받거나, 에이전트가 Google Drive나 OneDrive에 파일을 남기게 하세요.
PostgreSQL, Redshift, Snowflake 또는 기타 웨어하우스: 자체 에이전트나 API를 통해서. Hermoso는 JSON을 돌려주며, 데이터베이스 자격 증명을 가진 쪽이 그것을 기록합니다. Hermoso는 웨어하우스 자격 증명을 보관하지 않습니다.

주간 내보내기 자동화

프롬프트가 곧 자동화입니다. 예를 들어 “매주 월요일, 모든 캠페인의 지난주 Apple Search Ads 성과를 키워드별로 가져와 Apple Ads 시트에 추가하고, CPA가 가장 많이 움직인 키워드를 알려 줘”라는 문장만으로 완전한 작업이 됩니다. 사용하는 클라이언트의 예약 기능(Claude나 ChatGPT의 예약 작업, 또는 Hermoso CLI나 API를 호출하는 cron 작업)으로 주기적으로 실행하면, 시트와 그 시트를 읽는 모든 대시보드가 최신 상태를 유지합니다.

같은 연결이 계정도 편집하므로, 보고서와 수정이 한 곳에 있습니다. 어떤 키워드의 CPA가 두 배가 된 것을 발견한 에이전트가, 같은 대화에서 그 키워드를 일시중지하거나 제외 키워드를 추가할 수 있습니다.

자주 묻는 질문

Apple Search Ads 데이터는 어떻게 내보내나요?

Apple Ads를 Hermoso에 한 번 연결한 다음, 원하는 보고서를 에이전트에게 요청하세요. 예를 들어 지난주 키워드별 성과입니다. apple_ads_report 도구가 Apple의 보고 API에서 데이터를 가져오고, 에이전트가 Google 시트에 쓰거나, JSON을 주거나, 둘 다 합니다.

Apple Search Ads를 Google 시트에 연결할 수 있나요?

네. Hermoso에서 Apple Ads와 Google Drive를 연결한 다음, 에이전트에게 보고서를 시트에 넣어 달라고 요청하세요. create_sheet로 새 시트를 만들거나 append_to_sheet로 기존 시트에 행을 추가할 수 있으며, 매주 반복할 수 있습니다.

Apple Search Ads를 Looker Studio로 내보낼 수 있나요?

네, Google 시트를 통해서입니다. Hermoso에는 기본 Looker Studio 커넥터가 없습니다. 에이전트가 보고서를 시트에 쓰면, Looker Studio에서 그 시트를 Google Sheets 데이터 소스로 한 번 추가합니다. 그 뒤 추가되는 모든 행은 대시보드의 다음 새로고침 때 나타납니다.

Apple Search Ads 데이터를 JSON으로 어떻게 받나요?

API 키로 Hermoso API의 POST /v1/tools/apple_ads_report를 호출하고 응답의 data.rows를 읽거나, CLI에서 hermoso call apple_ads_report --json '{...}' --structured를 실행하세요. 둘 다 같은 행을 JSON으로 돌려줍니다.

Apple Search Ads에도 보고 API가 있나요?

있으며, Hermoso가 그 위에서 만들어졌습니다. apple_ads_report는 캠페인, 광고 그룹, 광고, 키워드, 검색어 단위의 성과를 다루고, 나머지 Apple Ads 도구들이 계정을 만들고 관리합니다.

검색어 보고서를 받을 수 있나요?

네. 검색어 단위를 요청하고 캠페인 이름을 지정하세요. Apple은 검색어를 캠페인별로만 제공하며, 조직의 시간대를 기준으로 합니다.

보고서 한 번에 행이 몇 개까지 나오나요?

페이지당 최대 5,000행이며, 지출이 높은 순서대로 정렬되고, 다음 페이지가 있는지 에이전트에게 알려 주는 표시가 함께 옵니다. 대부분 계정의 주간 키워드 보고서는 한 페이지에 들어갑니다.

Apple Maps 광고도 포함되나요?

네. 비즈니스 브랜드 캠페인의 보고서는 같은 도구에서, 프로모션 오브젝트 유형을 App Store 대신 Apple Maps로 설정하면 나옵니다.

설정하려면 개발자가 필요한가요?

아니요. 앱에서 Apple Ads를 한 번 연결한 다음, 평범한 말로 에이전트에게 요청하면 됩니다. 예를 들어 지난주 키워드별 데이터를 가져와서 시트에 넣어 달라고 하세요. API와 CLI는 직접 스크립트로 자동화하고 싶을 때를 위해 있습니다.

무료로 시작하세요. 카드는 필요 없으며, 모든 기능을 모든 플랜에서 씁니다.

무료로 시작하기 → 요금 보기

Apple Search Ads에서 데이터 내보내기