Структура и параметры ссылок отслеживания в AppsFlyer

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

Введение

Ссылки отслеживания используются в 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

Параметры ссылки отслеживания

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

 Примечание

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

Параметры Отображаемое имя Описание
pid Медиа-источник Название медиа-источника — предоставляется AppsFlyer его интегрированным партнерам, и его нельзя изменять. Подробнее.
c Кампания Название кампании — предоставляется рекламодателем или издателем. Названия кампаний, превышающие 60 символов, отображаются на панели управления как «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

Тип рекламы

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

search_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-адрес во всех операционных системах и платформах
af_web_dp Перенаправление пользователей ПК на другую веб-страницу вместо той, которая задана в шаблоне OneLink. Используется для получения данных атрибуции для пользователей ПК на других платформах (например, Google Analytics или Omniture).
af_dp Путь для действий в приложении, по которому пользователи направляются с помощью глубинной ссылки. Используется для глубинных ссылок и ретаргетинга
af_ios_fallback Задается альтернативный URL-адрес для пользователей iOS 10.3 
af_ref
Рекламные сети, в которых используются S2S-нажатия, могут отправлять уникальное значение реферера с помощью параметра &af_ref=ReferrerValue
 
Значение af_ref должно быть уникальным и иметь такую структуру:
NetworkName_UniqueClickValueForEachClick
 
 
is_incentivized true/false
Кампании искусственного мотивирования


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

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

advertising_id

Advertising ID

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

sha1_advertising_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.

Используется для перенаправления на целевые страницы

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 — это единственный параметр, который нужно ОБЯЗАТЕЛЬНО включать в каждую ссылку. 

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

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

Примеры идентификаторов некоторых важных интегрированных партнёров: 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

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

Ссылки отслеживания 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-адресе трекинговой ссылки не должна превышать 60 символов. Если длина названия кампании больше допустимой, вместо названия кампании используется строка c_name_exceeded_max_length
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 3 из 4