Подключите 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 Таблицам
- Подключите оба аккаунта. В приложении откройте Коннекторы и подключите Apple Ads, затем Google Drive. Таблицы и Документы работают на той же авторизации Google, так что это один экран согласия, а не три. Apple Ads подключается обменом ключами, а не кнопкой; руководство по настройке Apple Search Ads описывает это, включая то, как подключить Apple Search Ads к Claude или ChatGPT, где вы будете вводить запрос.
- Запросите первую выгрузку. «Выгрузи эффективность Apple Search Ads по кампаниям за последние 30 дней и положи в новую таблицу с названием Apple Ads.» Агент вызывает
apple_ads_report, затемcreate_sheetи возвращает ссылку. - Сделайте выгрузку регулярной. Та же фраза со словом «добавь» вместо «новая таблица», запущенная по расписанию из вашего клиента (запланированная задача в Claude или ChatGPT или cron-задача, вызывающая CLI Hermoso), каждый раз добавляет блок строк. Ничего не перезаписывается, пока вы этого не попросите.
- Подключите дашборд к таблице. Looker Studio, Power BI и Tableau читают Google Таблицы своими коннекторами.
Как выглядит таблица
Одна строка на сущность за период. Колонки соответствуют запрошенному уровню (кампания, группа объявлений, объявление, ключевое слово или поисковый запрос) плюс показатели, которые отдаёт Apple: показы, тапы, установки, расходы, TTR, CPT и CPA. Запросите ежедневную гранулярность, и каждая сущность получит строку за каждый день; запросите итоги, и строка будет одна. Агент может добавить строку общих итогов, а в отчётах App Store может оставлять сущности без показов, чтобы остановленное ключевое слово отображалось нулём, а не пропадало.
Поскольку агент формирует строки до записи, вы можете заказать ровно нужную таблицу: только ключевые слова выше порога расходов, название кампании рядом с её идентификатором, изменения за неделю, посчитанные до записи. Это та работа, которую выгрузка в 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 вместо таблицы?
Тот же отчёт доступен как сырой JSON из API Hermoso (POST /v1/tools/apple_ads_report) или из CLI. См. Экспорт Apple Search Ads в JSON и экспорт данных из Apple Search Ads для всех остальных мест назначения.
Частые вопросы
Как подключить Apple Search Ads к Google Таблицам?
Подключите Apple Ads и Google Drive в Hermoso, затем попросите агента поместить отчёт в таблицу. Он забирает строки через apple_ads_report и записывает их через create_sheet или append_to_sheet и возвращает ссылку.
Нужен ли Hermoso доступ ко всему моему Google Drive?
Нет. Он запрашивает drive.file, которая покрывает файлы, созданные Hermoso, и файлы, которые вы явно выбрали.
Какие уровни и показатели могут попасть в таблицу?
Уровень кампании, группы объявлений, объявления, ключевого слова или поискового запроса с показами, тапами, установками, расходами, TTR, CPT и CPA, как итогами или как ряд по часам, дням, неделям или месяцам.
Перезапишет ли запланированный отчёт мою таблицу?
Нет, если вы этого не попросите. Дописывание добавляет строки; замена: это очистка, за которой следует запись на вкладке, которую вы назвали, и агент делает это только тогда, когда запрос прямо об этом говорит.
Может ли Looker Studio или Power BI читать результат?
Да. У Hermoso нет собственного коннектора ни для одного из них, но оба читают Google Таблицы своими коннекторами, так что дашборд, построенный на таблице, обновляется по мере того, как агент дописывает в неё строки.
Может ли отчёт запускаться по расписанию?
Да, из клиента, в котором работает ваш агент: запланированная задача в Claude или ChatGPT или cron-задача, вызывающая CLI или API Hermoso. Каждый запуск забирает новый период и дописывает его.