Управление Apple Ads с помощью AI-инструмента для кодинга

Навык ads-manager позволяет инструменту AI-кодирования управлять вашим аккаунтом Apple Ads через Adapty CLI. Задайте вопрос на обычном языке — инструмент определит, какие команды дадут ответ, сначала прочитает данные аккаунта и предложит изменение на ваше утверждение, прежде чем что-либо попадёт в Apple.

Навык — это набор инструкций, которые ваш AI-инструмент загружает по запросу. Этот навык охватывает те части Ads Manager, где легко ошибиться: какой идентификатор принимает каждый флаг, какой фильтр поддерживает каждый список, сколько ключевых слов умещается в одном пакете и какие вызовы стоят денег.

Что он обрабатывает

Производительность чтения: выбирает единственный вызов, который отвечает на вопрос, вместо того чтобы листать результаты. Знает, что вопрос «топ-N» — это один упорядоченный вызов, а подсчёт сущностей вообще не требует вызова метрик.
Структурные изменения: создаёт и обновляет кампании, группы объявлений, объявления и ключевые слова в правильном порядке, читая родительскую сущность перед записью дочерней.
Работа с ключевыми словами: добавляет ключевые слова и пересматривает ставки пакетами, а также переносит поисковые запросы в ключевые слова и минус-слова.
Автоматизации: настраивает автоматизации на основе правил и делает пробный запуск перед тем, как они затронут реальные ставки.
Анализ конкурентов: собирает ключевые слова, по которым делают ставки конкурирующие приложения.

Что он не делает

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

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

Навык рекомендует команды и подготавливает их к выполнению. Чтение метрик и тестовые запуски бесплатны, но вы по-прежнему несёте ответственность за подтверждение любых изменений в реальном рекламном аккаунте.

Установите скилл

Навык ads-manager обучает ваш AI-инструмент для работы с кодом управлять Apple Ads через команды adapty asa. Он знает порядок составления команд, что нужно прочитать перед записью и какие вызовы тратят деньги.

Поддерживаемые инструменты: Claude Code, GitHub Copilot CLI, OpenAI Codex, Gemini CLI.

Навык управляет Adapty CLI, поэтому сначала установите и аутентифицируйте CLI — см. руководство по быстрому старту. Команды adapty asa поставляются в Adapty CLI 0.4.0 и новее; в более старых версиях они вообще отсутствуют. Проверьте с помощью adapty asa whoami — это также покажет, подключён ли аккаунт Apple Ads и есть ли у компании активная подписка Ads Manager.

В корпоративном рабочем пространстве Cowork администратор должен добавить и adapty.io, и *.adapty.io в список разрешённых доменов. Укажите оба: символ подстановки не покрывает корневой домен в большинстве реализаций списков разрешений, а корневой домен — это именно там, где живёт документация, которую читает навык. Пока оба не разрешены, навык не может обратиться к Adapty.

Для установки выберите вариант для вашего инструмента. Полный список — в README навыка.

Claude Code

claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill
claude plugin install adapty-sdk-integration@adapty

Этот плагин также содержит навык интеграции SDK. Оба устанавливаются вместе.

GitHub Copilot CLI

git clone https://github.com/adaptyteam/adapty-sdk-integration-skill.git
cp -r adapty-sdk-integration-skill/skills/* ~/.copilot/skills/

Gemini CLI

gemini skills install https://github.com/adaptyteam/adapty-sdk-integration-skill

OpenAI Codex или любой другой инструмент — используйте skills CLI (обратите внимание, что навыки, установленные таким образом, не обновляются автоматически):

npx skills add adaptyteam/adapty-sdk-integration-skill --all

--all устанавливает оба навыка во все обнаруженные агенты. Для установки только этого навыка используйте --skill ads-manager.

Либо клонируйте репозиторий и скопируйте директории из skills/ в директорию навыков вашего инструмента — или только skills/ads-manager/, если вам нужен только этот навык.

После установки запустите навык в вашем проекте:

/ads-manager

Чтение метрик и пробные запуски ничего не стоят. Каждая другая команда обращается к Apple в течение нескольких секунд, тратит реальные деньги и не может быть отменена — навык спрашивает подтверждение перед каждой такой командой, и вам тоже стоит это делать.

Чем это отличается от AI Agent

В дашборде Adapty Ads Manager также есть встроенный AI Agent. Они решают разные задачи:

	AI Agent	навык ads-manager
Где работает	Дашборд Adapty	Ваш терминал, в вашем AI-инструменте для кода
Что делает	Анализирует и даёт рекомендации	Анализирует, даёт рекомендации и выполняет команды
Настройка	Не требуется	Adapty CLI плюс навык

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

Что дальше

Управление Ads Manager через CLI — те же задачи вручную, без AI-инструмента.
Команды Ads Manager — все команды с аргументами, флагами и допустимыми значениями.