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

Интеграция OneSignal с AppsFlyer

  • Обновлено

OneSignal — ведущий на рынке поставщик push-уведомлений и рассылки в приложении, обслуживающий более 1 миллиона разработчиков и маркетологов с помощью передовой платформы для вовлеченности.

onesignal-logo-stack__3_.png

OneSignal ежедневно доставляет 8 миллиардов сообщений по всему миру. Благодаря превосходной архитектуре и удобной в использовании платформе OneSignal доставляет сообщения быстрее, эффективнее и в большем масштабе, чем любое другое решение в мире. Узнать больше на сайте onesignal.com

Важно!

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

Настройка OneSignal

Интеграция с OneSignal включает добавление нескольких строк кода в SDK AppsFlyer в вашем приложении, а затем активацию интеграции в AppsFlyer.

Настройка AppsFlyer SDK

При использовании Android для интеграции с OneSignal необходимо, чтобы OneSignal Player ID (уникальный идентификатор пользователя OneSignal) был указан в Android SDK AppsFlyer. Этот параметр отправляется с каждым постбэком и позволяет идентифицировать каждого пользователя.

Чтобы настроить SDK AppsFlyer для Android:

  1. Убедитесь, что версия SDK, которую вы используете, — 2.3.1.18 или выше.
  2. Вставьте следующие строки кода в код приложения — после запуска SDK OneSignal и перед кодом инициализации SDK AppsFlyer.
    • Для устройств Android с OneSignal SDK версии 3.x.x:

      OSPermissionSubscriptionState status = OneSignal.getPermissionSubscriptionState();
      
                String deviceId = status.getSubscriptionStatus().getUserId();
      
                  customData.put("onesignalCustomerId", deviceId);
    • Для Unity SDK:

      var status = OneSignal.GetPermissionSubscriptionState();
      
                String deviceId = status.subscriptionStatus.userId;
      
                  customData.put("onesignalCustomerId", deviceId);
    • Для устройств Android с OneSignal Native SDK версии 4+:

      OSDeviceState device = OneSignal.getDeviceState();
      
                String deviceId = device.getUserId();
      
                  customData.put("onesignalCustomerId", deviceId);

Чтобы настроить SDK AppsFlyer для iOS:

  1. Убедитесь, что версия SDK, которую вы используете, — 2.3.1.18 или выше.
  2. Вставьте следующие строки кода в код приложения — после запуска SDK OneSignal и перед кодом инициализации SDK AppsFlyer.
    • Для устройств iOS с OneSignal SDK версии 2.x.x:

      Swift
      let status: OSPermissionSubscriptionState = OneSignal.getPermissionSubscriptionState()
      if let deviceId = status.subscriptionStatus.userId{
          customData.put("onesignalCustomerId", deviceId);
      
      Objective C
      OSPermissionSubscriptionState* status = [OneSignal getPermissionSubscriptionState];
      NSDictionary* CustomDataMap = [[NSDictionary alloc] initWithObjectsAndKeys:status.subscriptionStatus.userId, @"onesignalCustomerId", nil];
      [[AppsFlyerLib shared] setAdditionalData:CustomDataMap];
      
    • Для устройств iOS с OneSignal Native SDK версии 3+:

      Swift
      if let deviceState = OneSignal.getDeviceState() {
          let deviceId = deviceState.userId
          customData.put("onesignalCustomerId", deviceId);
      
      Objective C
      OSDeviceState *deviceState = [OneSignal getDeviceState];
      NSString *deviceId = deviceState.userId;
      NSDictionary* CustomDataMap = [[NSDictionary alloc] initWithObjectsAndKeys:deviceId, @"onesignalCustomerId", nil];
      [[AppsFlyerLib shared] setAdditionalData:CustomDataMap];
      

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

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

  1. Чтобы активировать: В AppsFlyer в боковом меню выберите Сотрудничество> Маркетплейс партнеров.
    Чтобы изменить: В боковом меню AppsFlyer выберите Сотрудничество > Активные интеграции.
  2. Выберите соответствующее приложение.
  3. Нажмите Настроить интеграцию.
  4. На вкладке Интеграция выберите приложение для интеграции и нажмите Активировать партнера.
    Примечание. Узнать больше
  5. Завершите настройку, используя соответствующие вкладки, как описано в следующем разделе:
Вкладка «Интеграция»
onesignal-integration-tab.png

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

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

Этот параметр должен быть включен всё время, пока вы работаете с партнером.
Подробнее об активации партнёров.

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

AppID OneSignal

Идентификатор приложения OneSignal доступен на платформе OneSignal в разделе Settings > Keys & IDs.Чтобы подключить аккаунт OneSignal к AppsFlyer, введите идентификатор вашего приложения в поле OneSignal AppID.

onesignal-app-id-en_us.png

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

onesignal-default-postbacks_en-us.png

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

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

Чтобы завершить настройку интеграции, нажмите Сохранить интеграцию.

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

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

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

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

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

Данные о стоимости неприменимы при интеграции с этим партнёром.

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

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

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

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

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

Вы можете просматривать атрибуцию в редакторе сегментов в тегах OneSignal — как на уровне отдельного устройства, так и при создании сегмента для использования в кампании.

onesignal-view-attribution_en-us.png