AppsFlyer Attribution Link Structure and Parameters

  • Рекламодатели
  • агентства
  • Рекламные сети

Введение

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

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

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

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

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


Базовая ссылка атрибуции привязывается к сервису AppsFlyer с использованием адреса app.appsflyer.com. Она содержит параметр {App_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

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

The following parameters  are available to use within the generated attribution link.

 Примечание

Сведения о допустимой длине значений параметров см. здесь

Параметры Отображаемое имя Описание
pid Медиа-источник Название медиа-источника — предоставляется AppsFlyer его интегрированным партнерам, и его нельзя изменять.  Подробнее.
c Кампания Название кампании — предоставляется рекламодателем или издателем. Названия кампаний, превышающие 100 символов, отображаются на панели управления как «c_name_exceeded_max_length»

af_prt

Агентство

Имя аккаунта агентства — позволяет атрибутировать агентству новые установки

af_mp

Маркетинговый партнер

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

 Примечание

В настоящее время этот параметр применим только к маркетинговым партнерам Pinterest.

clickid

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

af_siteid

Site ID

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

af_sub_siteid

ID субсайта

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

af_c_id

ID кампании

Идентификатор кампании — предоставляется рекламодателем или издателем.

af_adset

Блок рекламы

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

af_adset_id

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

Идентификатор блока рекламы  — предоставляется рекламодателем или издателем.

af_ad

Реклама

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

af_ad_id

ID рекламы. Идентификатор кампании — предоставляется рекламодателем или издателем.

af_ad_type*

Тип рекламы

Тип объявления — используйте одно из следующих условных обозначений:

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

af_click_lookback

Окно ретроспективного обзора для атрибуции по кликам. Длительность этого окна является максимальным значением CTIT (время от клика до установки) для нового пользователя, который будет атрибутирован с источником, отображающим рекламу или ссылку.

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

 Примечание

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

af_viewthrough_lookback

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

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

 Примечание

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

is_retargeting

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

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

af_reengagement_window

Re-Engagement Window

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

Здесь можно задать любую длительность окна — от 1 до 90 дней (1d - 90d) или от 1 до 36 часов (1h - 36 ч).  Значение этого параметра по умолчанию: 30d.

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

af_channel

Канал

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

af_keywords

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

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

af_cost_model

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

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

af_cost_currency

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

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

af_cost_value

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

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

 Важно!

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

af_sub1

Sub Param 1

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

af_sub2 Sub Param 2 Параметр подписчика 2
af_sub3 Sub Param 3 Параметр подписчика 3 
af_sub4 Sub Param 4 Параметр подписчика 4 
af_sub5 Sub Param 5 Параметр подписчика 5 
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 секунды (например, "30") Максимально возможная длительность видео
af_video_played_length секунды (например, "2") Продолжительность просмотра видео
af_playable_played_length секунды (например, "30") Продолжительность воспроизведения после полной загрузки
af_ad_time_viewed секунды (например, "1") Продолжительность показа рекламного блока на экране
af_ad_displayed_percent % (например, "75") Максимальная часть рекламного блока в процентах, показанная на экране устройства
af_audio_total_length секунды (например, "30") Максимально возможная длительность аудиоконтента
af_audio_played_length секунды (например, "2") Количество воспроизведений аудиоконтента

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

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

advertising_id

Advertising ID

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

sha1_advertising_id

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

android_id

Android ID

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

sha1_android_id

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

af_android_url

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

sha1_el

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

fire_advertising_id

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


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

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

idfa

IDFA

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

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.

Почему 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
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 4 из 5