---
title: "Управление Apple Ads с помощью AI-инструмента для кодинга"
description: "Установите навык ads-manager, чтобы Claude Code, Copilot CLI, Codex или Gemini CLI могли управлять вашими кампаниями Apple Ads через Adapty CLI."
---

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

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

## Что он обрабатывает \{#what-it-handles\}

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

## Что он не делает \{#what-it-will-not-do\}

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

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

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

## Установите скилл \{#install-the-skill\}

[Навык ads-manager](https://github.com/adaptyteam/adapty-sdk-integration-skill) обучает ваш AI-инструмент для работы с кодом управлять Apple Ads через команды `adapty asa`. Он знает порядок составления команд, что нужно прочитать перед записью и какие вызовы тратят деньги.

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

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

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

Для установки выберите вариант для вашего инструмента. Полный список — в [README навыка](https://github.com/adaptyteam/adapty-sdk-integration-skill).

**Claude Code**

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

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

**GitHub Copilot CLI**

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

**Gemini CLI**

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

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

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

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

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

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

```bash
/ads-manager
```

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

## Чем это отличается от AI Agent \{#how-it-differs-from-the-ai-agent\}

В дашборде Adapty Ads Manager также есть встроенный [AI Agent](ads-manager-ai-agent). Они решают разные задачи:

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

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

## Что дальше \{#whats-next\}

- [Управление Ads Manager через CLI](developer-cli-ads-manager) — те же задачи вручную, без AI-инструмента.
- [Команды Ads Manager](developer-cli-ads-manager-reference) — все команды с аргументами, флагами и допустимыми значениями.