---
title: "Braze"
description: "Интегрируйте Braze с Adapty для эффективного взаимодействия с клиентами и push-уведомлений."
---

[Braze](https://www.braze.com/) — одно из ведущих решений для работы с клиентами: широкий набор инструментов для push-уведомлений, email, SMS и in-app сообщений. Интегрировав Adapty с Braze, вы получите все события подписки в одном месте и сможете настраивать автоматические коммуникации на их основе.

Adapty предоставляет полный набор данных для отслеживания [событий подписки](events) из всех сторов в одном месте и может использоваться для обновления профилей пользователей в Braze. С Adapty вы легко увидите, как ведут себя ваши подписчики, поймёте их предпочтения и используете эту информацию для точечных и эффективных коммуникаций. Интеграция позволяет отслеживать события подписки в дашборде Braze и связывать их с [рекламными кампаниями](https://www.braze.com/product/journey-orchestration).

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

## Как настроить интеграцию с Braze \{#how-to-set-up-braze-integration\}

Чтобы подключить Braze, перейдите в [Integrations -> Braze](https://app.adapty.io/integrations/braze), включите переключатель и заполните поля.

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

  <img src="/assets/shared/img/5f1e62c-adapty_braze.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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

  <img src="/assets/shared/img/b5fdf16-adapty_braze_create_api_key.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

  <img src="/assets/shared/img/1e5b4b8-adapty_braze_api_key_users_track.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

2. Чтобы получить **Braze Instance ID**, посмотрите на URL вашего Braze Dashboard и найдите нужный идентификатор в разделе [документации Braze](https://www.braze.com/docs/api/basics/#endpoints). Он имеет региональный формат, например US-03, EU-01 и т.д.
3. iOS и Android App IDs также находятся в Braze Dashboard → **Settings** → **API Keys**. Скопируйте их отсюда:

  <img src="/assets/shared/img/1e6d21b-adapty_braze_app_ids.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

## События, атрибуты пользователей и покупки \{#events-user-attributes-and-purchases\}

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

  <img src="/assets/shared/img/702e628-adapty_braze_events_names.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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

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

[Здесь](messaging#event-properties) вы найдёте полные спецификации свойств событий, отправляемых в Braze.

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

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

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

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

Помимо предопределённого набора тегов, можно также отправлять [пользовательские атрибуты](segments#custom-attributes) с помощью тегов. Это даёт дополнительную гибкость в выборе типов данных и полезно для отслеживания специфической информации о продукте или сервисе. Все пользовательские атрибуты пользователей автоматически отправляются в Braze, если на [странице интеграции](https://app.adapty.io/integrations/braze) отмечен чекбокс **Send user attributes**.

## Настройка SDK \{#sdk-configuration\}

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

<Tabs groupId="current-os" queryString>
<TabItem value="swift" label="iOS (Swift)" default>
```swift showLineNumbers
let braze = Braze(configuration: configuration)
braze.changeUser(userId: "adapty_customer_user_id")
```
</TabItem>
<TabItem value="kotlin" label="Android (Kotlin)" default>
```kotlin showLineNumbers
Braze.getInstance(context).changeUser("adapty_customer_user_id")
```
</TabItem>
</Tabs>