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

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

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

Примечание. Указывать протокол конечной точки не нужно, поэтому проверьте, что в поле активации нет _https://_. Также важно отметить, что для получения Braze данных колбэков необходимо установить определенные параметры.

Предопределенные параметры

Braze позволяет отправлять набор предопределенных параметров. Если прикрепить любой из этих параметров к событию в SDK Adjust, они будут переданы в Braze. Узнать больше об использовании параметров партнеров можно в файле readme по тем SDK, с которыми вы работаете. Ниже приведен список определенных параметров, которые принимает Braze:

Ключ параметра> Значение

  • external_id> обязательный для отправки событий в Braze
  • braze_device_id> обязательный для отправки любых данных об Android в Braze
  • product_id> обязательный для отправки приносящих доход событий в Braze Для отправки колбэков в Braze необходимо указать партнерский параметр события "external_id" в Adjust SDK. Для перенаправления приносящих доход событий в качестве партнерского параметра события необходимо указывать product_id .

Для приложений на Android в качестве партнерского параметра сеанса и события необходимо указывать "braze_device_id" . Наконец, для перенаправления приносящих доход событий в качестве партнерского параметра для приносящих доход событий необходимо указывать "product_id" . Обратите внимание: Braze не поддерживает данные от Organic, Facebook или Twitter, поэтому колбэки от этих трекеров не будут отправляться.

Колбэки
В настоящее время Adjust не перенаправляет данные кампаний Organic, Facebook и Twitter в Braze.

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