Спецификация ссылок атрибуции для рекламных сетей

Краткий обзор. Рекламные сети, интегрированные с AppsFlyer, указывают свою ссылку на атрибуцию в соответствии с этой статьей. 

Ссылки атрибуции для рекламных сетей

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

Модель атрибуции

Что происходит на пути от первого клика или просмотра до атрибуции установки или события и далее.

appsflyer-attribution-model-for-partners.png

  1. Пользователь кликает на баннер или на ссылку в предложении.
  2. Баннер или ссылка перенаправляют пользователя на ссылку атрибуции AppsFlyer. В ссылку атрибуции добавляются данные, собранные во время клика.
  3. Мы собираем информацию из ссылки атрибуции и сохраняем ее в своей базе данных.
  4. Происходит установка и приложение открывается в первый раз. Интегрированный в приложение SDK AppsFlyer отправляет запрос на наши серверы с информацией об устройстве, на котором установлено данное приложение.
  5. Мы сопоставляем эти сведения с нашей базой данных по кликам, используя свои методы атрибуции:
    • Сопоставление рефералов
      Это уникальный метод атрибуции для устройств Android. Когда пользователь нажимает ссылку и перенаправляется в Google Play, Google Play присваивает ему уникальный идентификатор реферера Referrer ID. Когда происходит установка, мы получаем этот идентификатор с устройства. Затем мы сопоставляем его с записями Google Play.
    • Сопоставление идентификатора устройства
      Мы сопоставляем идентификатор устройства (IDFA для iOS или GAID для Android), полученный при клике, с идентификатором устройства, на котором выполняется установка.
    • Вероятностное моделирование

    Подробнее о методах атрибуции.

    Мы ищем реферер, идентификатор устройства и точки данных вероятностного моделирования (в указанном порядке) в нашей базе данных кликов. Если совпадение найдено, установка атрибутируется клику. Если нет, установка считается органической загрузкой.

  6. После атрибуции установки мы отправляем в рекламную сеть постбэк с данными о конверсии.

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

 Примечание

Если вы используете сторонние инструменты performance-маркетинга, такие как TUNE, CAKE или Affise, см. инструкции для конкретной платформы.

Шаблон ссылки атрибуции

Ссылка атрибуции (ссылка в баннере / предложении) может выглядеть так:

https://app.appsflyer.com/com.yourapp?pid=mediaName_int&clickid={clickid}&advertising_id={gaid}&af_siteid={affiliate_id}&af_cost_model=CPI&af_cost_value={cost_value}&af_cost_currency={currency}&c={Campaign}&af_ad_type={AdType}&af_adset={Adset}&af_ad={Ad}&is_incentivized={true\false}&expires={timestamp}&signature={signature}

https://app.appsflyer.com/ — это конечная точка AppsFlyer, com.yourapp — идентификатор приложения, а pid=mediaName_int — уникальное имя медиа-источника, которое мы присваиваем вашей рекламной сети.

Эта часть ссылки неизменна, от вас ничего не требуется.

Объяснение структуры ссылки:

  • Значения после '=' внутри {} — это макросы, заполняемые вами при нажатии и отправляемые в AppsFlyer. При подготовке шаблона замените значения в скобках {} на имена параметров. 
  • Присваивание имен макросам не имеет значения при условии, что ваша система заменяет их фактическими и правильными значениями. Параметры перед знаком «=» являются заполнителями, которые использует AppsFlyer, чтобы мы знали, какие значения вы нам отправляете.
  • Для интеграции с AppsFlyer,пришлите нам по электронной почте шаблон ссылки атрибуции с именами ваших макросов. 

Параметры, перечисленные в следующей таблице, следует считать рекомендуемым минимумом. Мы поддерживаем более широкий набор параметров. Вы должны предоставить нам столько информации о клике, сколько соберете. См. список параметров ссылки атрибуции.

Рекомендуемые минимальные параметры ссылки атрибуции 

Параметр Описание
&clickid={clickid} Click ID — это уникальный идентификатор для каждого клика, совершаемого в вашей рекламной сети.
&advertising_id={gaid} или
&idfa={IDFA}
Идентификатор устройства, на котором совершается клик (GAID для Android и IDFA для Apple).
&c={campaign} Имя кампании, заданное рекламодателем.
&af_siteid={publisher_id} Идентификатор издателя или партнера, принесшего клик.
&af_ad_type={search_text} Тип рекламы. Вы можете использовать одно из следующих принятых обозначений:
search_text
banner
interstitial
video
rewarded_video
playable
sponsored_content
audio
&af_adset={adsetid} Идентификатор рекламного блока  — предоставляется рекламодателем или издателем. Группа объявлений — это промежуточный уровень в иерархии между кампанией и рекламным объявлением. Подробнее
&af_ad={ad_id} Имя рекламного объявления (подробнее). Предоставляется рекламодателем или издателем.
&is_incentivized={true} Бонусные кампании (Incentivized) или кампании, не предлагающие бонус за совершение действия (non-incentivized). Параметр может иметь значение true/false.
&af_cost_value={cost_value} Стоимость конверсии. Допустимый формат: до 4 знаков после десятичного разделителя.
Используйте ТОЛЬКО цифры. Не добавляйте к ним символы денежных единиц или десятичные запятые, поскольку они не распознаются. Допускаются только десятичные точки, например «56», «2.85» и т. д.
&af_cost_currency={currency} Валюта затрат — код валюты (например, USD, EUR). Значение по умолчанию: USD.
Список кодов валют.
&expires={timestamp} Временная метка Unix, после которой рекламная сеть не приписывает клик себе. Используется для подписывания кликов, чтобы предотвратить мошенничество с кликами. Узнать больше
&signature={signature} Подпись HMAC-SHA256, используемая для проверки клика и предотвращения мошенничества. Узнать больше