Команды Ads Manager для Adapty Developer CLI

В этой статье перечислены все команды Ads Manager в Adapty CLI с аргументами, флагами и допустимыми значениями. Команды Ads Manager находятся в разделе adapty asa.

Требования, рекомендации по безопасной записи и примеры задач см. в разделе Управление Ads Manager из CLI.

Для этих команд требуется подключённый аккаунт Apple Ads и активная подписка Ads Manager. Выполните adapty asa whoami, чтобы проверить оба условия. Остальные команды CLI см. в справочнике команд.

Глобальные флаги

Эти флаги доступны для всех команд Ads Manager.

Флаг	Описание
`--json`	Вывод в формате JSON вместо форматированного текста
`--help`	Показать справку по команде

Все команды list также принимают флаги пагинации:

Флаг	По умолчанию	Описание
`--page`	`1`	Номер страницы
`--page-size`	`100`	Элементов на странице (макс.: 1000)

Страницы Ads Manager больше, чем в остальной части CLI. Предпочтительнее одна большая страница, чем цикл из небольших.

Все команды, изменяющие ваш аккаунт, принимают следующие флаги:

Флаг	Описание
`--yes`, `-y`	Применить без запроса подтверждения. Обязателен, когда вывод перенаправляется или используется `--json`
`--idempotency-key`	Фиксированный ключ для этой операции записи. Повторный запрос с тем же ключом и телом в течение 24 часов возвращает сохранённый результат вместо повторного применения изменения

Команды Ads Manager не принимают флаг --app. Область действия — компания, которой принадлежит ваш токен. --app присутствует в некоторых командах list только как фильтр.

Фильтры списка

Фильтры сужают сам запрос, а не отображаемую страницу. Без фильтров keywords list перебирает все ключевые слова в аккаунте, поэтому ограничивайте каждый запрос нужным уровнем.

Фильтр	Принимается
`--campaign-group`	`campaigns`, `ad-groups`, `keywords`, `negative-keywords`, `search-terms`, `ads`, `creatives`, `product-pages`
`--app`	`campaigns`, `ad-groups`, `keywords`, `negative-keywords`, `search-terms`, `creatives`, `product-pages`
`--campaign`	`ad-groups`, `keywords`, `negative-keywords`, `search-terms`, `ads`
`--ad-group`	`keywords`, `negative-keywords`, `search-terms`, `ads`
`--status`	`campaigns`, `ad-groups`, `ads` (`ENABLED` или `PAUSED`), `keywords` (`ACTIVE` или `PAUSED`)
`--search`	`campaigns`, `ad-groups`, `keywords`, `negative-keywords`, `search-terms`, `ads`. Поиск подстроки в имени без учёта регистра

adapty asa apps list, orgs list, automations list и automations runs не поддерживают фильтры. Они принимают только флаги пагинации.

--campaign-group, --app, --campaign и --ad-group принимают UUID, которые выводит соответствующая команда list, и каждый из них можно указать несколько раз:

adapty asa keywords list --ad-group <ad-group-id> --ad-group <other-ad-group-id>

Если указать ID, принадлежащий другой компании, страница вернётся пустой — без ошибки.

Аккаунт

adapty asa whoami

Показывает компанию, способ предоставления доступа к Ads Manager и статус подключения Apple Ads.

adapty asa whoami

Запустите эту команду первой. Она покажет, выполнены ли два предварительных условия для всех остальных команд.

adapty asa connect

Подключение Apple Ads аккаунта к Adapty.

adapty asa connect

Команда выводит ссылку для авторизации через Apple и ожидает, пока Apple не сообщит об успешном подключении аккаунта.

Флаг	По умолчанию	Описание
`--wait` / `--no-wait`	`--wait`	Ожидать, пока Apple Ads сообщит о подключении. `--no-wait` — вернуть управление немедленно
`--timeout`	`300`	Количество секунд ожидания шага в браузере

adapty asa orgs list

Список групп кампаний (организаций Apple Ads), доступных вашей компании.

adapty asa orgs list

Каждая строка содержит два идентификатора, которые не взаимозаменяемы:

Поле	Используется как
`internal_id`	UUID, который принимает `--org` в `campaigns create`, а также `--campaign-group` в качестве фильтра списка
`org_id`	Числовой идентификатор организации Apple, принимаемый `--org-id` в `campaigns bulk-create`. `--org` и `--campaign-group` его не принимают

--org существует только у campaigns create. Ни одна из команд list его не принимает.

Каждая строка также содержит поле payment_model. Если его значение равно LOC, организация выставляет счёт по кредитной линии, и каждая кампания в ней требует флагов --invoice-*.

Принимает флаги пагинации.

adapty asa apps list

Список приложений, продвигаемых в Apple Ads.

adapty asa apps list

Каждая строка содержит два идентификатора, которые не взаимозаменяемы:

Поле	Используется как
`internal_id`	UUID, который принимает `--app` в качестве фильтра списка
`adam_id`	Числовой App Store ID от Apple, используемый с `--adam-id` в `campaigns create` и `product-pages sync`

Принимает флаги пагинации.

Кампании

adapty asa campaigns list

Список кампаний. Возвращает только метаданные — для получения показателей производительности используйте asa metrics.

adapty asa campaigns list --app <app-id> --status PAUSED

Принимает флаги пагинации и фильтры списка --campaign-group, --app, --search и --status.

adapty asa campaigns get

Получить сведения о конкретной кампании.

adapty asa campaigns get <campaign-id>

Argument	Description
`campaign-id`	Campaign ID (UUID)

adapty asa campaigns create

Создание кампании.

adapty asa campaigns create --org <campaign-group-id> --name "Winter push" --adam-id 123456 --country US --daily-budget 50

Флаг	Обязательный	Описание
`--org`	Да	ID группы кампаний (UUID). См. `orgs list`
`--name`	Да	Название кампании
`--adam-id`	Да	ID приложения в App Store (`adam_id`)
`--country`	Да	Код страны или региона. Для нескольких: `--country US --country CA`
`--daily-budget`	Да	Дневной бюджет в виде числа, например `50` или `12.50`
`--budget`	Нет	Общий бюджет
`--target-cpa`	Нет	Целевая стоимость привлечения. Должна быть ниже `--daily-budget`
`--currency`	Нет	Код валюты для сумм в этом запросе. По умолчанию: `USD`
`--bidding-strategy`	Нет	`MANUAL_CPT` или `MAX_CONVERSIONS`. Apple использует `MANUAL_CPT` по умолчанию
`--ad-channel-type`	Нет	`SEARCH` или `DISPLAY`. По умолчанию: `SEARCH`
`--billing-event`	Нет	`TAPS` или `IMPRESSIONS`. По умолчанию: `TAPS`
`--supply-source`	Нет	Источник трафика, можно указать несколько. По умолчанию: `APPSTORE_SEARCH_RESULTS`
`--status`	Нет	Начальный статус: `ENABLED` или `PAUSED`
`--invoice-advertiser`	Кредитная линия	Параметры выставления счёта: имя рекламодателя
`--invoice-order-number`	Кредитная линия	Параметры выставления счёта: номер заказа
`--invoice-contact-name`	Кредитная линия	Параметры выставления счёта: имя контактного лица покупателя
`--invoice-contact-email`	Кредитная линия	Параметры выставления счёта: email контактного лица покупателя
`--invoice-billing-email`	Кредитная линия	Параметры выставления счёта: email для выставления счёта

Организация с payment_model равным LOC выставляет счета по кредитной линии, и Apple требует указания параметров выставления счёта для каждой из её кампаний. Передавайте все пять флагов --invoice-* в одном вызове — неполный набор отклоняется до отправки запроса. См. Настройка параметров выставления счёта для кредитной линии.

Ответ содержит serving_status и serving_state_reasons. Кампания может быть создана, но не запущена: кампания с типом MAX_CONVERSIONS ждёт автоматической группы объявлений, а кампания с кредитной линией ждёт настройки параметров выставления счетов. В обоих случаях команда выводит причину и команду, которая её устраняет.

adapty asa campaigns update

Обновите существующую кампанию.

adapty asa campaigns update <campaign-id> --daily-budget 80 --status PAUSED

Аргумент	Описание
`campaign-id`	ID кампании (UUID)

Флаг	Описание
`--name`	Новое название кампании
`--status`	`ENABLED` или `PAUSED`
`--country`	Заменяет список стран. Повторите для нескольких
`--daily-budget`	Новый дневной бюджет
`--budget`	Новый общий бюджет
`--target-cpa`	Новая целевая стоимость привлечения
`--bidding-strategy`	`MANUAL_CPT` или `MAX_CONVERSIONS`
`--currency`	Код валюты для сумм в этом запросе. По умолчанию: `USD`
`--invoice-advertiser`	Параметры выставления счёта: название рекламодателя
`--invoice-order-number`	Параметры выставления счёта: номер заказа
`--invoice-contact-name`	Параметры выставления счёта: контактное имя покупателя
`--invoice-contact-email`	Параметры выставления счёта: контактный email покупателя
`--invoice-billing-email`	Параметры выставления счёта: email для выставления счёта

По меньшей мере один флаг обязателен.

Пять флагов --invoice-* работают как единое целое и полностью заменяют сохранённые параметры выставления счёта, поэтому передавайте все пять даже при изменении одного из них. Неполный набор отклоняется ещё до отправки запроса.

adapty asa campaigns bulk-create

Создайте всю структуру кампании — кампании с вложенными группами объявлений, ключевыми словами, минус-словами и объявлениями — за одну операцию.

adapty asa campaigns bulk-create --file structure.json

Конвертируйте нативный шаблон Apple Ads bulk вместо того, чтобы писать JSON вручную:

adapty asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567

Флаг	По умолчанию	Описание
`--file`	—	JSON-файл со структурой кампании или `-` для чтения из стандартного ввода
`--from-file`	—	Bulk-шаблон Apple Ads для конвертации на сервере: `Campaign_And_Adgroup_Template.xlsx` или ключевые слова `.csv`
`--org-id`	—	Числовой идентификатор организации Apple (`org_id`). См. `orgs list`. Обязателен при использовании `--from-file`
`--preview`	—	С `--from-file`: выводит сконвертированную структуру и завершает работу. Ничего не создаётся
`--wait` / `--no-wait`	`--wait`	Отслеживает операцию до её завершения. `--no-wait` выводит ID операции и возвращает управление
`--poll-interval`	`5`	Интервал между проверками прогресса в секундах
`--timeout`	`900`	Максимальное время ожидания завершения операции в секундах

Exactly one of --file and --from-file is required.

The structure names the campaign group at the top level and nests everything else:

{
  "campaign_group_id": 555777,
  "campaigns": [
    {
      "payload": {
        "name": "US Search",
        "adam_id": 123456,
        "countries_or_regions": ["US"],
        "daily_budget_amount": { "amount": "100", "currency": "USD" },
        "status": "ENABLED",
        "ad_channel_type": "SEARCH",
        "billing_event": "TAPS",
        "supply_sources": ["APPSTORE_SEARCH_RESULTS"]
      },
      "ad_groups": [
        {
          "payload": { "name": "Brand", "start_time": "2026-08-01T00:00:00Z", "status": "ENABLED" },
          "keywords": [{ "text": "meditation app", "match_type": "BROAD" }]
        }
      ]
    }
  ]
}

campaign_group_id принимает числовой идентификатор организации Apple; используйте campaign_group_internal_id, чтобы передать UUID. Узел с payload создаётся как новый объект. Узел, указывающий на существующий объект по его id, является якорем — используйте его, чтобы добавить группы объявлений в существующую кампанию, а поле update_payload позволяет изменить сам объект в той же операции. Внутри кампании вложены ad_groups, а внутри каждой группы объявлений — keywords, negative_keywords и ads. Кроме того, кампания принимает negative_keywords напрямую — для минус-слов на уровне кампании.

Вся структура проверяется перед созданием, а при отклонении выводится список всех некорректных узлов. При использовании --from-file ошибки конвертации сообщаются с указанием листа, строки и столбца; предупреждения конвертации не останавливают отправку, а ошибки конвертации прерывают её. Перед отправкой команда показывает количество кампаний, групп объявлений, ключевых слов, минус-слов и объявлений в структуре и запрашивает подтверждение.

Затем команда отслеживает операцию и выводит прогресс вплоть до одного из трёх финальных статусов:

Статус	Значение
`success`	Все объекты созданы
`partial`	Некоторые объекты не были созданы. Каждая ошибка выводится с сообщением от Apple
`failed`	Операция завершилась с ошибкой, команда возвращает ненулевой код выхода

Если операция не завершилась за --timeout секунд, команда возвращает управление и выводит вызов bulk-status для последующего запуска.

adapty asa campaigns bulk-status

Показывает ход выполнения одной массовой операции: статус, количество объектов и журнал по каждому объекту.

adapty asa campaigns bulk-status <operation-id>

Аргумент	Описание
`operation-id`	ID операции (UUID), выведенный командой `campaigns bulk-create`

Поле status принимает значения pending, running, success, partial или failed. Блок counts показывает, сколько объектов применено, завершилось с ошибкой и ожидает выполнения от общего числа.

Принимает флаги пагинации.

Рекламные группы

adapty asa ad-groups list

Список групп объявлений. Возвращает только метаданные — для получения показателей производительности используйте asa metrics.

adapty asa ad-groups list --campaign <campaign-id>

Принимает флаги пагинации и фильтры списка --campaign-group, --app, --campaign, --search и --status.

adapty asa ad-groups get

Получить подробную информацию о конкретной группе объявлений.

adapty asa ad-groups get <ad-group-id>

Аргумент	Описание
`ad-group-id`	ID группы объявлений (UUID)

adapty asa ad-groups create

Создание группы объявлений в кампании.

adapty asa ad-groups create --campaign <campaign-id> --name "Brand terms" --default-bid 1.20

Флаг	Обязателен	Описание
`--campaign`	Да	ID кампании (UUID)
`--name`	Да	Название группы объявлений
`--default-bid`	Если не указан `--automated`	Ставка по умолчанию в виде числа, например `1.20`
`--cpa-goal`	Нет	Целевая стоимость привлечения
`--pricing-model`	Нет	`CPC` или `CPM`. Apple требует указать для каждой группы объявлений. По умолчанию: `CPC`
`--start-time`	Нет	Дата начала (`YYYY-MM-DD`). По умолчанию — сегодня
`--end-time`	Нет	Дата окончания (`YYYY-MM-DD`)
`--automated-keywords` / `--no-automated-keywords`	Нет	Разрешить Apple автоматически добавлять ключевые слова
`--automated`	Нет	Создать автоматизированную группу объявлений, необходимую для кампании `MAX_CONVERSIONS`
`--currency`	Нет	Код валюты для сумм в этом запросе. По умолчанию: `USD`
`--status`	Нет	Начальный статус: `ENABLED` или `PAUSED`

--automated включает автоматический подбор ключевых слов для группы объявлений, поэтому его нельзя комбинировать с --automated-keywords. Apple самостоятельно управляет расписанием автоматизированной группы объявлений и держит её включённой, поэтому --start-time и --status PAUSED не поддерживаются — чтобы поставить на паузу, остановите кампанию. См. Создание кампании Max Conversions.

adapty asa ad-groups update

Обновить существующую группу объявлений.

adapty asa ad-groups update <ad-group-id> --default-bid 1.50 --status PAUSED

Аргумент	Описание
`ad-group-id`	ID группы объявлений (UUID)

Флаг	Описание
`--name`	Новое название группы объявлений
`--status`	`ENABLED` или `PAUSED`
`--default-bid`	Новая ставка по умолчанию
`--cpa-goal`	Новая целевая стоимость привлечения
`--start-time`	Начало расписания (`YYYY-MM-DD`)
`--end-time`	Конец расписания (`YYYY-MM-DD`)
`--automated-keywords` / `--no-automated-keywords`	Разрешить Apple автоматически добавлять ключевые слова
`--currency`	Код валюты для сумм в этом запросе. По умолчанию: `USD`

Необходим хотя бы один флаг. Родительская кампания определяется на сервере и никогда не передаётся напрямую.

Ключевые слова

Команды для ключевых слов применяются пакетами не более 100 элементов за один вызов. Эквивалент в дашборде см. в разделе Управление ключевыми словами.

adapty asa keywords list

Выводит список таргетинговых ключевых слов. Возвращает только метаданные — для просмотра показателей производительности используйте asa metrics.

adapty asa keywords list --ad-group <ad-group-id> --status ACTIVE

Принимает флаги пагинации и фильтры списка --campaign-group, --app, --campaign, --ad-group, --search и --status. Фильтруйте по --ad-group — без фильтра это самый широкий запрос по данной теме.

adapty asa keywords add

Добавьте ключевые слова таргетинга в группу объявлений.

adapty asa keywords add --ad-group <ad-group-id> --text "running shoes" --text "trail shoes" --bid 1.20

Считайте ключевые слова из файла — по одному на строку:

adapty asa keywords add --ad-group <ad-group-id> --from-file keywords.txt

Флаг	Обязательный	Описание
`--ad-group`	Да	ID группы объявлений (UUID). Из него определяется кампания
`--text`	Да, если не используется `--from-file`	Текст ключевого слова. Повторите для нескольких
`--from-file`	Нет	Файл с одним ключевым словом на строку. Объединяется с любыми значениями `--text`
`--bid`	Нет	Ставка за ключевое слово в виде числового значения
`--match-type`	Нет	`BROAD` или `EXACT`. По умолчанию: `BROAD`
`--currency`	Нет	Код валюты для сумм в этом запросе. По умолчанию: `USD`
`--status`	Нет	`ACTIVE` или `PAUSED`. По умолчанию: `ACTIVE`

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

adapty asa keywords update

Изменение ставки, статуса, текста или типа соответствия одного или нескольких ключевых слов.

adapty asa keywords update <keyword-id> <keyword-id> --bid 2.00 --status PAUSED

Аргумент	Описание
`keyword-id`	ID ключевого слова (UUID). Чтобы передать несколько, укажите их как дополнительные аргументы

Флаг	Описание
`--bid`	Новая ставка
`--status`	`ACTIVE` или `PAUSED`
`--match-type`	`BROAD` или `EXACT`
`--text`	Новый текст ключевого слова. Имеет смысл только при обновлении одного ключевого слова
`--currency`	Код валюты для сумм в этом вызове. По умолчанию: `USD`

Одно изменение применяется к каждому переданному ID.

Негативные ключевые слова

adapty asa negative-keywords list

Выводит список минус-слов. Строки с пустым ad_group_id относятся к уровню кампании.

adapty asa negative-keywords list --campaign <campaign-id>

Флаг	Описание
`--campaign-level-only`	Оставить только строки уровня кампании

Принимает флаги пагинации и фильтры списка --campaign-group, --app, --campaign, --ad-group и --search.

adapty asa negative-keywords add

Добавление минус-слов в группу объявлений или кампанию.

adapty asa negative-keywords add --ad-group <ad-group-id> --text free

Применить ко всем группам объявлений кампании:

adapty asa negative-keywords add --campaign <campaign-id> --all-ad-groups --text free

Флаг	Обязательный	Описание
`--ad-group`	Одно из `--ad-group` или `--campaign`	ID группы объявлений (UUID). Кампания определяется из него
`--campaign`	Одно из `--ad-group` или `--campaign`	ID кампании (UUID)
`--text`	Да	Текст ключевого слова. Повторите для нескольких
`--all-ad-groups`	Нет	Применить ко всем группам объявлений кампании вместо самой кампании. Требует `--campaign`
`--match-type`	Нет	`BROAD` или `EXACT`. По умолчанию: `EXACT`
`--status`	Нет	`ACTIVE` или `PAUSED`. По умолчанию: `ACTIVE`

--ad-group и --campaign являются взаимоисключающими. Передайте ровно один из них.

Условия поиска

adapty asa search-terms list

Список поисковых запросов, которые запустили ваши объявления. Используйте его для поиска новых ключевых слов и минус-слов.

adapty asa search-terms list --ad-group <ad-group-id> --date-from 2026-07-01 --date-to 2026-07-31

Флаг	По умолчанию	Описание
`--date-from`	Сегодня	Начало отчётного периода (`YYYY-MM-DD`)
`--date-to`	Сегодня	Конец отчётного периода (`YYYY-MM-DD`)

Принимает флаги пагинации и фильтры списка --campaign-group, --app, --campaign, --ad-group и --search.

Эта команда использует общий пул аналитики с asa metrics. См. Ошибки.

Принимает флаги пагинации и фильтры списка --campaign-group, --campaign, --ad-group, --search и --status. У этого списка нет фильтра --app, поскольку объявления принадлежат группам объявлений.

adapty asa ads get

Получить детали конкретного объявления.

adapty asa ads get <ad-id>

Аргумент	Описание
`ad-id`	ID объявления (UUID)

adapty asa ads create

Создать объявление в группе объявлений.

adapty asa ads create --ad-group <ad-group-id> --creative-id 4321 --name "Summer ad"

Флаг	Обязателен	Описание
`--ad-group`	Да	ID группы объявлений (UUID). Кампания определяется из него
`--creative-id`	Да	Apple creative ID. См. `creatives list`
`--name`	Да	Название объявления
`--status`	Нет	Начальный статус: `ENABLED` или `PAUSED`

adapty asa ads update

Обновление существующего объявления.

adapty asa ads update <ad-id> --status PAUSED

Аргумент	Описание
`ad-id`	ID объявления (UUID)

Флаг	Описание
`--name`	Новое название объявления
`--status`	`ENABLED` или `PAUSED`

Необходимо указать хотя бы один флаг. Креатив и родительская группа объявлений фиксируются при создании.

Креативы

adapty asa creatives list

Список креативов, доступных для новых объявлений.

adapty asa creatives list --app <app-id>

creative_id, возвращаемый здесь, является значением --creative-id для ads create.

Принимает флаги пагинации и фильтры списка --campaign-group и --app.

Страницы продуктов

adapty asa product-pages list

Выводит список доступных пользовательских страниц продукта для ваших приложений.

adapty asa product-pages list --app <app-id>

Принимает флаги пагинации, а также фильтры --campaign-group и --app из раздела фильтры списка.

adapty asa product-pages sync

Обновить кастомные страницы продукта из App Store Connect.

adapty asa product-pages sync --adam-id 123456

Флаг	Описание
`--adam-id`	Ограничить обновление одним приложением. Если не указан, охватывает все приложения

Обновление ставится в очередь, а не выполняется сразу — команда подтверждает это сообщением Sync queued.. Если такое же обновление уже выполняется, вместо этого выводится Already running; nothing new was queued.

Автоматизации

CLI хранит JSON с правилами, которые вы ему передаёте, — он не строит правила самостоятельно. Подробнее о типах правил см. в разделе Автоматизации, а о том, как создать файл с правилами, — в разделе Запуск правил автоматизации.

adapty asa automations list

Список правил автоматизации. Поле status принимает значение 1 для активных и 0 для остановленных.

adapty asa automations list

Принимает флаги пагинации.

adapty asa automations get

Получить конкретное правило автоматизации, включая его условия и действия.

adapty asa automations get <automation-id>

Argument	Description
`automation-id`	Automation rule ID (UUID)

adapty asa automations create

Создаёт правило автоматизации из JSON-файла.

adapty asa automations create --file rule.json

Флаг	Описание
`--file`	JSON-файл с телом правила или `-` для чтения из стандартного ввода
`--run-now`	Ставит первый запуск в очередь сразу после сохранения правила

--file обязателен.

adapty asa automations update

Изменить правило автоматизации: остановить его, переименовать или заменить части правила.

adapty asa automations update <automation-id> --stop

Аргумент	Описание
`automation-id`	ID правила автоматизации (UUID)

Флаг	Описание
`--start`	Активировать правило
`--stop`	Остановить правило и сбросить время следующего запуска
`--name`	Новое имя правила
`--file`	JSON-файл с изменяемыми частями или `-` для чтения из стандартного ввода

--start и --stop взаимно исключают друг друга. Файл, переданный здесь, не должен содержать internal_id.

adapty asa automations run

Запустить правило автоматизации один раз, вне расписания.

adapty asa automations run <automation-id> --dry-run

Аргумент	Описание
`automation-id`	ID правила автоматизации (UUID)

Флаг	Описание
`--dry-run`	Проверить правило и записать результат в лог без изменений в Apple Ads

Запуск ставится в очередь, и команда выводит ID запуска. Просмотреть результат можно с помощью automations runs.

adapty asa automations runs

Список прошедших запусков правила автоматизации, включая тестовые (dry run).

adapty asa automations runs <automation-id>

Аргумент	Описание
`automation-id`	ID правила автоматизации (UUID)

Принимает флаги пагинации.

Метрики

adapty asa metrics

Запрашивает метрики для любого уровня аккаунта за указанный диапазон дат.

adapty asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31

Флаг	Обязательный	Описание
`--entity`	Да	По чему строить отчёт: `campaign`, `ad-group`, `keyword` или `ad`
`--date-from`	Да	Начало периода (`YYYY-MM-DD`)
`--date-to`	Да	Конец периода (`YYYY-MM-DD`)
`--metric`	Нет	Название метрики, можно указывать несколько раз. Пропустите, чтобы получить все метрики
`--group-by`	Нет	Разбивка строк по `country`, `day`, `week`, `month`, `quarter` или `year`. Можно указывать несколько раз
`--by-days`	Нет	Окно продлений в днях для когортных метрик, можно указывать несколько раз. Максимум 16 за один вызов. Пропустите, чтобы использовать значения по умолчанию из дашборда
`--order-by`	Нет	Метрика или поле для сортировки
`--order-by-day`	Нет	Ранжировать по когортной метрике в этом окне продлений. Должно быть одним из значений `--by-days`
`--order`	Нет	`asc` или `desc`. По умолчанию: `desc`

Принимает флаги пагинации. Эта команда не принимает фильтры списков — сузьте отчёт по уровню сущности и периоду, а затем сопоставьте строки с ID из команды list с нужной областью.

Каждая строка — одна сущность, агрегированная на сервере и отсортированная по --order-by. Вопрос «топ-N» решается одним запросом — задайте --order-by и --page-size N вместо того, чтобы листать результаты и складывать их вручную:

adapty asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5

--metric принимает названия метрик, которые отслеживает Ads Manager, в номенклатуре дашборда — например spend, taps или gross_roas. Полный список и описание расчёта каждой метрики см. в разделе Метрики. Несуществующее название приведёт к ошибке с перечнем допустимых значений.

Длина периода отчёта ограничена наиболее крупным значением --group-by. Чтобы охватить более длинный период, укрупните группировку вместо того, чтобы разбивать запрос на несколько вызовов:

Самая крупная единица `--group-by`	Максимальный период
`day` или без группировки по периоду	90 дней
`week`	180 дней
`month` и крупнее	365 дней

Метрики ltv не существует. Lifetime value — это когортная метрика, считываемая в окне продления, поэтому для получения значений на 7-й или 90-й день используется --by-days:

adapty asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90

--order-by-day сортирует строки по одному из этих окон — так можно получить топ кампаний по ROAS на 90-й день за один запрос.

adapty asa metrics overview

Query totals for a period, bucketed by a unit of time.

adapty asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit week

Флаг	Обязательный	Описание
`--entity`	Да	По какому объекту строить отчёт: `campaign`, `ad-group`, `keyword` или `ad`
`--date-from`	Да	Начало периода (`YYYY-MM-DD`)
`--date-to`	Да	Конец периода (`YYYY-MM-DD`)
`--period-unit`	Нет	Размер бакета: `day`, `week`, `month`, `quarter` или `year`. По умолчанию: `day`
`--metric`	Нет	Название метрики, можно указывать несколько раз. Не указывайте, чтобы получить все метрики
`--by-days`	Нет	Окно продлений в днях для метрик когорт, можно указывать несколько раз. Максимум 16 за один вызов

Эта команда возвращает итоги по всей выбранной сущности и разбивку по периодам, то есть отвечает на вопрос «сколько я потратил или заработал в целом» за один вызов. Флаги сортировки и пагинация отсутствуют.

Для этой команды --metric принимает только корневые когортные метрики — revenue, roas и arpu — без вариантов gross_, proceeds_ и net_.

Длина отчётного периода ограничена параметром --period-unit:

`--period-unit`	Максимальный период
`day`	90 дней
`week`	180 дней
`month` и крупнее	365 дней

Конкуренты

adapty asa competitors summary

Показывает сводку по ключевым словам Apple Ads, на которые делает ставки набор приложений из App Store. Возвращает те же данные о конкурентах, что и Market Intelligence в дашборде.

adapty asa competitors summary --app-ids 1668337467,6503873027

Флаг	Обязательный	Описание
`--app-ids`	Да	ID приложений в Apple App Store (`adam_id`), через запятую. От 1 до 5 значений

Отчётный период и набор стран фиксированы на сервере — последний полный месяц, все страны. У команды нет флагов для периода, страны или пагинации.

Команда выводит три блока: общие показатели анализа, топ приложений по эффективности и наиболее конкурентные термины. Добавьте --json для получения полного результата, который также содержит разбивку терминов каждого приложения по странам.

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

Ошибки

Статус	Код	Значение
`402`	`ads_manager_subscription_required`	У компании нет активной подписки Ads Manager
`404`	—	Сущность не существует или принадлежит другой компании
`409`	`cli_idempotency_in_progress`	Запрос с тем же ключом идемпотентности ещё выполняется
`422`	`cli_idempotency_key_reuse`	Тот же ключ идемпотентности был использован с другим телом запроса
`429`	`cli_analytics_busy`	Пул аналитики занят. Время ожидания указано в заголовке `Retry-After`
`429`	`cli_cooldown_active`	Слишком много отклонённых запросов перевели токен в режим ожидания

Метрики и список поисковых запросов используют общий аналитический бюджет на уровне компании: 5 запросов в минуту, и не более 2 за любые 10 секунд. Если за 5 минут накапливается 20 отклонённых запросов, включается нарастающий период ожидания: сначала 5 минут, затем 30 минут, затем 3 часа. Повторные запросы во время паузы её не продлевают, однако правильное решение — исправить проблемный запрос, а не отправлять его снова.

CLI самостоятельно обрабатывает короткие ожидания. Если в ответ на 429 (не связанный с периодом ожидания) заголовок Retry-After указывает не более 60 секунд, команда ждёт указанное время и повторяет запрос один раз, выводя информацию об ожидании в стандартный поток ошибок.

Команды Ads Manager для Adapty Developer CLI

Глобальные флаги

Фильтры списка

Аккаунт

adapty asa whoami

adapty asa connect

adapty asa orgs list

adapty asa apps list

Кампании

adapty asa campaigns list

adapty asa campaigns get

adapty asa campaigns create

adapty asa campaigns update

adapty asa campaigns bulk-create

adapty asa campaigns bulk-status

Рекламные группы

adapty asa ad-groups list

adapty asa ad-groups get

adapty asa ad-groups create

adapty asa ad-groups update

Ключевые слова

adapty asa keywords list

adapty asa keywords add

adapty asa keywords update

Негативные ключевые слова

adapty asa negative-keywords list

adapty asa negative-keywords add

Условия поиска

adapty asa search-terms list

Реклама

adapty asa ads list

adapty asa ads get

adapty asa ads create

adapty asa ads update

Креативы

adapty asa creatives list

Страницы продуктов

adapty asa product-pages list

adapty asa product-pages sync

Автоматизации

adapty asa automations list

adapty asa automations get

adapty asa automations create

adapty asa automations update

adapty asa automations run

adapty asa automations runs

Метрики

adapty asa metrics

adapty asa metrics overview

Конкуренты

adapty asa competitors summary

Ошибки