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

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

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

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

http://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). Ниже приводится полный список поддерживаемых параметров ссылок атрибуции и их описание.
http://app.appsflyer.com/com.greatapp?pid=chartboost_int&c=christmas_sale&af_adset_id=54822

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

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

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

Параметры Raw-data field Name Описание

Тип поля

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_web_dp URL-адрес для перенаправления пользователей ПК на другую веб-страницу вместо той, которая задана в шаблоне OneLink. Используется для получения данных атрибуции для пользователей ПК на других платформах (например,  Google Analytics или 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-адреса на странице перенаправления, или в тех случаях, когда параметры ссылки атрибуции могут вызвать проблемы в связи с обработкой параметров запроса на странице перенаправления.
 
Параметры ссылки атрибуции UA и ретаргетинг 
Параметры Отображаемое имя Описание

Тип поля

is_retargeting

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

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

af_reengagement_window

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

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

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

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

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

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

До 3 символов

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

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

Для рекламы некоторых типов можно отправлять и соответствующий параметр просматриваемости с подробными характеристиками вовлечения. Ниже приведен список возможных значений параметра "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   Количество воспроизведений аудиоконтента

Параметры для 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

 

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

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

Тип поля

idfa

IDFA

Идентификатор рекламодателя Apple — вводится прописными буквами. Требуется поддержка рекламной сети

До 40 символов

af_ios_url

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

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

 

af_ios_fallback

Задается альтернативный URL-адрес для пользователей iOS 10.3 

 

sha1_idfa

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

 

mac

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

 

sha1_mac

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

 

 Пример

http://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. Например:

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

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

Why is PID (publisher ID) the Most Important Parameter?

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

PID, Publisher ID, is actually the media source name. This is the primary field for attributing the install to its source.

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

Here are some examples of important integrated publisher IDs: organic, googleadwords_int (Google AdWords), Facebook ads, Twitter. You can use any name for non-integrated sources like email, sms or mail pigeons.

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

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

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

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

2. For Custom Sources Use non-integrated partner PIDs
Для каждого интегрированного источника используйте только назначенный PID, чтобы обеспечить правильную атрибуцию его установок.  Для любого пользовательского медиа-источника (например, эл. почты, SMS-сообщений или даже бесплатной рассылки в Facebook) используйте значения PID, отличные от интегрированных.
 
3. Используйте только допустимые символы.
Если параметр PID в ссылке атрибуции содержит один из этих символов — :<>*&?/, нажатие или установка будут показаны на дэшборде в разделе invalid_media_source_name.

 Совет

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

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

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

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

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

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

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

 Пример

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

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

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

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

You can use either but you must be consistent. If you set a custom parameter with upper or lower case characters, make sure to always use that parameter.

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

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

Ссылки атрибуции 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_sub5, можно использовать для регистрации любых полезных KPI (ключевых показателей эффективности). Эти параметры анализируются и отображаются в отчете по необработанным данным, что очень удобно для получения сводных данных и фильтрации.

 Пример

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

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

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

 Совет

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

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