Быстрый старт с Adapty Developer CLI

Adapty CLI позволяет настроить конфигурацию приложения полностью из командной строки. Используйте его как альтернативу быстрому старту через дашборд, если вы предпочитаете работу в терминале или MCP-клиенты.

По завершении ваше приложение, уровень доступа, продукт, флоу или пейвол и плейсмент будут отображаться в дашборде Adapty.

Если вы запускаете CLI в Claude Cowork, сначала настройте его в Claude — см. Настройка Adapty CLI в Claude Cowork.

1. Установите CLI

Требуется Node.js версии 18 или выше.

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

npm install -g adapty

Или напрямую:

npx adapty auth login

2. Авторизация

Выполните команду входа, чтобы связать CLI с вашим аккаунтом Adapty.

adapty auth login

CLI откроет вкладку в браузере. Сверьте код, отображаемый в терминале, с кодом в браузере, затем нажмите Authorize. Терминал подтвердит успешную аутентификацию.

3. Создайте приложение

Приложение в Adapty — это ваше мобильное приложение. Одно приложение в Adapty подключается к App Store и Google Play одновременно — достаточно создать одно, сколько бы сторов вы ни использовали.

adapty apps create --title "My App" --platform ios --platform android --apple-bundle-id com.example.app --google-bundle-id com.example.app

adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app

adapty apps create --title "My App" --platform android --google-bundle-id com.example.app

Команда возвращает <app-id>. Используйте этот ID во всех последующих командах.

4. Создайте уровень доступа (необязательно)

Уровни доступа определяют, к чему пользователь получает доступ после покупки. Вместо того чтобы проверять, купил ли пользователь конкретный продукт, приложение проверяет наличие нужного уровня доступа. Это отвязывает логику приложения от конкретных ID продуктов.

Уровень доступа premium создаётся автоматически при добавлении каждого нового приложения. Для большинства приложений этот шаг можно пропустить. Используйте premium в качестве ID уровня доступа на шаге 5.

Выполняйте эту команду только в том случае, если разные продукты открывают разные функции для разных групп пользователей — например, если подписчик «Basic» и подписчик «Pro» получают доступ к разным частям приложения.

adapty access-levels create --app <app-id> --sdk-id "pro" --title "Pro"

• --sdk-id — это идентификатор, который вы будете использовать в коде приложения, чтобы проверить, должна ли функция быть доступна пользователю (например, if user.hasAccessLevel("pro")). Если пропустить этот шаг и использовать уровень доступа по умолчанию, его --sdk-id равен premium.
• --title — отображаемое название для вашего удобства в дашборде Adapty.

Команда возвращает <access-level-id>.

5. Создайте продукт

В Adapty продукт — это всё, что ваше приложение продаёт: подписка или разовая покупка. Позиции из App Store Connect и Google Play можно объединить в один продукт Adapty и управлять ими из одного места.

Вам понадобятся идентификаторы продукта из каждого стора: Apple product ID из App Store Connect, а также Android product ID и base plan ID из Google Play Console. Подробнее о том, где их найти, читайте в разделе Продукты.

Если вы пропустили шаг 4, используйте default_access_level.id, возвращённый командой apps create на шаге 3, в качестве <access-level-id>.

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id> --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

Команда возвращает <product-id>.

Если вы также продаёте этот продукт в вебе через Stripe или Paddle, добавьте эти ID в ту же команду. Подробнее см. products create в справочнике команд.

6. Создайте флоу или пейвол

Every product must be inside a flow or a paywall before it can appear in your app. Pick one:

• Флоу — это экран или последовательность экранов, которые вы проектируете в no-code Flow & Paywall Builder, а SDK Adapty отрисовывает нативно: экран пейвола, онбординг, квиз. Выбирайте флоу, когда хотите, чтобы Adapty сам отрисовывал экран покупки. Флоу требуют Adapty SDK 4.0 или новее.
• Пейвол — это набор продуктов без прикреплённого дизайна. Выбирайте пейвол, когда вы отрисовываете экран покупки в собственном коде приложения и вам нужно только, чтобы Adapty предоставлял продукты, опционально с Remote Config.

Плейсмент обслуживает один тип контента, поэтому определитесь с этим до шага 7.

6a. Создайте флоу

CLI создаёт запись флоу. Его экраны хранятся в конфиге билдера — JSON-документе, который CLI не генерирует. Чтобы создать конфиг из терминала, используйте навык flow-generator, который управляет CLI за вас.

Создайте флоу:

adapty flows create --app <app-id> --name "Onboarding"

Команда возвращает <flow-id>.

Постройте экраны с помощью навыка flow-generator или в Flow & Paywall Builder. В любом случае результат — сохранённый черновик, который пользователи пока не видят.

Опубликуйте флоу:

adapty flows publish --app <app-id> <flow-id>

Команда запросит подтверждение. Публикация выполняется в фоновом режиме, поэтому проверяйте статус с помощью adapty flows get --app <app-id> <flow-id>, пока не увидите published. При publication_failed команда flows config get покажет причину ошибки. Плейсмент принимает только опубликованный флоу.

6б. Создайте пейвол

Пейвол — это контейнер, в котором хранятся ваши продукты.

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id>

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id-1> --product-id <product-id-2>

Команда возвращает <paywall-id>.

7. Создайте плейсмент

Плейсмент — это точка в приложении, где отображается флоу или пейвол. Единственное, что вы задаёте в коде приложения, — это ID плейсмента. Всё остальное — какой флоу или пейвол показывать и каким пользователям — управляется в дашборде без выпуска новой версии приложения.

--developer-id — это строка, которую вы будете использовать позже в коде приложения, когда запрашиваете у Adapty, что показать в данной точке. Выберите что-то описывающее место, например "main", "onboarding" или "settings".

adapty placements create --app <app-id> --title "Onboarding" --developer-id "onboarding" --audiences '[{"content_type":"flow","segment_ids":[],"flow_id":"<flow-id>","priority":0}]'

adapty placements create --app <app-id> --title "Main" --developer-id "main" --audiences '[{"content_type":"paywall","segment_ids":[],"paywall_id":"<paywall-id>","priority":0}]'

Флаг --audiences управляет тем, какой флоу или пейвол показывается каким пользователям. В примерах выше задана единственная аудитория по умолчанию: все пользователи этого плейсмента видят одно и то же содержимое. Плейсмент работает с одним типом контента, поэтому каждая запись аудитории должна содержать одинаковое значение content_type. Чтобы настроить таргетинг по сегменту, см. Форму audiences в справочнике команд.

Что дальше

Все сущности теперь отображаются в дашборде Adapty. Далее:

• Изменить флоу позже — опишите изменение скиллу flow-generator или откройте флоу в Flow & Paywall Builder.
• Отрендерить пейвол в приложении — получите пейвол и его продукты через SDK и соберите экран в своём коде.
• Интегрировать Adapty SDK — добавьте SDK в приложение, чтобы получать и отображать плейсмент.
• Направить разные сегменты пользователей к разным флоу или пейволам — см. placements update и segments list в справочнике команд.