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

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

Як це виглядає

"Отримайте витрати Apple Search Ads за ключовими словами за минулий тиждень і додайте їх до моєї таблиці Apple Ads." Агент викликає звіт, формує рядки і додає їх. Запитайте знову наступного понеділка, і таблиця за тиждень поповниться.

Область доступу Drive, яку запитує Hermoso, це drive.file. Вона охоплює файли, які створив Hermoso, або ті, які ви вибрали, а не весь ваш Drive.

Як підключити Apple Search Ads до Google Sheets

1. Підключіть обидва облікові записи. У застосунку відкрийте Коннектори і підключіть Apple Ads, потім Google Drive. Sheets і Docs працюють на тій самій авторизації Google, тож це один екран згоди, а не три. Apple Ads не має кнопки, тут обмін ключами; посібник з налаштування Apple Search Ads описує його, зокрема як підключити Apple Search Ads до Claude або ChatGPT, де ви писатимете запит.
2. Запросіть перше завантаження. "Отримайте показники Apple Search Ads за кампаніями за останні 30 днів і поставте їх у нову таблицю під назвою Apple Ads." Агент викликає apple_ads_report, потім create_sheet, і повертає вам посилання.
3. Зробіть це регулярним. Те саме речення, але зі словом «додай» замість «нова таблиця», запущене за розкладом у клієнті, яким ви користуєтесь (запланована задача в Claude або ChatGPT, або cron-завдання, що викликає CLI Hermoso), щоразу додає блок рядків. Нічого не перезаписується, доки ви прямо цього не попросите.
4. Направте свою панель на таблицю. Looker Studio, Power BI і Tableau читають Google Sheets своїми коннекторами.

Як виглядає таблиця

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

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

Додати, замінити або відформатувати

Інструменти Sheets покривають усе редагування: 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 замість таблиці?

Той самий звіт доступний як сирий JSON через API Hermoso (POST /v1/tools/apple_ads_report) або CLI. Див. Експорт Apple Search Ads до JSON і експорт даних з Apple Search Ads для кожного іншого призначення.

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

Як підключити Apple Search Ads до Google Sheets?

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

Чи потребує Hermoso доступу до всього мого Google Drive?

Ні. Він запитує drive.file, що охоплює файли, створені Hermoso, та файли, які ви явно вибрали.

Які рівні й показники можна помістити в таблицю?

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

Чи перезапише запланований звіт мою таблицю?

Ні, якщо ви цього не попросите. Додавання дописують рядки; заміна: це очищення, а потім запис у вказану вами вкладку, і агент робить це лише тоді, коли запит прямо це передбачає.

Чи можуть Looker Studio або Power BI читати результат?

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

Чи може звіт працювати за розкладом?

Так, з клієнта, в якому працює ваш агент: запланована задача в Claude або ChatGPT, або cron-завдання, що викликає CLI чи API Hermoso. Кожен запуск отримує новий період і додає його.