Скилл агента для Retention Messaging

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

Note

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

Что можно спросить

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

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.
retention-messaging
Создай сообщение для удержания для моего годового плана на английском и немецком языках.
Считать настройки и сообщения
  • adapty retention-messaging setup-status
  • adapty retention-messaging products suggest --mode production --type default
  • adapty retention-messaging messages list --mode production
Создать 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. Нет
Пример разговора с тестовым приложением. Ваши продукты и сообщения могут отличаться.

Прежде чем начать

  • Одобрение Apple для вашего приложения: Apple предоставляет доступ к Retention Messaging API только одобренным приложениям, а проверка занимает до месяца. Запрос в Apple вы отправляете самостоятельно. Если у вашего приложения ещё нет доступа, скилл выдаст вам URL Adapty для заполнения формы запроса Apple.
  • Настройка App Store в Adapty: Ваше приложение должно иметь полную настройку App Store с ключом In-App Purchase. Для промо-сообщений также добавьте ключ в разделе App Store promotional offers и, чтобы предложить смену тарифа, — ключ API App Store Connect.
  • Продукты в Adapty: Как минимум один продукт, который будут охватывать ваши сообщения.
  • AI-инструмент, подключённый к вашему аккаунту Adapty: Скилл работает через MCP-сервер Adapty или Adapty CLI. В Claude Code и Codex плагин добавляет MCP-сервер, так что нужно только войти в аккаунт. В обоих случаях скилл использует CLI (см. Ограничения). Если вы выбираете CLI, скилл устанавливает или обновляет его. В claude.ai, ChatGPT или мобильном приложении AI-инструмента скилл работает только через MCP-сервер и попросит вас подключить его. На компьютере, где нет ни того ни другого, скилл спросит, что именно нужно настроить. Если CLI не может выполнять команды Retention Messaging, скилл переключится на MCP-сервер, если тот подключён. В противном случае скилл направит вас к настройке Retention Messaging в дашборде.

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

Скилл retention-messaging входит в состав плагина Adapty.

Если вы уже установили плагин Adapty, этот скилл у вас есть. Если агент его не отображает, обновите плагин командой для вашего агента из README плагина.

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

npx adapty skills install

Перезапустите агента, чтобы плагин загрузился. Чтобы установить плагин в claude.ai или Claude desktop, см. Установка плагина. Другие способы установки описаны в README плагина.

Claude Code не обновляет плагин автоматически. Чтобы получать новые скиллы по мере их выхода, в Claude Code выполните /plugin, откройте Marketplaces, выберите adapty и нажмите Enable auto-update. Команду обновления для других агентов можно найти в README плагина.

Как скилл настраивает сообщения об удержании

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

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

  1. Ключи App Store или серверные уведомления не настроены: скилл направляет вас к настройкам App Store на дашборде.
  2. Apple не одобрил приложение: скилл выдаёт URL Adapty для ввода в форме запроса Apple.
  3. Apple ещё не отправляет sandbox-запросы в Adapty: скилл предлагает прописать URL Adapty в Apple для песочницы.
  4. Тест производительности не пройден: чтобы подготовиться к тесту производительности Apple, приобретите ваш продукт с наибольшей длительностью через sandbox-аккаунт или TestFlight непосредственно перед тестом и оставьте подписку активной. После этого скилл запускает тест. Подписчики теста не видят, поэтому подтверждать этот шаг не нужно. Тест может занять до часа. Пока он идёт, скилл перечитывает статус и не запускает новый тест.
  5. Тест пройден: скилл предлагает прописать URL Adapty в Apple для production, а затем создать ваше первое сообщение по умолчанию.

Как скилл пишет сообщения

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

Чтобы узнать, что означает каждое поле сообщения, см. Создание сообщения для удержания.

Что скилл спрашивает перед каждым изменением

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

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

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

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

Как скилл считывает показатели сообщений

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

С другими скиллами

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

Ограничения

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

Чтобы запускать команды самостоятельно, без скилла, см. Управление сообщениями для удержания через CLI.