hermoso
Войти Начать
MCP & CLI
APIЦены
Войти Начать

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

У Apple есть API отчётов, но нет кнопки экспорта, которая доставляет цифры туда, где вы работаете. Коннектор Hermoso забирает отчёт за вас и кладёт его в Google Таблицу, дашборд Looker Studio или JSON-файл.

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: показы, тапы, установки, расходы, TTR, CPT и CPA. Запрашивайте итоги или ряд с гранулярностью по часам, дням, неделям или месяцам. Строки приходят отсортированными по расходам, от большего к меньшему, до 5 000 на страницу, со строкой общих итогов по запросу. Отчёты App Store могут включать сущности без показов, поэтому остановленное ключевое слово отображается нулём, а не пропадает.

Два правила Apple, которые инструмент объясняет, а не молча проваливает: отчёт ниже уровня кампании требует идентификатор кампании (только отчёт на уровне кампании охватывает весь аккаунт), а отчёты по поисковым запросам идут в часовом поясе вашей организации, никогда не в UTC. Объявления в Apple Maps тоже покрыты: отчёт по business-brands приходит из того же инструмента с одним изменённым параметром.

Подключите Apple Search Ads к Google Таблицам

Это единственное место назначения, в которое Hermoso пишет сам. Подключите Google Drive рядом с Apple Ads (одна авторизация Google покрывает Drive, Таблицы и Документы), затем попросите: «Выгрузи эффективность Apple Search Ads по ключевым словам за последние 30 дней и положи в новую таблицу с названием Apple Ads.» Агент вызывает apple_ads_report, затем create_sheet, и возвращает ссылку. На следующей неделе тот же запрос со словом «добавь» дописывает строки через append_to_sheet, а не начинает заново.

Hermoso запрашивает у Google область drive.file, которая касается только файлов, созданных им, и тех, что вы выбрали, а не всего вашего Drive. Полное руководство, включая замену вкладки на месте и её оформление, находится на странице Подключите Apple Search Ads к Google Таблицам.

Экспорт Apple Search Ads в Looker Studio

У Hermoso нет собственного коннектора Looker Studio, и лучше сказать об этом прямо, чем создавать видимость. Он и не нужен: Looker Studio читает Google Таблицы своим встроенным коннектором, поэтому таблица выше служит мостом.

  1. Пусть агент запишет отчёт в одну вкладку. Ежедневная гранулярность, одна строка на ключевое слово в день, строка заголовков и колонка с датой. Попросите отформатировать колонку с датой как дату (format_sheet это делает), чтобы Looker Studio читал её как дату.
  2. Добавьте таблицу как источник данных. В Looker Studio создайте источник данных, выберите Google Sheets, укажите таблицу и эту вкладку и оставьте включённым «Use first row as headers».
  3. Постройте отчёт один раз. Расходы по дням, CPA по ключевым словам, установки по кампаниям: всё, что иначе вы перестраивали бы в таблице каждый понедельник.
  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 Таблицу как внешнюю таблицу. Если ваш агент работает там, где есть клиент BigQuery и учётные данные вашего проекта, он может вставить строки, которые возвращает Hermoso, прямо в таблицу.
  • Excel: через таблицу или файл. Скачайте таблицу как .xlsx или попросите агента оставить файл в Google Drive или OneDrive.
  • PostgreSQL, Redshift, Snowflake или любое хранилище: через собственного агента или API. Hermoso отдаёт JSON; то, что хранит учётные данные вашей базы, пишет его туда. Hermoso не хранит учётных данных хранилища.

Автоматизация еженедельного экспорта

Сам запрос и есть автоматизация. Что-то вроде «Каждый понедельник выгружай эффективность Apple Search Ads за прошлую неделю по ключевым словам по всем кампаниям, дописывай в таблицу Apple Ads и скажи, какие ключевые слова сильнее всего сдвинулись по CPA»: готовая задача. Запускайте её по расписанию средствами вашего клиента (запланированные задачи в Claude или ChatGPT или cron-задача, вызывающая CLI или API Hermoso), и таблица, а вместе с ней все дашборды, которые её читают, останутся актуальными.

Поскольку то же подключение ещё и редактирует аккаунт, отчёт и исправление живут в одном месте: агент, который замечает, что CPA ключевого слова удвоился, может остановить его или добавить минус-слово в том же разговоре.

Частые вопросы

Как выгрузить данные из Apple Search Ads?

Подключите Apple Ads к Hermoso один раз, затем попросите агента нужный отчёт, например эффективность по ключевым словам за прошлую неделю. Инструмент apple_ads_report забирает его из API отчётов Apple, и агент записывает его в Google Таблицу, отдаёт вам JSON или и то, и другое.

Можно ли подключить Apple Search Ads к Google Таблицам?

Да. Подключите Apple Ads и Google Drive в Hermoso, затем попросите агента поместить отчёт в таблицу. Он создаёт таблицу через create_sheet или добавляет строки в существующую через append_to_sheet и может повторять это каждую неделю.

Можно ли экспортировать Apple Search Ads в Looker Studio?

Да, через Google Таблицы. У Hermoso нет собственного коннектора Looker Studio. Агент записывает отчёт в таблицу, вы один раз добавляете её в Looker Studio как источник данных Google Sheets, и каждое дописывание появляется на дашборде при следующем обновлении.

Как выгрузить данные Apple Search Ads в JSON?

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

Есть ли у Apple API отчётов для Search Ads?

Да, и Hermoso построен на нём. apple_ads_report охватывает эффективность кампании, группы объявлений, объявления, ключевого слова и поискового запроса, а остальные инструменты Apple Ads создают и ведут аккаунт.

Можно ли получить отчёты по поисковым запросам Apple Search Ads?

Да. Запросите уровень поискового запроса и назовите кампанию. Apple отдаёт поисковые запросы только по каждой кампании, в часовом поясе самой организации.

Сколько строк может вернуть один отчёт?

До 5 000 на страницу, отсортированных по расходам от большего к меньшему, с флагом, говорящим агенту, есть ли ещё страницы. Недельный отчёт по ключевым словам для большинства аккаунтов умещается на одной странице.

Покрывает ли это объявления в Apple Maps?

Да. Отчёты по кампаниям business-brands приходят из того же инструмента, если тип продвигаемого объекта установлен на Apple Maps вместо App Store.

Нужен ли разработчик для настройки?

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

Начните бесплатно, без карты, со всеми функциями на каждом тарифе.

Начать бесплатно →   Тарифы