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

Используете AI-ассистент? Доступен навык Adapty CLI, который помогает языковым моделям работать с 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>. Используйте этот идентификатор во всех последующих командах.

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

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

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

Уровень доступа premium создаётся автоматически для каждого нового приложения. Для большинства приложений этот шаг можно пропустить. Используйте premium в качестве идентификатора уровня доступа на шаге 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>.

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

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

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

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

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

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

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

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

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

adapty placements create --app <app-id> --title "Main" --developer-id "main" --paywall-id <paywall-id>

Что дальше

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

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