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

Настройка Epsilon

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

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

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

Требования

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

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

Company ID и Company Magic

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

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

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

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

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

  1. Введите Company ID и Company Magic.

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

  • Установка
  • Сессия
  • Переустановка
  • событие

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

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

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

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

  • Установка
  • Сессия
  • Переустановка
  • событие

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

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

  1. В разделе Какими источниками данных вы хотите поделиться? выберите источник атрибуции данных, которые вы хотите передавать Epsilon:
  • Данные из всех источников атрибуции
  • Только данные, атрибутированные партнеру Epsilon

Сессии

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

Удаления или повторные установки

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

Примечание:

Для приложений под управлением iOS можно ожидать небольшого количества удалений и/или переустановок. Дополнительные сведения см. в разделе Оценка удалений и переустановок.

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

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

Сопоставление событий

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Сопоставьте параметры

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

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

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

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

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

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

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

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

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

Сконфигурируйте ссылки и настройки

Вы можете настроить следующие параметры:

Создайте ссылку и поделитесь ей с Epsilon

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

  • Выбранное приложение
  • Параметры обмена данными
  • Параметры структуры ссылки
  • Места назначения пользователей
  • Настройки атрибуции

Нажмите Создать ссылку, чтобы создать URL клика, URL показа, QR-код и токен ссылки. При создании ссылки также включается обмен данными и интеграция с Epsilon.

После того как ссылка создана, поделитесь ей с Epsilon для размещения в кампании.

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

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

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

  • dtm_fid*> идентификатор формы

  • dtm_promo_id*> значение, определяющее тип страницы

  • dtm_email_hash> хеш SHA-256 адреса электронной почты клиента. Удаление начальных и завершающих пробелов и преобразование адреса электронной почты в нижний регистр перед хешированием

  • dtm_mobile_hash> хеш SHA-256 номера мобильного телефона клиента в следующем формате: код страны + код города без начальных нулей + номер абонента. Удаление всех специальных символов.

  • dtm_user_id> уникальный идентификатор. Не может быть PII или хешированным адресом электронной почты

  • dtmc_tcf_string**> строка согласия на соблюдение GDPR

  • dtmc_department***> название отдела для текущего представления

  • dtmc_category***> название категории для текущего представления

  • dtmc_sub_category***> название подкатегории для текущего представления

  • dtmc_product_id****> идентификатор продукта для текущего представления

  • dtmc_brand****> марка производителя

  • dtmc_upc****> штрихкод производителя

  • dtmc_mpn***> номер модели производителя

  • dtmc_transaction_id*****> уникальный идентификатор клиентской системы для каждой конверсии

  • dtm_items> массив всех элементов в конверсии. Каждый элемент должен включать следующее:

    • product_id: SKU элемента
    • item_amount: стоимость 1 единицы элемента
    • item_quantity: количество элементов SKU в транзакции
    • item_discount: величина скидки от первоначальной суммы
  • dtmc_conv_type> позволяет различать типы онлайн-покупок: доставка, самовывоз, ...

  • dtmc_conv_store_location> для конверсии типов самовывоза обозначает местоположение магазина, в котором находится самовывоз

** обязательно*

*** обязательно в регионах, где действуют ограничения GDPR*

**** условно — требуется, если они известны, включая события, связанные с продуктом*

**** условно — требуется только при событиях просмотра товара

****** обязательно при транзакциях*

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

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

ПлейсхолдерИнформация
{currency}Исходный валютный код ISO 4217, отправленный из Adjust SDK
{deeplink}URL диплинка, добавленный в конец URL клика
{gps_adid}Рекламный идентификатор магазина Google Play
{idfa}Идентификатор IDFA (только для iOS)
{ip_address}IP-адрес устройства
{partner_parameters}Пользовательские параметры партнера, собираемые запросом Adjust SDK или S2S и передаваемые сторонним поставщикам с помощью постбэков
{random}Случайное число (уникальное в рамках колбэка)
{revenue_float}Доход в том виде, в котором он отправлен из Adjust SDK, в целых валютных единицах
{user_agent}Входящий необработанный user agent