Braze

Как одно из ведущих решений для взаимодействия с клиентами, Braze предоставляет широкий набор инструментов для push-уведомлений, email, SMS и сообщений внутри приложения. Интегрировав Adapty с Braze, вы получите доступ ко всем событиям подписки в одном месте и сможете запускать автоматические коммуникации на основе этих событий.

Adapty предоставляет полный набор данных, позволяющий отслеживать события подписок из всех сторов в одном месте, и может использоваться для обновления профилей пользователей в Braze. С Adapty вы легко увидите, как ведут себя ваши подписчики, поймёте их предпочтения и сможете использовать эту информацию для целевой и эффективной коммуникации. Интеграция позволяет отслеживать события подписок в вашем дашборде Braze и связывать их с вашими рекламными кампаниями.

Adapty отправляет события подписки, свойства пользователей и покупки в Braze, чтобы вы могли выстраивать целевые коммуникации с клиентами через push-уведомления Braze после простой и быстрой интеграции, описанной ниже.

Как настроить интеграцию с Braze

Чтобы подключить Braze, перейдите в Integrations -> Braze, включите переключатель и заполните поля.

Первый шаг — предоставить необходимые учётные данные для установки соединения между Braze и Adapty. Для работы интеграции потребуются REST API Key, Braze Instance ID, а также App IDs для iOS и Android:

REST API Key создаётся в Braze Dashboard → Settings → API Keys. При создании убедитесь, что ключу назначено разрешение users.track:

Чтобы получить Braze Instance ID, посмотрите на URL вашего Braze Dashboard и найдите нужный идентификатор в разделе документации Braze. Он имеет региональный формат, например US-03, EU-01 и т.д.
iOS и Android App IDs также находятся в Braze Dashboard → Settings → API Keys. Скопируйте их отсюда:

События, атрибуты пользователей и покупки

Ниже блока с учётными данными находятся три группы событий, которые можно отправлять из Adapty в Braze. Просто включите нужные. При необходимости вы можете переименовать события перед отправкой в Braze. Полный список событий Adapty доступен здесь:

Adapty отправляет события подписки и атрибуты пользователей в Braze через серверную интеграцию, что позволяет просматривать их в дашборде Braze и настраивать кампании на их основе.

Для событий с выручкой, таких как конверсии пробного периода и продления, Adapty передаёт эту информацию в Braze как покупки.

Здесь вы найдёте полные спецификации свойств событий, отправляемых в Braze.

Полезные атрибуты пользователей

По умолчанию Adapty отправляет ряд атрибутов пользователей для интеграции с Braze. Ознакомьтесь со списком ниже, чтобы выбрать подходящие для ваших задач.

Атрибут пользователя	Тип	Значение
`adapty_customer_user_id`	String	Содержит уникальный идентификатор пользователя, заданный клиентом. Доступен как в дашборде Adapty, так и в Braze.
`adapty_profile_id`	String	Содержит уникальный идентификатор профиля пользователя Adapty, который можно найти в дашборде Adapty.
`environment`	String	Указывает, работает ли пользователь в среде песочницы или в продакшене. Возможные значения: `Sandbox` или `Production`
`store`	String	Содержит название стора, через который была совершена покупка. Возможные значения: `app_store` или `play_store`.
`vendor_product_id`	String	Содержит идентификатор продукта в Apple/Google стор. Например: org.locals.12345
`subscription_expires_at`	String	Содержит дату истечения последней подписки. Формат значения: YYYY-MM-DDTHH:mm:ss.SSS+TZ Например: 2023-02-15T17:22:03.000+0000
`active_subscription`	String	Принимает значение `true` при любом событии покупки или продления, или `false`, если подписка истекла.
`period_type`	String	Указывает последний тип периода для покупки или продления. Возможные значения: `trial` для пробного периода или `normal` для остальных случаев.

Все значения типа float округляются до int. Строки передаются без изменений.

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

Настройка SDK

Чтобы связать профили пользователей в Adapty и Braze, необходимо либо настроить Braze SDK с тем же идентификатором пользователя, что и в Adapty, либо использовать метод .changeUser():

let braze = Braze(configuration: configuration)
braze.changeUser(userId: "adapty_customer_user_id")

Braze.getInstance(context).changeUser("adapty_customer_user_id")

Устранение неполадок

`access_level_updated` отображается как неуспешное в Event Feed

access_level_updated — это событие только для вебхуков. Adapty не отправляет его в эту интеграцию. Однако Adapty фиксирует результат для каждой активной интеграции, и неподдерживаемое событие отображается как ошибка.