Краткий обзор. В статье описаны структура и параметры ссылки атрибуции в AppsFlyer.
Обзор
Ссылки атрибуции позволяют рекламодателям собирать данные о взаимодействии пользователей с рекламой. Ссылки атрибуции размещаются в рекламных объявлениях и уведомляют AppsFlyer, когда пользователи взаимодействуют с рекламой. Взаимодействие может происходить через клик по объявлению или когда пользователь видит рекламу. Копия URL-адреса атрибуции отправляется в AppsFlyer.
Ссылки атрибуции создаются с помощью OneLink или одноплатформенной ссылки.
OneLink (многоплатформенная ссылка) | Одноплатформенная ссылка | |
---|---|---|
Описание и когда использовать |
Используйте, когда:
|
Используйте, когда:
|
Необходимые условия |
Нет | |
Обязательная информация |
||
Базовый URL |
{subdomain}.onelink.me |
app.appsflyer.com |
Уникальный идентификатор |
ID шаблона |
app_id |
Структура URL | https://{subdomain}.onelink.me/ |
|
Пример | https://yourbrand.onelink.me/aAB1?pid=greatnetwork_int |
https://app.appsflyer.com/com.greatapp?pid=greatnetwork_int& |
Параметры ссылки атрибуции
- Указанные параметры доступны для использования в ссылке атрибуции.
- Значение в столбце Тип поля — это максимальное количество символов в значении параметра. Об ограничениях длины значений параметров читайте здесь.
Параметры ссылки атрибуции — UA и ретаргетинг
Следующую таблицу можно скачать как файл CSV
.
Параметр | Отображаемое имя в сырых данных | Описание |
Тип и длина поля |
---|---|---|---|
pid | Медиа-источник | Уникальный идентификатор для интегрированного партнера AppsFlyer. Не изменяйте его. Подробнее. |
Строка 150 |
c | Кампания | Предоставляется рекламодателем или издателем. См. ограничения на названия кампаний. |
Строка 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, Meta 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). Примечание. Если у вас есть список разрешенных адресов переадресации, убедитесь, что в нем присутствует домен этого URL-адреса. |
|
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_base_params_forward | — |
|
|
af_partner_account_id | Идентификатор учетной записи сети | Идентификатор учетной записи рекламодателя у партнера | Строка 100 |
redirect | — | Если &redirect=false , этот параметр сообщает AppsFlyer, что это клик S2S и что партнер отвечает за перенаправление пользователя, который кликнул. |
|
af_ua | Агент пользователя |
Относится к рекламным сетям, передающим клики и показы от сервера к серверу. Строка агента пользователя, переданная как:
Агент пользователя должен быть идентичен в параметре URL-адреса и заголовка HTTP. Примечание. В Android иногда сокращается до Client Hints. Его все равно нужно отправить.
|
|
af_ip | IP |
Относится к рекламным сетям, передающим клики и показы от сервера к серверу. IP-адрес устройства Рекомендуется: если возможно, укажите IP устройства как параметр af_ip. Следующий вариант: если возможно, AppsFlyer будет использовать IP-адрес из X-Forwarded-For. |
|
[Устарело] af_os | Версия ОС |
[Только для iOS] Версия операционной системы устройства. Этот параметр устарел, но по-прежнему поддерживается AppsFlyer. Рекомендуется: используйте вместо него параметр af_os_version. |
|
af_os_version | Версия ОС |
|
|
af_model | Модель устройства |
|
|
af_media_type | Тип медиа |
Размещение объявления со ссылкой выполняется следующим образом:
|
|
deep_link_sub1-10 | — |
Дополнительные значения диплинка. Разработчики реализуют желаемое поведение значений в коде. |
|
deep_link_value | — |
Имя для определенного контента в приложении, на который будут перенаправлены пользователи. Разработчики реализуют желаемое поведение deep_link_value в коде. |
|
af_og_title | — |
При публикации ссылки в социальной сети тег заголовка Open Graph (OG) используется для формирования превью заголовка. |
Строка 40 |
af_og_description | — |
При публикации ссылки в социальной сети тег описания Open Graph (OG) используется для формирования превью описания. |
Строка 300 |
af_og_image | — |
При публикации ссылки в социальной сети тег изображения Open Graph (OG) используется для формирования превью изображения. |
Параметры ссылки атрибуции — только ретаргетинг
Параметр | Отображаемое имя в сырых данных | Описание |
Тип и ширина поля |
---|---|---|---|
is_retargeting |
Is Retargeting (campaign) | Для ретаргетинговых кампаний все URL-адреса кликов должны содержать параметр &is_retargeting=true .Если этот параметр отсутствует или имеет значение «false», кампания считается обычной кампанией по привлечению пользователей. |
Перечисление 5 символов |
af_reengagement_window |
Окно повторного вовлечения |
Добавление этого параметра в ссылку атрибуции позволяет изменить окно атрибуции повторного вовлечения. Возможные значения окна:
Значение по умолчанию: 30 дней Пример: если задать значение |
— |
Параметры типа рекламы
Для рекламы некоторых типов можно отправлять и соответствующий параметр просматриваемости с подробными характеристиками вовлечения. Ниже приведен список возможных значений параметра "af_ad_type" вместе с параметрами ожидаемой просматриваемости.
Тип объявления (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. Используется для сторонних магазинов приложений. Примечание. Если у вас есть список разрешенных адресов переадресации, убедитесь, что в нем присутствует домен этого URL-адреса. |
|
sha1_el |
— |
Используется для атрибуции пользователей настольных и мобильных устройств — электронные сообщения, хэшированные по алгоритму SHA1. Требуется поддержка рекламной сети |
|
fire_advertising_id |
— |
Рекламный идентификатор Amazon Fire |
|
af_android_store_csl |
store_product_page |
Настраиваемый листинг в Google Console |
строка |
Параметры для iOS
Параметры | Отображаемое имя | Описание |
---|---|---|
idfa |
IDFA |
Используйте верхний регистр. Требуется поддержка рекламной сети Тип поля: не более 40 символов |
idfv |
IDFV | Используйте верхний регистр. |
af_ios_url |
Используйте для перенаправления на целевые страницы, чтобы перенаправить пользователей iOS (iPhone или iPad) на URL-адрес, отличный от страницы приложения в iTunes. Примечание. Если у вас есть список разрешенных адресов переадресации, убедитесь, что в нем присутствует домен этого URL-адреса. |
|
af_ios_store_cpp | store_product_page |
Идентификатор настраиваемой страницы продукта (ppid) |
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 является обязательным. PID — это уникальный идентификатор медиа-источника, присвоенный ему AppsFlyer.
Каждый интегрированный партнер имеет уникальное значение идентификатора PID. PID заканчивается суффиксом _int . При использовании ссылок OneLink вы можете задать для PID любое значение, не зарезервированное интегрированным партнером. Чтобы избежать конфликтов, не используйте суффикс _int.
Примеры важных ID интегрированных издателей: organic, googleadwords_int (Google Adwords), Meta Ads, Twitter. Для неинтегрированных источников, таких как электронная почта, СМС и даже голубиная почта, можно использовать любые имена.
Постарайтесь избежать типичных проблем с PID:
- Обязательно включайте PID в ссылки атрибуции. Если в ссылке атрибуции нет параметра PID, пользователь автоматически атрибутируется медиа-источнику None (Нет), а реальный источник установки не учитывается.
- Не используйте PID интегрированных партнеров для собственных медиа-источников. Для каждого интегрированного источника используйте только назначенный PID, чтобы обеспечить правильную атрибуцию его установок. Для любого пользовательского медиа-источника (например, эл. почты, SMS-сообщений или даже бесплатной рассылки в Facebook) используйте значения PID, отличные от интегрированных.
-
Используйте только допустимые символы. Если параметр PID в ссылке атрибуции содержит один из этих символов /<>*&?\
- Клик или установка будут показаны на дэшборде в разделе af_invalid_param.
- Ссылки атрибуции не будут работать.
- Возможности диплинкинга не будут работать для кликов
Совет
Старайтесь не включать пробелы в значение PID или же выполните URL-кодирование ссылок атрибуции, прежде чем их использовать.
Параметр «Идентификатор сайта»
ID сайта — это уникальный идентификатор издателя, разместившего рекламу, т. е. сайта или приложения, в котором показывается реклама. Рекламные сети присваивают уникальный ID сайта каждому издателю.
Этот идентификатор указывается в параметре af_siteid
, который передается в 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
Ограничения и особенности
Специфика | Примечания |
---|---|
Специальные символы |
В параметрах и значениях не допускаются следующие специальные символы: ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, % |
Лимит по количеству символов в URL |
Общая длина URL-адреса не должна превышать 2000 символов. |
Переадресация по диплинкам в приложениях соцсетей для Android с Webview |
Подробности об ограничениях см. здесь |
Какие буквы нужно использовать в именах параметров — строчные или прописные?
Можно использовать любые буквы, однако формат имени должен быть единообразным. Задавая имя настраиваемого параметра прописными или строчными буквами, следите за тем, чтобы оно везде было указано именно в таком формате.
Например, если вы установили 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
для всех синих объявлений во ВСЕХ медиа-источниках без самостоятельной атрибуции. То же самое она сделала для желтых и красных объявлений. Получив проанализированные и сырые данные, Линда сможет сравнить эффективность объявлений разного цвета и выбрать шаблон, который дает больше всего конверсий.
Какие ограничения есть для названий кампаний?
- Длина названия кампании в URL ссылки атрибуции ограничена 100 символами. Если превышено, название кампании будет изменено на:
c_name_overeded_max_length
- Название кампании не должно начинаться или заканчиваться пробелом, так как это может привести к расхождениям в дэшбордах и отчетах.