Чем мы можем помочь?

Интеграция Braze (ранее Appboy) с AppsFlyer

  • Обновлено

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

Узнайте больше на сайте braze.com.

Вкладка «Затраты»

  • Некоторые медиа-источники ограничивают передачу данных третьим лицам. Поэтому постбэки для ограниченных событий не будут отправляться этому партнеру, независимо от настроенной отправки постбэков.
  • Постбэки не будут отправляться, если источник — органический.

Обзор интеграции

Чтобы настроить интеграцию с Braze, следуйте инструкциям ниже.

Минимальные требования — AppsFlyer SDK:

На Android для интеграции с Braze необходимо, чтобы идентификатор устройства Braze (уникальный идентификатор пользователя Braze) был указан в SDK AppsFlyer для Android. Этот параметр отправляется с каждым постбэком и позволяет идентифицировать каждого пользователя. Для этого необходимо вставить в код приложения следующие строки:

Важно!

Убедитесь, что строки кода вставлены в правильное место — после запуска Braze SDK и перед кодом инициализации AppsFlyer SDK (см. раздел «Инициализация SDK» в нашем Руководстве по интеграции Android SDK).

Android;
HashMap<String, Object> customData = new HashMap<String,Object>();
String deviceId =(Braze.getInstance(MyActivity.this).getDeviceId());
customData.put("brazeCustomerId", deviceId);
AppsFlyerLib.getInstance().setAdditionalData(customData);
https://support.appsflyer.com/hc/article_attachments/360016192917

Swift

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

Обработчик завершения Swift

let configuration = Braze.Configuration(
    apiKey: "<BRAZE_API_KEY>",
    endpoint: "<BRAZE_ENDPOINT>")
configuration.useUUIDAsDeviceId = false
let braze = Braze(configuration: configuration)
braze.deviceId {
    brazeDeviceId in
    AppsFlyerLib.shared().customData = [“brazeDeviceId”: brazeDeviceId]
}

Swift await

let configuration = Braze.Configuration(
    apiKey: "<BRAZE_API_KEY>",
    endpoint: "<BRAZE_ENDPOINT>")
configuration.useUUIDAsDeviceId = false
let braze = Braze(configuration: configuration)
let brazeDeviceId = await braze.deviceId()
AppsFlyerLib.shared().customData = ["brazeDeviceId": brazeDeviceId]

Objective C

BRZConfiguration *configurations = [[BRZConfiguration alloc] initWithApiKey:@"BRAZE_API_KEY" endpoint:@"BRAZE_END_POINT"];
[configurations setUseUUIDAsDeviceId:NO];
Braze *braze = [[Braze alloc] initWithConfiguration:configurations];
[braze deviceIdWithCompletion:^(NSString * _Nonnull brazeDeviceId) {
    NSLog(@">>[BRZ]: %@", brazeDeviceId);
    [[AppsFlyerLib shared] setAdditionalData:@{
        @"brazeDeviceId": brazeDeviceId
    }];
}];
Unity
Appboy.AppboyBinding.getDeviceID()
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("brazeCustomerId", Appboy.AppboyBinding.getDeviceId());
AppsFlyer.setAdditionalData(customData);

Настройка Braze

Необходимые условия: Перед настройкой интеграции необходимо связаться с партнером и открыть у него аккаунт. Перед настройкой интеграции необходимо связаться с партнером и открыть у него аккаунт.

Чтобы активировать интеграцию:

  1. Чтобы активировать: В AppsFlyer в боковом меню выберите Сотрудничество Маркетплейс партнеров.
    Чтобы изменить: В AppsFlyer в боковом меню выберите СотрудничествоАктивные интеграции.
  2. Выберите соответствующее приложение.
  3. На вкладке Интеграция выберите приложение для интеграции и нажмите Активировать партнера.
  4. При первом посещении вам необходимо активировать партнера, чтобы включить настройку параметров вкладки интеграции.Кнопка ДОЛЖНА оставаться в положении «Включено», пока вы работаете с этим партнером.
    Дополнительная информация по активации партнеров доступна здесь.
  5. Завершите настройку, используя соответствующие вкладки, как описано ниже. Узнать больше о партнерских интеграциях.
Вкладка «Интеграция»

На вкладке «Интеграция» есть несколько разделов, которые описаны ниже.

Активация партнера

При первом посещении вам необходимо Активировать партнера, чтобы включить настройку параметров вкладки интеграции. Кнопка ДОЛЖНА оставаться в положении «Включено», пока вы работаете с этим партнером.
Дополнительная информация по активации партнеров доступна здесь.

Общие настройки

Braze подключается к AppsFlyer через уникальный ключ API и конечную точку REST.

Чтобы получить ключ API Braze и конечную точку REST:

  1. В своем аккаунте Braze в разделе Технологические партнеры перейдите в раздел Атрибуция.
  2. Выберите AppsFlyer.
    Выберите AppsFlyer в качестве технологического партнера в Braze
  3. В разделе Импорт данных для атрибуции установок нажмите «Сгенерировать ключ API».
  4. braze-af-API-key.png
  5. В AppsFlyer вставьте ключ API Braze и конечную точку REST.
    Подробное описание заголовка окна настройки параметров партнера см. <a href="https://support.appsflyer.com/hc/en-us/articles/4410395957521#about-the-integrated-partner-page" target="_blank" rel="noopener">здесь</a>.
  6. Нажмите Сохранить и закрыть.

После сохранения конфигурации AppsFlyer отправляет в Braze следующие данные для каждой органической и неорганической установки:

  • Braze Dev_ID
  • Медиа-источник
  • Название кампании
  • Название группы объявлений
  • Название объявления

Постбэки по умолчанию

AppsFlyer может отправлять автоматические постбэки об установках пользователей Braze. В этом разделе можно определить отправку этих постбэков.

Раздел стандартных постбэков

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

Нажмите кнопку Сохранить.

Примечание

Хотя все события отправляются AppsFlyer, органические установки не учитываются в Braze и, следовательно, игнорируются API Braze.

Вкладка «Ссылки атрибуции»

Ссылки атрибуции недоступны для Braze.

Вкладка «Стоимость»

Данные о расходах не поддерживаются при интеграции с этим партнером.

Вкладка «Доходы от рекламы»

Доход от рекламы не поддерживается при интеграции с этим партнером.

Вкладка Permissions (Разрешения)

Разрешения для Braze недоступны.

Просмотр данных атрибуции пользователя в Braze

Базу пользователей можно сегментировать по данным атрибуции на панели инструментов Braze с помощью фильтров атрибуции установки.

Установите фильтры атрибуции установок в дэшборде Braze

Кроме того, данные об атрибуции конкретного пользователя доступны в профиле каждого пользователя на панели инструментов Braze.

Braze_msc_new_2.png