---
title: "Скилл агента для Retention Messaging"
description: "Установите скилл retention-messaging, чтобы ваш AI-инструмент настраивал Apple Retention Messaging в Adapty, создавал и редактировал сообщения для подписчиков при отмене подписки и отслеживал эффективность каждого сообщения."
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skills: `npx adapty skills install --yes`

[Apple Retention Messaging](retention-messaging) показывает подписчикам ваше сообщение или предложение на экране Apple **Cancel Subscription** прямо перед подтверждением отмены, чтобы меньше из них уходило. Скилл retention-messaging настраивает это и управляет всем из вашего AI-инструмента. Агент считывает статус настройки вашего приложения и проводит вас через каждый оставшийся шаг: устанавливает URL Adapty в Apple, запускает тест производительности Apple и переводит вас в продакшн. Затем он пишет стандартные и промо-сообщения на каждом нужном вам языке, активирует и деактивирует их, а также показывает, сколько подписчиков удержало каждое сообщение. Всё это работает через [команды CLI `adapty retention-messaging`](developer-cli-retention-messaging) или [Adapty MCP-сервер](adapty-mcp).

:::note
Как только Apple одобряет сообщение, подписчики, отменившие продукты, которые оно охватывает, видят его. Перед тем как скилл установит URL Adapty в Apple или создаст, отредактирует, активирует или деактивирует сообщение, он расскажет вам простыми словами, что именно изменится. Изменение применяется только после вашего подтверждения.
:::

## Что можно спросить \{#what-you-can-ask\}

Формулируйте запросы так, как объясняли бы задачу коллеге. Называть скилл явно не нужно:

```
Set up retention messaging for my app.

Is retention messaging on, and what is missing?

Create a retention message for my Annual plan in English and German.

Show my 50% off promotional offer to monthly subscribers who cancel.

Offer monthly subscribers who cancel a switch to the Annual plan.

Add a German translation to my retention message.

How are my retention messages doing?

Deactivate the Black Friday message.
```

*Пример разговора с тестовым приложением. Ваши продукты и сообщения могут отличаться.*

**User:** Создай сообщение для удержания для моего годового плана на английском и немецком языках.

**Agent ran:** Считать настройки и сообщения

- `adapty retention-messaging setup-status`
- `adapty retention-messaging products suggest --mode production --type default`
- `adapty retention-messaging messages list --mode production`

**Agent:**

**Agent asks:** Создать retention-сообщение

Создать «Annual: stay» как сообщение по умолчанию в production.

- Продукты: Annual. Языки: английский, немецкий. Без изображения.
- Английский: «Before you go» / «Keep your plan and your saved progress.»
- Немецкий: «Bevor du gehst» / «Behalte deinen Plan und deinen Fortschritt.»
- Apple проверяет это сейчас. **После одобрения подписчики, отменяющие план Annual, будут видеть это сообщение.**

Создать?

1. Да
2. Нет

## Прежде чем начать \{#before-you-start\}

- **Одобрение Apple для вашего приложения**: Apple предоставляет доступ к Retention Messaging API только одобренным приложениям, а проверка занимает до месяца. Запрос в Apple вы отправляете самостоятельно. Если у вашего приложения ещё нет доступа, скилл выдаст вам URL Adapty для заполнения [формы запроса Apple](retention-messaging-setup#request-access-from-apple).
- **Настройка App Store в Adapty**: Ваше приложение должно иметь полную [настройку App Store](app-store-connection-configuration) с ключом In-App Purchase. Для промо-сообщений также добавьте ключ в разделе **App Store promotional offers** и, чтобы предложить смену тарифа, — [ключ API App Store Connect](app-store-connect-api-key).
- **Продукты в Adapty**: Как минимум один [продукт](create-product), который будут охватывать ваши сообщения.
- **AI-инструмент, подключённый к вашему аккаунту Adapty**: Скилл работает через [MCP-сервер Adapty](adapty-mcp) или [Adapty CLI](developer-cli). В Claude Code и Codex плагин добавляет MCP-сервер, так что нужно только войти в аккаунт. В обоих случаях скилл использует CLI (см. [Ограничения](#limits)). Если вы выбираете CLI, скилл устанавливает или обновляет его. В claude.ai, ChatGPT или мобильном приложении AI-инструмента скилл работает только через MCP-сервер и попросит вас подключить его. На компьютере, где нет ни того ни другого, скилл спросит, что именно нужно настроить. Если CLI не может выполнять команды Retention Messaging, скилл переключится на MCP-сервер, если тот подключён. В противном случае скилл направит вас к [настройке Retention Messaging в дашборде](retention-messaging-setup).

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

Скилл retention-messaging входит в состав [плагина Adapty](manage-adapty-with-ai).

Если вы уже установили плагин Adapty, этот скилл у вас есть. Если агент его не отображает, обновите плагин командой для вашего агента из [README плагина](https://github.com/adaptyteam/adapty-skills/blob/main/plugin/README.md#install).

Чтобы установить плагин в агент для разработки, выполните в терминале:

```bash
npx adapty skills install
```

Перезапустите агента, чтобы плагин загрузился. Чтобы установить плагин в claude.ai или Claude desktop, см. [Установка плагина](manage-adapty-with-ai#install-the-plugin). Другие способы установки описаны в [README плагина](https://github.com/adaptyteam/adapty-skills/blob/main/plugin/README.md#install).

Claude Code не обновляет плагин автоматически. Чтобы получать новые скиллы по мере их выхода, в Claude Code выполните `/plugin`, откройте **Marketplaces**, выберите `adapty` и нажмите **Enable auto-update**. Команду обновления для других агентов можно найти в [README плагина](https://github.com/adaptyteam/adapty-skills/blob/main/plugin/README.md#install).

## Как скилл настраивает сообщения об удержании \{#how-the-skill-sets-up-retention-messaging\}

У Apple есть две среды — песочница и продакшн. Один URL Adapty работает для обеих, но Apple хранит его отдельно для каждой среды. У каждой среды свои сообщения.

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

1. **Ключи App Store или серверные уведомления не настроены**: скилл направляет вас к настройкам App Store на дашборде.
2. **Apple не одобрил приложение**: скилл выдаёт URL Adapty для ввода в форме запроса Apple.
3. **Apple ещё не отправляет sandbox-запросы в Adapty**: скилл предлагает прописать URL Adapty в Apple для песочницы.
4. **Тест производительности не пройден**: чтобы подготовиться к [тесту производительности Apple](retention-messaging-setup#pass-the-performance-test), приобретите ваш продукт с наибольшей длительностью через [sandbox-аккаунт](test-purchases-in-sandbox) или TestFlight непосредственно перед тестом и оставьте подписку активной. После этого скилл запускает тест. Подписчики теста не видят, поэтому подтверждать этот шаг не нужно. Тест может занять до часа. Пока он идёт, скилл перечитывает статус и не запускает новый тест.
5. **Тест пройден**: скилл предлагает прописать URL Adapty в Apple для production, а затем создать ваше первое сообщение по умолчанию.

## Как скилл пишет сообщения \{#how-the-skill-writes-messages\}

- **Сначала сообщение по умолчанию**: промо-сообщение требует наличия сообщения по умолчанию для того же продукта. Скилл сначала создаёт сообщение по умолчанию, затем промо-сообщения.
- **Только продукты, свободные для сообщения**: скилл не предлагает продукт, который уже охвачен другим сообщением того же типа в том же окружении. Для промо-сообщения скилл также не предлагает продукт, у которого нет сообщения по умолчанию.
- **Только существующие офферы и планы**: промо-сообщение связывает каждый продукт с promotional offer или с переходом на другой план в той же группе подписок. Скилл предлагает только те офферы и планы, которые уже существуют в App Store Connect и в Adapty.
- **Каждый запрошенный язык**: скилл пишет текст на английском и добавляет каждый перевод в рамках ограничений Apple. Пока Apple не одобрит язык, подписчики, использующие его, видят текст на английском.
- **Правки затрагивают только то, что вы указали**: весь остальной текст, языки, продукты и изображения остаются без изменений. Скилл удаляет язык, пункт списка, продукт или изображение только по вашей явной просьбе.

Чтобы узнать, что означает каждое поле сообщения, см. [Создание сообщения для удержания](retention-messaging-create).

## Что скилл спрашивает перед каждым изменением \{#what-the-skill-asks-before-each-change\}

Только ваш ответ на вопрос скилла имеет значение. Общее «давай» до того, как скилл покажет изменение, не считается. Если вы ответите «нет», скилл ничего не изменит.

| Изменение | Что скилл вам сообщает |
|---|---|
| Установить URL Adapty в Apple | Для выбранной среды Apple отправляет запросы с экрана **Cancel Subscription** в Adapty. Если запросы этой среды сейчас идут на другой сервер, скилл предупреждает, что тот сервер перестанет их получать, и запрашивает повторное подтверждение. |
| Создать сообщение | Apple проверяет сообщение. После одобрения его увидят подписчики, отменяющие указанные продукты. В песочнице его видят только тестировщики песочницы. |
| Редактировать сообщение | Любое изменение, даже только имени, отправляет сообщение на повторную проверку Apple. После одобрения неактивное сообщение начинает показываться снова. Изменения, внесённые в дашборде между чтением и записью скилла, могут быть потеряны. |
| Активировать или деактивировать сообщение | После активации Apple показывает сообщение, как только одобрит его. Языки, уже одобренные Apple, повторной проверки не ждут. После деактивации Apple прекращает показывать сообщение. Подписчики, которые уже видели его, не затрагиваются. |

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

Если Adapty не отвечает после того, как скилл создаёт сообщение, скилл не создаёт его повторно. Он ищет сообщение в списке по названию, показывает каждое совпадение и спрашивает, какое из них ваше, если таковое есть.

## Как скилл считывает показатели сообщений \{#how-the-skill-reads-message-performance\}

Спросите, как работают ваши сообщения, и скилл прочитает список продакшн-сообщений с колонками **Shown**, **Retained users**, **Saved users**, **Retention rate**, **Save rate** и **Saved revenue**. Каждое число охватывает весь срок жизни сообщения. Сообщения из песочницы не учитываются. **Retained users** заполняется только после следующей даты списания у каждого подписчика. Подробнее о том, что означает каждое число, см. в разделе [Отслеживание показателей сообщений](retention-messaging-analytics).

## С другими скиллами \{#with-other-skills\}

- **Решите, использовать ли Retention Messaging**: Скилл [growth-advisor](export-analytics-with-ai) считывает статус Retention Messaging и продакшн-сообщения, когда отмены в App Store лидируют по завершённым подпискам. Если вы подтверждаете, он передаёт настройку и сообщения скиллу retention-messaging.
- **Добавьте promotional offer к продукту**: Промо-сообщение со скидкой требует promotional offer, созданного в App Store Connect и в Adapty. Чтобы добавить существующий оффер стора к продукту в Adapty, укажите агенту его ID, например: «Добавь оффер App Store `annual_50_off` к моему продукту Annual.» Скилл growth-advisor вносит изменение после вашего подтверждения.

## Ограничения \{#limits\}

- **Удаление невозможно**: удалить retention-сообщение нельзя. Если вы попросите это сделать, скилл предложит деактивировать его.
- **Изображения и маркированные списки требуют CLI**: через MCP-сервер скилл не может добавить изображение-шапку или маркированный список к сообщению по умолчанию, так как для этого нужна загрузка файла. В таких случаях скилл даст нужную CLI-команду или объяснит, как сделать это в дашборде.
- **Позиция заголовка фиксирована**: укажите скиллу **Title position** при создании сообщения по умолчанию. Изменить её потом нельзя — ни в скилле, ни в дашборде.
- **Без изменений в автономном режиме**: при плановом запуске или выполнении скрипта, когда некому отвечать на вопросы, скилл работает только на чтение. Если требуется изменение, он описывает, что оно делает, и выдаёт команду для самостоятельного запуска.

Чтобы запускать команды самостоятельно, без скилла, см. [Управление сообщениями для удержания через CLI](developer-cli-retention-messaging).