Структура и параметры ссылки атрибуции

Краткий обзор. В статье описаны структура и параметры ссылки атрибуции в AppsFlyer.

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

Базовая ссылка атрибуции AppsFlyer

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

https://app.appsflyer.com/{app_id}?pid={media_source}


Базовая ссылка атрибуции содержит параметр {App_id}, то есть ID приложения для Apple iTunes/App Store или имя пакета для Google Play, а также платный параметр (медиа-источник). Это минимальное требование к ссылке атрибуции.

Примечание: Для приложений Amazon используйте имя пакета (а не ASIN).

 Пример

В следующей ссылке атрибуции для приложения com.greatapp используются несколько параметров, в том числе медиа-источник (pid), имя кампании (c) и идентификатор группы объявлений (af_adset_id). Ниже приводится полный список поддерживаемых параметров ссылок атрибуции и их описание.

https://app.appsflyer.com/com.greatapp?pid=chartboost_int&c=christmas_sale&af_adset_id=54822

Параметры ссылки атрибуции

Перечень параметров, которые можно использовать при создании ссылки атрибуции.

Число в столбце Field type (Тип поля) указывает на максимальное количество символов в значении параметра. Подробности об ограничениях длины значения параметра см. здесь.

Параметры Отображаемое имя в сырых данных Описание

Тип поля

pid Медиа-источник Уникальный идентификатор для интегрированного партнера AppsFlyer. Не изменяйте его. Подробнее.

Строка 50

c Кампания Предоставляется рекламодателем или издателем. Названия кампаний, превышающие 100 символов, отображаются на дэшборде как «c_name_exceeded_max_length»

Строка 100

af_prt

Агентство

  • Имя аккаунта агентства позволяет атрибутировать агентству новые установки
  • Внимание: не используйте этот параметр, не убедившись, что Agency Permissions (Разрешения для агентства) активированы.  

Строка 50

af_mp

  • Позволяет отправлять постбэки маркетинговым партнерам издателей после каждой установки.
  • Примечание. В настоящее время этот параметр применим только к маркетинговым партнерам Pinterest.

 

clickid

Уникальный идентификатор кликов для рекламной сети

 

af_siteid

Site ID

ID издателя в рекламной сети

Строка 24

af_sub_siteid

ID субсайта

ID рекламной субсети или издателя

Строка 50

af_c_id

ID кампании

Предоставляется рекламодателем или издателем

Строка 24

af_adset

Блок рекламы

  • Предоставляется рекламодателем или издателем.
  • Группа объявлений — это промежуточный уровень в иерархии между кампанией и рекламным объявлением. Подробнее

Строка 100

af_adset_id

ID блока рекламы

Предоставляется рекламодателем или издателем

Строка 24

af_ad

Реклама

Название рекламного объявления (подробнее) — предоставляется рекламодателем или издателем.

Строка 100

af_ad_id

ID рекламы. Предоставляется рекламодателем или издателем

Строка 24

af_ad_type

Тип рекламного объявления

Используйте следующие принятые наименования:

  • text: элемент рекламы, содержащий только текст, например, результат поиска
  • banner: базовый формат, который демонстрируется вверху или внизу экрана устройства
  • interstitial: реклама  на всю страницу, которая демонстрируется в промежутках между текущим интерфейсом
  • video:  стандартное видео, бонусы не предоставляются
  • rewarded_video: рекламный блок, за просмотр которого приложение предоставляет бонусы
  • playable: интерактивный рекламный блок для предварительного ознакомления с приложением
  • sponsored_content:  ссылка, включенная в фрагмент заказного контента, например, в рекламную статью
  • audio: звуковое объявление

Строка 24

af_click_lookback

Окно атрибуции

  • Окно ретроспективного обзора для атрибуции по кликам. Длительность этого окна является максимальным значением CTIT (время от клика до установки) для нового пользователя, который будет атрибутирован с источником, отображающим рекламу или ссылку.
  • Настраиваемое количество дней для периода ретроспективной атрибуции по кликам. Допустимые значения параметра: 1d–30d (дни) ИЛИ 1h–23h (часы). Значение по умолчанию: 7 дней.
  • Окно атрибуции можно настроить для ссылок OneLink и SRN.

Примечание: применимо только для URL-адресов кликов и неприменимо для URL-адресов показов.

До 3 символов

af_viewthrough_
lookback

  • Настраиваемое количество дней для периода ретроспективной атрибуции по просмотрам. Допустимые значения параметра: 1h - 48h (часы) ИЛИ 1d - 7d (дни). Значение по умолчанию: 1d.
  • Окно атрибуции можно настроить для SRN.

Примечание: применимо только для URL-адресов показов и неприменимо для URL-адресов кликов.

До 3 символов

af_channel

Канал

Канал медиа-источника, через который распространяется реклама, например: UAC_Search, UAC_Display, Instagram, Facebook Audience Network и т. д.

Динамическое перечисление Строка 20

af_keywords

Ключевые слова

Список ключевых слов для SMS кампаний.

Строка 100

af_cost_model

Модель затрат

  • Модель затрат; в настоящее время поддерживается только модель CPI (по умолчанию), т. е. оплата за клик, с помощью которой в AppsFlyer выполняется сбор данных о расходах для агрегированных отчетов.
  • По возможности сообщайте данные о затратах через API. В случаях, когда данные о затратах сообщаются и по ссылке, и через API, API имеет приоритет.

Строка 20

af_cost_currency

Валюта расходов

  • Код валюты из трех символов по стандарту ISO-4217.Например, USD, ZAR, EUR
  • [По умолчанию] USD

Перечисление 3 символа 

af_cost_value

Числовое значение величины затрат.

  • Величина затрат в валюте расходов.
  • До 4 знаков после десятичного разделителя. 
  • Используйте только цифры и десятичные точки (не запятые). Например: "56", "2.85"

Строка 20

af_sub[n] 

(n=1-5) например: af_sub1

Sub Param [n]

Дополнительный настраиваемый параметр, задаваемый рекламодателем Дополнительные сведения об использовании этих параметров см. в разделе «Вопросы и ответы».

Строка 100

af_r

Перенаправляет пользователей на URL-адрес, указанный для обеих платформ (Android и iOS).
Примечание. Если задан параметр af_r, вам не нужно задавать параметры af_ios_url, af_android_url и af_web_dp, так как эти перенаправления уже учтены в параметре af_r.

 
af_web_dp URL-адрес для перенаправления пользователей ПК (например, Windows или Mac) на веб-страницу, отличную от той, которая задана в шаблоне OneLink. Используется для получения данных атрибуции по пользователям ПК на других платформах (например,  Google Аналитика или Omniture).  
af_dp Резервное значение для запуска приложения, которое будет использоваться в случае сбоя универсальной ссылки или Android App Link, а также для пользователей Android версии ниже 6.0.Оно должно указывать только на основной путь, т.е. на активность по умолчанию.  
af_force_deeplink Принудительное перенаправление по глубинной ссылке на действие, указанное в параметре af_dp value  
af_ref
Рекламные сети, в которых используются S2S-нажатия, могут отправлять уникальное значение реферера с помощью параметра &af_ref=ReferrerValue
 
Значение af_ref должно быть уникальным и иметь такую структуру:
NetworkName_UniqueClickValueForEachClick
 
Пример: af_ref=networkname_123456789ABCDEF
 
В качестве имени сети можно использовать любую действительную строку. Это может быть строка формата "имясети_целоечисло" или просто "имясети".
 
AppsFlyer может использовать этот параметр для атрибуции в устройствах Android. AppsFlyer не использует этот параметр для атрибуции в устройствах на базе iOS или Windows.
 
 
is_incentivized
Значения: true/false
Бонусные кампании (Incentivized) или кампании, не предлагающие бонус за совершение действия (non-incentivized)
 
af_param_
forwarding
  • Если задано значение false, параметры ссылки атрибуции не пересылаются на страницу, указанную для перенаправления.
  • Этот параметр можно использовать для "очистки" URL-адреса на странице перенаправления, или в тех случаях, когда параметры ссылки атрибуции могут вызвать проблемы в связи с обработкой параметров запроса на странице перенаправления.
 
af_os Версия ОС [Только для iOS] Версия операционной системы устройства  
af_model Тип и модель устройства iOS

[Только для iOS] Тип устройства. Возможные значения:

  • iphone (все строчные буквы)
  • ipad (все строчные буквы) 
 
af_media_type Тип медиа

Размещение объявления со ссылкой выполняется следующим образом:

  • app: ссылка доступна через приложение.
  • web: ссылка доступна на мобильной версии веб-сайта.
 
Параметры ссылки атрибуции UA и ретаргетинг 
Параметры Отображаемое имя в сырых данных Описание

Тип поля

is_retargeting

Is Retargeting (campaign)  Для ретаргетинговых кампаний все URL-адреса кликов должны содержать параметр &is_retargeting=true.
Если этот параметр отсутствует или имеет значение «false», кампания считается обычной кампанией по привлечению пользователей.

Перечисление 5 символов

af_reengagement_window

Окно повторного вовлечения

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

Возможные значения окна:

  • Дни 1-90 или Часы 1-36
  • Lifetime: Это значит, что интервал окна повторного вовлечения не ограничен. Например: &af_reengagement_window=lifetime

Значение по умолчанию: 30 дней

Пример: если задать значение &af_reengagement_window=30d, длительность окна повторного вовлечения будет 30 дней.

Параметры ссылки атрибуции только ретаргетинг

Параметры типа рекламы

Для рекламы некоторых типов можно отправлять и соответствующий параметр просматриваемости с подробными характеристиками вовлечения. Ниже приведен список возможных значений параметра "af_ad_type" вместе с параметрами ожидаемой просматриваемости.

Параметр Формат значения Описание
af_video_total_length   Максимально возможная длительность видео
af_video_played_length   Продолжительность просмотра видео
af_playable_played_length   Продолжительность воспроизведения после полной загрузки
af_ad_time_viewed   Продолжительность показа рекламного блока на экране
af_ad_displayed_percent   Максимальная часть рекламного блока в процентах, показанная на экране устройства
af_audio_total_length   Максимально возможная длительность аудиоконтента
af_audio_played_length   Количество воспроизведений аудиоконтента
Тип объявления (af_ad_type)

Параметры для Android

Параметр Отображаемое имя в сырых данных Описание

Тип поля

advertising_id

Advertising ID

ID рекламы Google — требуется поддержка рекламной сети.

До 40 символов

sha1_advertising_id

ID рекламы Google, хешированный с SHA1 — требуется поддержка рекламной сети.

 

md5_advertising_id

ID рекламы Google, хешированный с SHA1 — требуется поддержка рекламной сети.

Поддерживается только с установками и реатрибуциями

android_id

Android ID

ID устройства android_id — требуется поддержка рекламной сети.

До 20 символов

sha1_android_id

ID устройства android_id, хешированный с SHA1 — требуется поддержка рекламной сети.

 

md5_android_id

ID устройства android_id, хешированный с MD5 — требуется поддержка рекламной сети.

Поддерживается только с установками и реатрибуциями

imei

imei

ID устройства IMEI

 

sha1_imei

ID устройства IMEI, хэшированный с SHA1 — требуется поддержка рекламной сети

 

md5_imei

IMEI ID устройства, хэшированный MD5 — требуется поддержка рекламной сети

 

oaid

oaid

Открытый анонимный идентификатор устройства

Доступно в Android SDK версии 4.10.3

sha1_oaid

Открытый анонимный идентификатор устройства, хешированный SHA1 — требуется поддержка рекламной сети

Доступно в Android SDK версии 4.10.3

md5_oaid

Открытый анонимный идентификатор устройства, хешированный MD5 — требуется поддержка рекламной сети Доступно в Android SDK версии 4.10.3

af_android_url

Перенаправление пользователей Android на другую веб-страницу вместо страницы приложения в Google Play. Используется для приложений, не связанных с магазином

 

sha1_el

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

 

fire_advertising_id

Рекламный идентификатор Amazon Fire

 

Параметры для Android

Параметры для iOS

Параметры Отображаемое имя Описание

idfa

IDFA

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

Тип поля: не более 40 символов

idfv

IDFV Используйте верхний регистр. 

af_ios_url

Перенаправление пользователей iOS (iPhone или iPad) на другую веб-страницу вместо страницы приложения в iTunes

Используется для перенаправления на целевые страницы

af_ios_fallback [устарело]

Устарело. Пользователи перенаправляются на основе алгоритма схемы URI для iOS

sha1_idfa

IDFA хэширован с помощью SHA1. Требуется поддержка рекламной сети

sha1_idfv

IDFV хэширован с помощью SHA1

mac

Mac-адрес устройства. Требуется поддержка рекламной сети

md5_idfv

IDFV хэширован с помощью MD5

sha1_mac

Mac-адрес устройства, хэшированный по алгоритму SHA1. Требуется поддержка рекламной сети

 Пример

https://app.appsflyer.com/{app_id}/?pid=airpush_int&c=RedBanner&
	  af_siteid={publisher_id}&af_sub1=1.5&af_sub2=USD&af_sub3=burst_campaign


Описания всех параметров приведены в статьях Отчет об установке и Аналитика, отчеты и API.

Настраиваемые параметры

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

Вы можете добавить настраиваемые параметры к ссылке атрибуции в формате parameter=value. Например:

https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&af_adset=coats&af_ad=cashmere&my_custom_param=my_custom_value

Нужно учесть две важные вещи:

Почему идентификатор издателя (PID) является самым важным параметром?

Среди всех доступных параметров ссылки атрибуции PID — это единственный параметр, который нужно ОБЯЗАТЕЛЬНО включать в каждую ссылку атрибуции.

ID партнёра (PID) фактически представляет собой название медиа-источника. Это основное поле для атрибуции установки с ее источником.

Интегрированным партнерам присваивается уникальный идентификатор PID, который заканчивается на "_int". При использовании настраиваемых ссылок атрибуции можно указывать любое имя PID, которое не было зарезервировано для интегрированных партнёров.

Примеры некоторых важных ID интегрированных издателей: organic, googleadwords_int (Google Adwords), Facebook Ads, Twitter. Для неинтегрированных источников, таких как email, SMS и даже голубиной почты, можно использовать любые имена.

Постарайтесь избежать типичных проблем с PID

При использовании параметра PID соблюдайте следующие правила:

Обязательно включайте PID в ссылки атрибуции.

Если в ссылке атрибуции нет параметра PID, пользователь автоматически атрибутируется медиаисточнику "None", а первоначальный источник установки будет утерян.

Не используйте PID интегрированных партнеров для собственных медиа-источников.
Для каждого интегрированного источника используйте только назначенный PID, чтобы обеспечить правильную атрибуцию его установок. Для любого пользовательского медиа-источника (например, эл. почты, SMS-сообщений или даже бесплатной рассылки в Facebook) используйте значения PID, отличные от интегрированных.
 
Используйте только допустимые символы.
Если параметр PID в ссылке атрибуции содержит один из этих символов  ":<>*&?/", клик или установка будут показаны на дэшборде в разделе invalid_media_source_name.

 

 Совет

Старайтесь не включать пробелы в значение PID или же выполните URL-кодирование ссылок атрибуции, прежде чем их использовать.

Уровни детализации данных

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

Использование всех 4 параметров во всех активных ссылках атрибуции позволяет:

  • Атрибуция всех пользовательских установок и событий с конкретной рекламой.
  • Углубленный анализ и сравнение эффективности всех рекламных объявлений по группе объявлений, рекламной кампании и медиа-источнику с помощью агрегированных отчетов для оптимизации на каждом уровне.
  • Сравнение всех рекламных объявлений во всех медиа-источниках в отчетах необработанных данных и сводной таблице.

Эти параметры включают:

  1. Медиа-источник (pid=)
  2. Имя кампании (c=)
  3. Блок рекламы (af_adset=)
  4. Имя рекламы (af_ad=)

 Пример

В приведенной ниже ссылке атрибуции используются 4 уровня детализации для регистрации объявлений с ключевым словом "cashmere" (кашемир) в группе объявлений "coats" (пальто), которая используется в рекламной кампании "winter" (зима), запущенной в интегрированном медиаисточнике "networkx".


https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmere

Вопросы и ответы

Какие буквы нужно использовать в именах параметров — строчные или прописные?

Можно использовать любые буквы, однако формат имени должен быть единообразным. Задавая имя настраиваемого параметра прописными или строчными буквами, следите за тем, чтобы оно везде было указано именно в таком формате.

Например, если вы установили pid=MyMediaSource, всегда используйте именно это имя. Если в одной ссылке атрибуции использовать имя pid=MyMediaSource, а в другой — pid=mymediasource, то в данных могут появиться расхождения. Это относится и ко всем остальным параметрам, которые включаются в ссылку атрибуции.

Ссылки атрибуции AppsFlyer — это динамические или статические ссылки?

Ссылки атрибуции могут быть как динамическими, так и статическими.
Как определить, является ли ссылка динамической или статической?
Если ссылка атрибуции содержит параметры, это длинная предопределенная ссылка атрибуции и, следовательно, она является статической.
Динамическими являются только короткие URL-адреса, используемые для настраиваемых ссылок атрибуции.
Это означает, что после того, как вы начнете использовать ссылку атрибуции для интегрированного партнера или длинный URL-адрес для собственных каналов, эта ссылка останется такой же для любых лидов, которые ею воспользуются, даже если вы измените значение ссылки атрибуции на дэшборде AppsFlyer. Чтобы изменения вступили в силу, нужно в дальнейшем использовать новый длинный URL-адрес.
С другой стороны, короткие URL-адреса для собственных каналов взаимодействия не содержат непосредственно заданных параметров. Когда потенциальный пользователь переходит по короткому URL-адресу, созданному в AppsFlyer, он перенаправляется на AppsFlyer, и установка текущих параметров выполняется динамически.

Что означает это сообщение об ошибке от магазина Play Store?

Возможно, вы получали такие сообщения в Play Store при использовании приведенной ниже ссылки атрибуции:

TL_error_message.png

Причина в том, что ссылка атрибуции содержит символ #. Например:
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#

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

Для чего можно использовать параметры подписчика?

Параметры подписчика, то есть параметры af_sub1, af_sub2, ..., af_sub_5 можно использовать для регистрации любых полезных KPI (ключевых показателей эффективности). Эти параметры анализируются и отображаются в отчете по сырым данным, что очень удобно для получения сводных данных и фильтрации.

 Пример

Приложение для поиска попутных автомобилей Luber использует рекламные объявления на основе 3 цветовых шаблонов: синего, желтого и красного. Линда, специалист по мобильному маркетингу компании Luber, решила выяснить, шаблон какого цвета дает больше всего установок. Для этого она добавила в ссылки атрибуции параметр &af_sub3=blue для всех синих объявлений во ВСЕХ медиа-источниках без самостоятельной атрибуции. То же самое она сделала для желтых и красных объявлений. Получив проанализированные и необработанные данные, Линда сможет сравнить эффективность объявлений разного цвета и выбрать шаблон, который дает больше всего конверсий.

Какой длины может быть название рекламной кампании?

В AppsFlyer длина названия кампании в URL-адресе ссылки атрибуции не должна превышать 100 символов. Если длина названия кампании больше допустимой, вместо названия кампании используется строка c_name_exceeded_max_length

 Совет

Видео: Ноам Гохари из Playtika раскрывает 3 лучших метода оптимизации структуры ссылок и данных.

Была ли эта статья полезной?