Мы постоянно публикуем обновления документации, которые могут быть недоступны на вашем языке. Наиболее актуальные сведения содержатся в версии на английском языке.

Настройка Braze

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

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

Перед началом работы

Требования

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Учетные данные

INSTALL API KEY, EVENT API KEY и ENDPOINT

  • Чтобы узнать, как найти ваши учетные данные, обратитесь к своему представителю Braze.

Выберите Braze и свое приложение в Campaign Lab

  1. В разделе Campaign Lab выберите Партнеры .
  2. Выберите Новый партнер > Braze . Выберите Далее , чтобы перейти к следующему экрану.
  3. На экране Выбор приложения выберите приложение, для которого вы хотите создать ссылку и включите интеграцию, чтобы поделиться данными с Braze.
  4. Нажмите Далее .

Включение обмена данными

Включите обмен данными, чтобы активировать интеграцию с Braze. Чтобы включить обмен данными

  1. Введите INSTALL API KEY, EVENT API KEY и ENDPOINT.

После включения обмена данными с Braze, Adjust автоматически отправляет Braze следующие данные (по умолчанию).

  • Установка
  • событие

Настройте параметры обмена данными

При работе с мультиплатформенными приложениями с возможностью совместного использования данных для нескольких платформ вы можете:

  1. Разделить параметры обмена данными на уровне платформы, выбрав Использовать настройки для определенной платформы .
  2. Установить одинаковые настройки обмена данными для нескольких платформ, выбрав Использовать глобальные настройки .

В разделе К чему будет предоставлен доступ? отметьте действия, которые Adjust будет передавать Braze по умолчанию:

  • Установка
  • событие

Отправка дополнительных данных

Выберите объем и тип данных для передачи Braze посредством колбэков. Braze может использовать эту информацию для оптимизации производительности.

Для отправки дополнительных данных можно просмотреть и настроить следующие параметры:

Доход в приложении (от покупок в приложении)

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

Сопоставление параметров

Чтобы делиться настраиваемыми данными с Braze, обычно требуется сопоставить параметры.

Параметры партнера (доступно в Adjust SDK версии 4.0+) позволяют Adjust собирать настраиваемые наборы данных в вашем приложении и перенаправлять их непосредственно Braze. Таким образом Braze будет получать указанные сведения по каждому связанному событию.

Прежде чем добавлять новые параметры партнера в Adjust SDK, убедитесь, что ни один из ранее введенных параметров партнера не соответствует вашим требованиям.

Чтобы передавать Braze параметры партнера, выполните следующие действия.

  1. Настройте параметры партнера в Adjust SDK.

    • Проверьте раздел Начало работы для всех ссылок на платформу разработки SDK.

  2. В разделе Выберите параметры обмена данными нажмите Параметры .

  3. В разделе Сопоставить параметры можно указать способ отправки в сеть параметров партнера, заданных в SDK:

    1. Выберите Сопоставить параметр .
    2. В поле Параметр SDK укажите имя параметра SDK, который следует отправить в сеть.
    3. В поле Параметр партнера укажите параметр сети, соответствующий параметру SDK.
Примечание:

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

Включите Braze для своего приложения

На экране Проверка настройки вы можете просмотреть выбранные варианты. Вы можете вернуться и внести изменения в следующие настройки:

  • Выбранное приложение
  • Параметры обмена данными

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

Инструкции по настройке для конкретных партнеров

Note-- the Endpoint protocol should not be entered; so please ensure that you do not include _https://_ in the activation field. Last but not least, be aware that Braze requires specific parameters in order to receive callback data.

Predefined parameters

Braze allows you to send a set of predefined parameters. If you attach any of these parameters to an event in your adjust SDK, these will be forwarded to Braze. You can find out more about attaching partner parameters in the SDK readme specific to the SDK or SDKs you are working with. Below is a list of the defined parameters that Braze accepts:

Parameter key > Value

  • external_id > mandatory for sending events to Braze
  • braze_device_id > mandatory for sending any Android data to Braze
  • product_id > mandatory for sending revenue events to Braze

To send event callbacks to Braze, you must implement "external_id" as an event partner parameter within the Adjust SDK. For revenue event forwarding, you should also set up product_id as a partner parameter for events.

For Android apps, you must also implement "braze_device_id" as both a session and event partner parameter. Finally, for revenue event forwarding, you must also set up "product_id" as a partner parameter for revenue events. Please note that Braze does not support Organic, Facebook, or Twitter data so callbacks for these trackers will not be sent.

Callbacks
Currently Adjust don't forward Organic, Facebook and Twitter campaign data to Braze.

If you would like to find out more about how to leverage this integration for your use cases, check out our one pager with Braze . In case of any questions related to the information provided on the one pager, please reach out to partners@adjust.com .

Список всех параметров, передаваемых Braze

Braze требует от Adjust отправлять следующие параметры (точки данных) вместе с колбэками:

ПлейсхолдерИнформация
{currency}Исходный код валюты по ISO 4217, отправленный из Adjust SDK
{idfa}Идентификатор IDFA (только для iOS)
{partner_parameters}Пользовательские параметры партнера, собираемые запросом Adjust SDK или S2S и передаваемые сторонним поставщикам с помощью постбэков
{revenue}Доход в том виде, в котором от отправлен из Adjust SDK, в центах
{win_adid}Идентификатор рекламы Windows
{adgroup_name}Название группы объявлений (как прописано в трекере)
{app_id}Идентификатор App Store или Google Play
{campaign_name}Название кампании (как прописано в трекере)
{created_at}Временная отметка действия
{creative_name}Название креатива (как прописано в трекере)
{network_name}Название сети (как прописано в трекере)