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

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

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

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

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

http://app.appsflyer.com/{app_id}


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

 Пример

Пример: в следующей ссылке атрибуции для приложения 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 (Тип поля) указывает на максимальное количество символов в значении параметра. Подробности об ограничениях длины значения параметра см. здесь.

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

Тип поля

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 (часы). Значение по умолчанию: 7d.

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

До 3 символов

af_viewthrough_lookback

Окно ретроспективного обзора для атрибуции по просмотрам

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

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

До 3 символов

is_retargeting

Это кампания ретаргетинга?

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

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

af_reengagement_window

Re-Engagement Window

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

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

  • Дни: 1-90
    --ИЛИ--
  • Часы: 1-36

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

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

До 3 символов

af_channel

Канал

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

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

af_keywords

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

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

Строка 100

af_cost_model

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

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

Строка 20

af_cost_currency

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

Код валюты (например, USD, EUR). См. список всех допустимых кодов валюты. Значение по умолчанию: USD.

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

af_cost_value

Величина затрат

Стоимость конверсии.  Допустимый формат: до 4 знаков после десятичного разделителя. 

 Важно!

Можно задавать ТОЛЬКО цифры. Не добавляйте к цифрам символы денежных единиц или десятичные запятые (только точки), поскольку они не распознаются. Например, «56», «2.85» и т. д.

Строка 20

af_sub1

Sub Param 1

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

Строка 100

af_sub2 Sub Param 2 Параметр подписчика 2 Строка 100
af_sub3 Sub Param 3 Параметр подписчика 3  Строка 100
af_sub4 Sub Param 4 Параметр подписчика 4  Строка 100
af_sub5 Sub Param 5 Параметр подписчика 5  Строка 100
af_r Перенаправление пользователей на указанный URL-адрес для обеих платформ (Android и iOS)  
af_web_dp Перенаправление пользователей ПК на другую веб-страницу вместо той, которая задана в шаблоне OneLink. Используется для получения данных атрибуции для пользователей ПК на других платформах (например,  Google Analytics или Omniture).  
af_dp Путь для действий в приложении, по которому пользователи направляются с помощью глубинной ссылки. Используется для глубинных ссылок и ретаргетинга  
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
Кампании искусственного мотивирования
 
af_param_forwarding Если задано значение "false", параметры ссылки атрибуции не пересылаются на страницу, указанную для перенаправления.
Этот параметр можно использовать для "очистки" URL-адреса на странице перенаправления, или в тех случаях, когда параметры ссылки атрибуции могут вызвать проблемы в связи с обработкой параметров запроса на странице перенаправления.
 

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

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

Почему ID партнёра (PID) является самым важным параметром?

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

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

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

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

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

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

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

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

2. НЕ используйте PID ИНТЕГРИРОВАННЫХ партнеров для собственных медиа-источников. 
Для каждого интегрированного источника используйте только назначенный 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

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

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

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

Например, если вы установили 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 лучших метода оптимизации структуры ссылок и данных.

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