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

Настройка OneSignal

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

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

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

Требования

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

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

OneSignal App ID

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

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

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

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

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

  1. Введите OneSignal App ID.

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

  • Установка
  • Сеанс

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

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

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

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

  • Установка
  • Сеанс

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

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

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

Сессии

Adjust не отправляет автоматически колбэки сессий из-за большого количества сессий. Передача данных о сессиях позволяет OneSignal получать данные о сессиях в вашем приложении.

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

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

Сопоставьте события

Сопоставьте события, которые хотите передавать, со значениями, которые OneSignal может получать. Данные событий, которые вы не сопоставили, не могут быть переданы OneSignal.

Составить отдельные события

Если у вас мультиплатформенное приложение, вы можете выбрать разные события для каждой платформы и поделиться ими OneSignal. Это позволяет вам:

  • настроить отдельные события для управления стратегиями кампаний для каждой платформы;
  • настроить обмен данными для каждой платформы.

В разделе Сопоставление событий выполните следующие действия, чтобы выбрать события в приложении, данные о которых следует передавать OneSignal:

  1. Выберите Сопоставить событие .

  2. В списке Событие Adjust выберите событие Adjust, которым вы хотите поделиться с OneSignal.

  3. В разделе Событие партнера необходимо выбрать событие OneSignal, соответствующее событию Adjust.

    1. Для одноплатформенных и мультиплатформенных приложений, в которых обмен данными включен только для одной платформы, выполняется сопоставление событий только для этой платформы. Для мультиплатформенных приложений с возможностью совместного использования данных для нескольких платформ вы можете:

      • нажать Использовать сопоставление конкретной платформы , чтобы сопоставить отдельные события на уровне платформы или не сопоставлять события для определенных платформ;
      • нажать Использовать глобальное сопоставление , чтобы отобразить одни и те же события для всех платформ.
    2. В списке Событие партнера выберите или введите имя настраиваемого события, которое нужно сопоставить с событием Adjust.

  4. Нажмите Применить .

Теперь OneSignal будет получать данные о событии в приложении по каждому связанному событию.

Сопоставить все события

Если OneSignal поддерживает автоматическое сопоставление всех событий, в разделе Сопоставление событий нажмите Сопоставить все события . Это экономит время при сопоставлении отдельных событий.

Теперь OneSignal будет получать данные о событии в приложении по каждому из ваших связанных событий.

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

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

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

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

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

Чтобы запросы успешно отслеживались на панели управления OneSignal, вам нужно встроить Push-токены в Adjust SDK.

Для дополнительной информации читайте руководства по работе с Adjust SDK для Android и iOS

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

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

ПлейсхолдерИнформация
{adid}Идентификатор устройства Adjust (все платформы)
{country}Код страны устройства из двух символов
{currency}Исходный валютный код ISO 4217, отправленный из Adjust SDK
{event_name}Имя события, как задано на панели управления
{idfa||gps_adid}Идентификатор IDFA или GPS ADID ID, если нет IDFA
{ip_address}IP-адрес устройства
{language}Код языка устройства из двух символов
{last_time_spent}Длительность последнего сеанса пользователя в секундах
{os_version}Номер версии операционной системы
{push_token}Токен push-уведомления, т. е. токен регистрации (Android), токен устройства (iOS)
{revenue_float}Доход в том виде, в котором он отправлен из Adjust SDK, в целых валютных единицах
{session_count}Количество сеансов, записанных текущим Adjust SDK
{app_version}Номер версии приложения (Android), номер версии сборки пакета (iOS)
{campaign_name}Название кампании (как прописано в трекере)
{created_at}Временная отметка действия
{installed_at}Временная отметка установки (т. е. первого открытия приложения)
{last_session_time}Временная отметка последнего сеанса
{network_name}Название сети (как прописано в трекере)