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

Используете ИИ-ассистент? Доступен скилл Adapty CLI, помогающий LLM работать с CLI.

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

Подключение Adapty к App Store Connect и Google Play всё равно требует однократной настройки в дашборде — она описана в шаге 3.

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

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 одновременно — достаточно создать одно, сколько бы сторов вы ни использовали.

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

Прежде чем продолжить, подключите приложение к App Store Connect и Google Play в дашборде Adapty. ID продуктов из обоих сторов потребуются на шаге 5.

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>.

ID продуктов стора, которые вы указываете здесь (--ios-product-id, --android-product-id), нельзя изменить после создания. Чтобы использовать другие ID продуктов стора, создайте новый продукт.

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

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

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

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

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

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

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

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

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

Флаг --audiences определяет, какой пейвол показывается каким пользователям. В примере выше задана одна дефолтная аудитория — все пользователи на этом плейсменте видят один и тот же пейвол.

Что дальше

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

  • Оформите пейвол — используйте Paywall Builder без кода, чтобы добавить визуальные элементы, разметку и тексты к только что созданному пейволу.
  • Интегрируйте Adapty SDK — добавьте SDK в приложение для получения и отображения плейсмента.