Експорт даних з Apple Search Ads

Hermoso підключається до Apple Search Ads і відкриває його як інструменти, які ваш агент може викликати: Claude, ChatGPT, Cursor, Codex, Cline, CLI або звичайний HTTP. apple_ads_report отримує ефективність на рівні кампанії, групи оголошень, оголошення, ключового слова та пошукового запиту, а рядки повертаються як дані, а не як CSV-файл, який потім треба кудись переносити.

Коннектор Apple Search Ads

Apple не публікує OAuth-потік для свого рекламного API, тож підключення: це обмін ключами, а не кнопка: Hermoso генерує ключ підпису, ви вставляєте його публічну частину в Apple Ads і повертаєте три ідентифікатори. Посібник з налаштування Apple Search Ads проводить через це, зокрема через поле Public Key, яке більшість людей не може знайти. Одне підключення обслуговує веб-застосунок, MCP-сервер, CLI і REST API, тож той самий експорт працює з Claude, ChatGPT або Cursor: підключіть Apple Search Ads до Claude або до ChatGPT один раз, а потім запитуйте.

Звітність: лише частина. Те саме підключення будує й веде обліковий запис: кампанії, групи оголошень, ключові слова та негативні ключові слова, бюджетні замовлення, таргетинг, пропозиції ключових слів та історію змін. Сторінка каналу Apple Ads перелічує кожен інструмент.

Що містить звіт

Один виклик, п’ять рівнів. apple_ads_report звітує на рівні кампанії, групи оголошень, оголошення, ключового слова або пошукового запиту, і кожен рядок містить показники, які показує власна панель Apple: покази, тапи, інсталяції, витрати, коефіцієнт тапів, вартість тапу та вартість інсталяції. Запросіть підсумки або серію з деталізацією погодинно, щодня, щотижня або щомісяця. Рядки повертаються впорядкованими за витратами, від найбільших, до 5 000 на сторінку, з рядком загальних сум за запитом. Звіти App Store можуть також включати сутності без показів, тож призупинене ключове слово відображається як нуль, а не як відсутній рядок.

Два правила, які нав’язує Apple і які інструмент пояснює замість мовчазної помилки: звіт нижче рівня кампанії потребує ідентифікатора кампанії (лише звіт на рівні кампанії може охопити весь обліковий запис), а звіти за пошуковими запитами виконуються в часовому поясі вашої організації, ніколи в UTC. Оголошення на Apple Maps також охоплені: звіт для бізнес-брендів надходить з того самого інструмента, з однією зміненою тут параметром.

Підключіть Apple Search Ads до Google Sheets

Це єдине призначення, куди 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.file, яка охоплює лише файли, створені ним, і ті, які ви вибрали, а не весь ваш Drive. Повна інструкція, включно із заміною вкладки на місці та її форматуванням, є на сторінці Підключіть Apple Search Ads до Google Sheets.

Експорт Apple Search Ads до Looker Studio

Hermoso не має нативного коннектора Looker Studio, і ми вважаємо за краще сказати це прямо, ніж натякати на інше. Він і не потрібен: Looker Studio читає Google Sheets своїм вбудованим коннектором, тож таблиця вище є мостом.

1. Нехай агент запише звіт в одну вкладку. Щоденна деталізація, один рядок на ключове слово на день, рядок заголовків і стовпець дати. Попросіть відформатувати стовпець дати як дату (format_sheet це робить), щоб Looker Studio сприймав його як дату.
2. Додайте таблицю як джерело даних. В Looker Studio створіть джерело даних, оберіть Google Sheets, виберіть таблицю та потрібну вкладку і залиште ввімкненим «Use first row as headers».
3. Побудуйте звіт один раз. Витрати за днями, вартість інсталяції за ключовими словами, інсталяції за кампаніями: те, що ви інакше перебудовували б у таблиці кожного понеділка.
4. Продовжуйте додавати рядки. Щотижня агент додає нові рядки на ту саму вкладку, і панель підхоплює їх під час наступного оновлення даних. Зберігайте однакові назви стовпців між запусками, бо Looker Studio зіставляє поля за заголовками.

Та сама таблиця працює для Power BI і Tableau, які мають власні коннектори Google Sheets.

Експорт Apple Search Ads до JSON

Якщо вам потрібні сирі рядки, а не таблиця, є три способи їх отримати, і всі вони використовують одне підключення.

REST API. Кожен інструмент Hermoso викликається через POST /v1/tools/{name} з API-ключем, який ви створюєте в застосунку на вкладці MCP & CLI. Тіло запиту: це аргументи інструмента, а поле 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 Sheet як зовнішню таблицю. Якщо ваш агент працює там, де є клієнт BigQuery і облікові дані вашого проєкту, він може вставити рядки, які повертає Hermoso, безпосередньо в таблицю.
• Excel: через таблицю або файл. Завантажте таблицю як .xlsx або попросіть агента залишити файл у Google Drive чи OneDrive.
• PostgreSQL, Redshift, Snowflake або будь-яке сховище: через власного агента або API. Hermoso повертає JSON; те, що зберігає облікові дані вашої бази даних, записує його. Hermoso не зберігає облікових даних сховища.

Автоматизація щотижневого експорту

Запит і є автоматизацією. Щось на кшталт "Щопонеділка отримуй показники Apple Search Ads за ключовими словами за минулий тиждень для кожної кампанії, додавай їх до таблиці Apple Ads і скажи мені, які ключові слова найбільше змінилися за вартістю інсталяції": це повноцінне завдання. Запускайте його за розкладом, який уже є у вашому клієнті (заплановані задачі в Claude або ChatGPT, або cron-завдання, що викликає CLI чи API Hermoso), і таблиця та всі панелі, які її читають, залишатимуться актуальними.

Оскільки те саме підключення також редагує обліковий запис, звіт і виправлення живуть в одному місці: агент, який помічає, що вартість інсталяції ключового слова подвоїлася, може призупинити його або додати негативний ключ у тій самій розмові.

Часті запитання

Як експортувати дані з Apple Search Ads?

Підключіть Apple Ads до Hermoso один раз, потім попросіть агента отримати потрібний звіт, наприклад показники за ключовими словами за минулий тиждень. Інструмент apple_ads_report отримує його з API звітності Apple, а агент записує його в Google Sheet, повертає вам JSON або і те, і інше.

Чи можна підключити Apple Search Ads до Google Sheets?

Так. Підключіть Apple Ads і Google Drive в Hermoso, потім попросіть агента помістити звіт у таблицю. Він створює таблицю через create_sheet або додає рядки до наявної через append_to_sheet і може повторювати це щотижня.

Чи можна експортувати Apple Search Ads до Looker Studio?

Так, через Google Sheets. Hermoso не має нативного коннектора Looker Studio. Агент записує звіт у таблицю, ви один раз додаєте цю таблицю як джерело даних Google Sheets в Looker Studio, і кожне додавання з’являється на панелі під час наступного оновлення.

Як експортувати дані Apple Search Ads у JSON?

Викличте POST /v1/tools/apple_ads_report в API Hermoso з API-ключем і прочитайте data.rows з відповіді, або виконайте hermoso call apple_ads_report --json '{...}' --structured з CLI. Обидва способи повертають ті самі рядки у форматі JSON.

Чи є API звітності Apple Search Ads?

Так, і Hermoso побудований на ньому. apple_ads_report охоплює ефективність на рівнях кампанії, групи оголошень, оголошення, ключового слова та пошукового запиту, а інші інструменти Apple Ads будують і ведуть обліковий запис.

Чи можна отримати звіти за пошуковими запитами Apple Search Ads?

Так. Запросіть рівень пошукового запиту і вкажіть кампанію. Apple показує пошукові запити лише по кампаніях, у часовому поясі організації.

Скільки рядків може повернути один звіт?

До 5 000 на сторінку, впорядкованих за витратами від найбільших до найменших, з прапорцем, що повідомляє агенту, чи є ще сторінки. Щотижневий звіт за ключовими словами для більшості облікових записів вміщується на одній сторінці.

Чи охоплює це оголошення на Apple Maps?

Так. Звіти для кампаній бізнес-брендів надходять з того самого інструмента, з типом просуваного об’єкта, встановленим на Apple Maps замість App Store.

Чи потрібен розробник, щоб це налаштувати?

Ні. Підключіть Apple Ads один раз у застосунку, потім попросіть агента звичайною мовою: отримай показники за минулий тиждень за ключовими словами і постав їх у таблицю. API і CLI є, якщо ви хочете це скриптувати.