Краткий обзор. В статье описаны структура и параметры ссылки атрибуции в 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).
Пример
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 |
Агентство |
|
Строка 50 |
|
af_mp |
— |
|
|
|
clickid |
— |
Уникальный идентификатор кликов для рекламной сети |
|
|
af_siteid |
Site ID |
|
Строка 24 |
|
af_sub_siteid |
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 |
Тип рекламного объявления |
Используйте следующие принятые наименования:
|
Строка 24 |
|
af_click_lookback |
Окно атрибуции |
Примечание: применимо только для URL-адресов кликов и неприменимо для URL-адресов показов. |
До 3 символов |
|
af_viewthrough_ |
— |
Примечание: применимо только для URL-адресов показов и неприменимо для URL-адресов кликов. |
До 3 символов |
|
af_channel |
Канал |
Канал медиа-источника, через который распространяется реклама, например: UAC_Search, UAC_Display, Instagram, Facebook Audience Network и т. д. |
Динамическое перечисление Строка 20 |
|
af_keywords |
Ключевые слова |
Список ключевых слов для SMS кампаний. |
Строка 100 |
|
af_cost_model |
Модель затрат |
|
Строка 20 |
|
af_cost_currency |
Валюта расходов |
|
Перечисление 3 символа |
|
af_cost_value |
Числовое значение величины затрат. |
|
Строка 20 |
|
af_sub[n] (n=1-5) например: af_sub1 |
Sub Param [n] |
Дополнительный настраиваемый параметр, задаваемый рекламодателем. Дополнительные сведения об использовании этих параметров см. в разделе «Вопросы и ответы». |
Строка 100 |
| af_r | — |
Перенаправляет пользователей на URL-адрес, указанный для обеих платформ (Android и iOS). |
|
| af_web_dp | — | URL-адрес для перенаправления пользователей ПК (например, Windows или Mac) на веб-страницу, отличную от той, которая задана в шаблоне OneLink. Используется для получения данных атрибуции по пользователям ПК на других платформах (например, Google Аналитика или Omniture). | |
| af_dp | — | Резервное значение схемы URI для запуска приложения, которое будет использоваться в случае сбоя универсальной ссылки или 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 |
— |
|
|
| af_os | Версия ОС | [Только для iOS] Версия операционной системы устройства | |
| af_model | Тип и модель устройства iOS |
[Только для iOS] Тип устройства. Возможные значения:
|
|
| af_media_type | Тип медиа |
Размещение объявления со ссылкой выполняется следующим образом:
|
| Параметры | Отображаемое имя в сырых данных | Описание |
Тип поля |
|---|---|---|---|
|
is_retargeting |
Is Retargeting (campaign) | Для ретаргетинговых кампаний все URL-адреса кликов должны содержать параметр &is_retargeting=true.Если этот параметр отсутствует или имеет значение «false», кампания считается обычной кампанией по привлечению пользователей. |
Перечисление 5 символов |
|
af_reengagement_window |
Окно повторного вовлечения |
Добавление этого параметра в ссылку атрибуции позволяет изменить окно атрибуции повторного вовлечения. Возможные значения окна:
Значение по умолчанию: 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 | Количество воспроизведений аудиоконтента |
Параметры для 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 на другой URL-адрес вместо страницы приложения в Google Play. Используется для сторонних магазинов приложений. |
|
|
sha1_el |
— |
Используется для атрибуции пользователей настольных и мобильных устройств — электронные сообщения, хэшированные по алгоритму SHA1. Требуется поддержка рекламной сети |
|
|
fire_advertising_id |
— |
Рекламный идентификатор Amazon Fire |
|
Параметры для 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Нужно учесть две важные вещи:
- Настраиваемые параметры не отображаются в необработанных данных.
- Настраиваемые параметры можно извлечь из SDK API получения данных о конверсиях.
Параметр «Идентификатор партнера» (PID)
Среди всех доступных параметров ссылки атрибуции PID — это единственный параметр, который нужно ОБЯЗАТЕЛЬНО включать в каждую ссылку атрибуции.
ID партнера (PID) фактически представляет собой имя медиа-источника. Это основное поле для атрибуции установки ее источнику.
Интегрированным партнерам присваивается уникальный идентификатор PID, который заканчивается на "_int". При использовании настраиваемых ссылок атрибуции можно указывать любое имя PID, которое не было зарезервировано для интегрированных партнёров.
Примеры некоторых важных ID интегрированных издателей: organic, googleadwords_int (Google Adwords), Facebook Ads, Twitter. Для неинтегрированных источников, таких как email, SMS и даже голубиной почты, можно использовать любые имена.
Постарайтесь избежать типичных проблем с PID
- Обязательно включайте PID в ссылки атрибуции. Если в ссылке атрибуции нет параметра PID, пользователь автоматически атрибутируется медиа-источнику None (Нет), а реальный источник установки не учитывается.
- Не используйте PID интегрированных партнеров для собственных медиа-источников. Для каждого интегрированного источника используйте только назначенный PID, чтобы обеспечить правильную атрибуцию его установок. Для любого пользовательского медиа-источника (например, эл. почты, SMS-сообщений или даже бесплатной рассылки в Facebook) используйте значения PID, отличные от интегрированных.
- Используйте только допустимые символы. Если параметр PID в ссылке атрибуции содержит один из этих символов ":<>*&?/", клик или установка будут показаны на дэшборде в разделе invalid_media_source_name.
Совет
Старайтесь не включать пробелы в значение PID или же выполните URL-кодирование ссылок атрибуции, прежде чем их использовать.
Параметр «Идентификатор сайта»
ID сайта — это уникальный идентификатор издателя, непосредственно размещающего рекламу, т. е. ID сайта или приложения, в котором показывается реклама. У рекламной сети / партнера по одному идентификатору сайта на каждого используемого издателя.
Этот идентификатор указывается в параметре af_siteid, который передается в Appsflyer в ссылке атрибуции и попадает на различные дэшборды AppsFlyer, в отчеты по сырым данным и получаемые вами постбэки.
ID сайта необходимо передавать в AppsFlyer в ссылке атрибуции, потому что он:
- позволяет получить четкие и прозрачные сведения об издателе;
- используется AppsFlyer для выявления и исключения недобросовестных издателей и других кластеров трафика.
В параметре «ID сайта» указывается только идентификатор издателя, разместившего рекламу. Если вы хотите указать дополнительную информацию, такую как тип/размещение рекламы в приложении (например, баннер, рекламная вставка или видео), используйте параметр «ID субсайта».
Пример
Указанная ниже ссылка атрибуции включает следующие параметры:
-
af_siteid(ID сайта): идентификатор издателя -
af_sub_siteid(ID субсайта): дополнительные сведения об идентификаторе (в этом случае, партнерский источник и тип размещения рекламы)
https://app.appsflyer.com/com.yourapp?pid=mediaName_int&clickid={clickid}&advertising_id={gaid}&af_siteid=1234&af_sub_siteid=ABCD_4567
В примере ссылки:
- 1234 = идентификатор издателя
- ABCD = партнерский источник (субиздатель), с которым работает издатель
- 4567 = тип размещения рекламы в приложении, например, баннер, рекламная вставка или видео
Вопросы и ответы: почему в трафике много заблокированных установок?
Установки могут блокироваться по следующим причинам:
-
Отсутствует ID сайта: в URL-адресе клика пустой параметр
af_siteid. Интеграции, отправленные с пустым идентификатором сайта, говорят либо о технической ошибке, либо о намеренной попытке обхода механизмов обнаружения фрода. - Несколько ID сайта: один и тот же издатель указан по нескольким URL-адресам кликов с разными идентификаторами сайта. Такая ситуация считается мошенническим поведением, маскирующим реальную активность издателя, и часто бывает связана с клик-флудингом.
- ID сайта неверно отформатирован: отправка идентификатора в неверном формате в сочетании с другими признаками мошенничества может приводить к блокировке не только конкретного издателя, но и вышестоящего кластера, что может затронуть большие объемы активности партнера.
Чтобы избежать блокировки установок, убедитесь, что по каждому издателю передается только один параметр «ID сайта», как показано в примере.
Уровни детализации данных
Для глубокого анализа эффективности рекламы можно использовать до четырех URL-параметров.
Использование всех 4 параметров во всех активных ссылках атрибуции позволяет:
- Атрибуция всех пользовательских установок и событий с конкретной рекламой.
- Углубленный анализ и сравнение эффективности всех рекламных объявлений по группе объявлений, рекламной кампании и медиа-источнику с помощью агрегированных отчетов для оптимизации на каждом уровне.
- Сравнение всех рекламных объявлений во всех медиа-источниках в отчетах необработанных данных и сводной таблице.
Эти параметры включают:
Медиа-источник (pid=)Имя кампании (c=)Блок рекламы (af_adset=)Имя рекламы (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-адреса (например,
yourbrand.onelink.me/HaT8/r5c2b371), используемые для настраиваемых ссылок атрибуции, являются динамическими.Это означает, что после того, как вы начнете использовать ссылку атрибуции для интегрированного партнера или длинный URL-адрес для собственных каналов, эта ссылка останется такой же для любых лидов, которые ею воспользуются, даже если вы измените значение ссылки атрибуции на дэшборде AppsFlyer. Чтобы изменения вступили в силу, нужно в дальнейшем использовать новый длинный URL-адрес.
С другой стороны, короткие URL-адреса для собственных каналов взаимодействия не содержат непосредственно заданных параметров. Когда потенциальный пользователь переходит по короткому URL-адресу, созданному в AppsFlyer, он перенаправляется на AppsFlyer, и установка текущих параметров выполняется динамически.
Что означает это сообщение об ошибке от магазина Play Store?
Возможно, вы получали такие сообщения в Play Store при использовании приведенной ниже ссылки атрибуции:
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#Обычно такие символы в ссылке — это макросы, которые динамически заменяются соответствующими значениями, так что это не слишком серьезная проблема, и вы можете игнорировать это сообщение.
Для чего можно использовать параметры подписчика?
Пример
Приложение для поиска попутных автомобилей Luber использует рекламные объявления на основе 3 цветовых шаблонов: синего, желтого и красного. Линда, специалист по мобильному маркетингу компании Luber, решила выяснить, шаблон какого цвета дает больше всего установок. Для этого она добавила в ссылки атрибуции параметр &af_sub3=blue для всех синих объявлений во ВСЕХ медиа-источниках без самостоятельной атрибуции. То же самое она сделала для желтых и красных объявлений. Получив проанализированные и необработанные данные, Линда сможет сравнить эффективность объявлений разного цвета и выбрать шаблон, который дает больше всего конверсий.
Какой длины может быть название рекламной кампании?
c_name_exceeded_max_length
Совет
Видео: Ноам Гохари из Playtika раскрывает 3 лучших метода оптимизации структуры ссылок и данных.