Краткий обзор: Ссылки атрибуции предоставляют 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).
Пример
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 |
Агентство |
|
Строка 50 |
|
af_mp |
Маркетинговый партнер |
|
|
|
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 |
Тип рекламы |
Типы объявлений называются в соответствии с соглашением о наименовании:
|
Строка 24 |
|
af_click_lookback |
Окно ретроспективного обзора для атрибуции по кликам. Длительность этого окна является максимальным значением CTIT (время от клика до установки) для нового пользователя, который будет атрибутирован с источником, отображающим рекламу или ссылку. |
Примечание: применимо только для URL-адресов кликов и неприменимо для URL-адресов показов. |
До 3 символов |
|
af_viewthrough_lookback |
Окно ретроспективного обзора для атрибуции по просмотрам |
Примечание: применимо только для 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-адрес для перенаправления пользователей ПК на другую веб-страницу вместо той, которая задана в шаблоне 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-адреса на странице перенаправления, или в тех случаях, когда параметры ссылки атрибуции могут вызвать проблемы в связи с обработкой параметров запроса на странице перенаправления.
|
| Параметры | Отображаемое имя | Описание |
Тип поля |
|---|---|---|---|
|
is_retargeting |
Это кампания ретаргетинга? | Для ретаргетинговых кампаний все URL-адреса кликов должны содержать параметр &is_retargeting=true.Если этот параметр отсутствует или имеет значение «false», кампания считается обычной кампанией по привлечению пользователей. |
Перечисление 5 символов |
|
af_reengagement_window |
Окно повторного вовлечения |
Добавление этого параметра в ссылку атрибуции позволяет изменить окно атрибуции повторного вовлечения. Возможные значения окна:
Значение по умолчанию: 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Нужно учесть две важные вещи:
- Настраиваемые параметры не отображаются в необработанных данных.
- Настраиваемые параметры можно извлечь из SDK API получения данных о конверсиях.
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 соблюдайте следующие правила:
Если в ссылке атрибуции нет параметра PID, пользователь автоматически атрибутируется медиаисточнику "None" (Нет), а первоначальный источник установки будет утерян.
Совет
Старайтесь не включать пробелы в значение PID или же выполните URL-кодирование ссылок атрибуции, прежде чем их использовать.
Уровни детализации данных
Для глубокого анализа эффективности рекламы можно использовать до четырех URL-параметров.
Использование всех 4 параметров во всех активных ссылках атрибуции позволяет:
- Атрибуция всех пользовательских установок и событий с конкретной рекламой.
- Углубленный анализ и сравнение эффективности всех рекламных объявлений в блоке рекламы, рекламной кампании и медиа-источнике с помощью агрегированных отчетов для оптимизации на каждом уровне.
- Сравнение всех рекламных объявлений во всех медиа-источниках в отчетах необработанных данных и сводной таблице.
Эти параметры включают:
Медиа-источник (pid=)Имя кампании (c=)Блок рекламы (af_adset=)Имя рекламы (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 — это динамические или статические ссылки?
Как определить, является ли ссылка динамической или статической?
Если ссылка атрибуции содержит параметры, это длинная предопределенная ссылка атрибуции и, следовательно, она является статической.
Динамическими являются только короткие URL-адреса, используемые для настраиваемых ссылок атрибуции.
Это означает, что после того, как вы начнете использовать ссылку атрибуции для интегрированного партнера или длинный 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 лучших метода оптимизации структуры ссылок и данных.