Braze

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

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

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

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

Чтобы подключить Adapty к Braze, откройте Integrations → Braze в дашборде Adapty, включите переключатель и заполните учётные данные:

REST API key и Braze Instance ID — обязательные поля.
iOS App ID и Android App ID — необязательные поля.

Чтобы создать REST API key, перейдите в дашборде Braze в Settings → APIs and Identifiers и нажмите Create API Key. В разделе разрешений для данных пользователей выберите users.track. Braze не позволяет изменять разрешения ключа после его создания, поэтому ключ без users.track придётся заменить новым. Подробнее см. в документации Braze: Creating REST API keys.
Чтобы найти Braze Instance ID, сопоставьте URL вашего дашборда Braze с таблицей инстансов в документации Braze. ID инстанса имеет региональный формат, например US-03 или EU-01. Так, dashboard-03.braze.com соответствует US-03.
Чтобы найти iOS App ID и Android App ID, перейдите в дашборде Braze в Settings → APIs and Identifiers → App Identifiers. Скопируйте значение из столбца Identifier для каждого приложения. Подробнее см. в документации Braze: App identifier.

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

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

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

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

Warning

Adapty отправляет данные о доходах в Braze только в виде устаревших событий покупки (legacy purchase events). Braze перевёл legacy purchase events в режим обслуживания и не включает их для новых клиентов. Если ваше рабочее пространство Braze не принимает такие события, Braze отклоняет каждое событие с доходом с кодом HTTP 400 и сообщением Legacy purchase ingestion is disabled. Такие события, как первые покупки, продления, конверсии пробного периода и возвраты, не поступают в Braze вообще — не только их данные о доходах.

Прежде чем включить интеграцию, убедитесь, что ваш воркспейс Braze принимает legacy purchase events. Подробнее см. раздел Purchase events в документации Braze.

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

Note

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

По умолчанию 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 фиксирует результат для каждой активной интеграции, и неподдерживаемое событие отображается как ошибка.