Краткий обзор: Ссылки атрибуции предоставляют AppsFlyer данные об активности пользователей, касающиеся показов мобильной рекламы и кликов по ней. При клике по ссылке атрибуции пользователь перенаправляется в магазин для скачивания приложения, а копия URL-адреса, по которому кликнул пользователь, отправляется в AppsFlyer. AppsFlyer анализирует фрагменты ссылки и помещает данные в отчеты по необработанным данным.
Базовая ссылка атрибуции AppsFlyer
В базовой ссылке атрибуции содержится минимальное количество данных, необходимых для регистрации нажатия и перенаправления пользователя на страницу загрузки приложения. Для регистрации дополнительных данных можно добавить к ссылке соответствующие параметры после знака ?.
http://app.appsflyer.com/{app_id}
Базовая ссылка атрибуции содержит параметр {App_id} parameter, то есть ID приложения для Apple iTunes/App Store или имя пакета для Google Play.
Пример
http://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 |
Агентство |
Имя аккаунта агентства — позволяет атрибутировать агентству новые установки. Внимание: не используйте этот параметр, не убедившись, что Agency Permissions(Разрешения для агентства) активированы. |
Строка 50 |
|
af_mp |
Маркетинговый партнер |
Позволяет маркетинговым партнерам крупных издателей получать постбэки после каждой установки. Примечание: в настоящее время этот параметр применим только к маркетинговым партнерам Pinterest. |
|
|
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 (время от клика до установки) для нового пользователя, который будет атрибутирован с источником, отображающим рекламу или ссылку. |
Настраиваемое количество дней для периода ретроспективной атрибуции по кликам. Допустимые значения параметра: 1d–30d (дни) ИЛИ 1h–23h (часы). Значение по умолчанию: 7 дней. Примечание: применимо только для URL-адресов кликов и неприменимо для URL-адресов показов. |
До 3 символов |
|
af_viewthrough_lookback |
Окно ретроспективного обзора для атрибуции по просмотрам |
Настраиваемое количество дней для периода ретроспективной атрибуции по просмотрам. Допустимые значения параметра: 1h - 48h (часы) ИЛИ 1d - 7d (дни). Значение по умолчанию: 1d. Примечание: применимо только для URL-адресов показов и неприменимо для URL-адресов кликов. |
До 3 символов |
|
is_retargeting |
Это кампания ретаргетинга? |
Для ретаргетинговых кампаний все URL-адреса кликов должны содержать параметр |
Перечисление 5 символов |
|
af_reengagement_window |
Re-Engagement Window |
Добавление этого параметра в ссылку атрибуции позволяет изменить окно атрибуции повторного вовлечения. Возможные значения окна:
Значение по умолчанию: 30 дней Пример: если задать значение |
До 3 символов |
|
af_channel |
Канал |
Канал медиа-источника, через который распространяется реклама, например: UAC_Search, UAC_Display, Instagram, Facebook Audience Network и т. д. |
Динамическое перечисление Строка 20 |
|
af_keywords |
Ключевые слова |
Список ключевых слов для SMS кампаний. |
Строка 100 |
|
af_cost_model |
Модель затрат |
Модель затрат — в настоящее время поддерживается только модель CPI (по умолчанию), с помощью которой в AppsFlyer выполняется сбор данных о расходах для сводных отчетов, например, на обзорном дэшборде. |
Строка 20 |
|
af_cost_currency |
Валюта расходов |
Код валюты (например, USD, EUR). См. список всех допустимых кодов валюты. Значение по умолчанию: USD. |
Перечисление 3 символа |
|
af_cost_value |
Величина затрат |
Стоимость конверсии. Допустимый формат: до 4 знаков после десятичного разделителя. Важно!Можно задавать ТОЛЬКО цифры. Не добавляйте к цифрам символы денежных единиц или десятичные запятые (только точки), поскольку они не распознаются. Например, «56», «2.85» и т. д. |
Строка 20 |
|
af_sub1 |
Sub Param 1 |
Параметр подписчика 1: дополнительный собственный параметр, задаваемый рекламодателем. Дополнительные сведения об использовании этих параметров см. в разделе «Вопросы и ответы». |
Строка 100 |
| af_sub2 | Sub Param 2 | Параметр подписчика 2 | Строка 100 |
| af_sub3 | Sub Param 3 | Параметр подписчика 3 | Строка 100 |
| af_sub4 | Sub Param 4 | Параметр подписчика 4 | Строка 100 |
| af_sub5 | Sub Param 5 | Параметр подписчика 5 | Строка 100 |
| af_r | — | Перенаправление пользователей на указанный URL-адрес для обеих платформ (Android и iOS) | |
| af_web_dp | — | URL to redirect desktop users to a different web page than configured in the OneLink template. Use this to keep attribution data of desktop users on other platforms (e.g. Google Analytics or 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 |
Бонусные кампании (Incentivized) или кампании, не предлагающие бонус за совершение действия (non-incentivized)
|
|
| af_param_forwarding | Если задано значение "false", параметры ссылки атрибуции не пересылаются на страницу, указанную для перенаправления. |
Этот параметр можно использовать для "очистки" URL-адреса на странице перенаправления, или в тех случаях, когда параметры ссылки атрибуции могут вызвать проблемы в связи с обработкой параметров запроса на странице перенаправления.
|
*Для рекламы некоторых типов можно отправлять и соответствующий параметр просматриваемости с подробными характеристиками вовлечения. Ниже приведен список возможных значений параметра "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 получения данных о конверсиях.
Почему ID партнёра (PID) является самым важным параметром?
Среди всех доступных параметров ссылки атрибуции PID — это единственный параметр, который нужно ОБЯЗАТЕЛЬНО включать в каждую ссылку атрибуции.
ID издателя (PID) в действительности представляет собой имя медиа-источника. Это основное поле для атрибуции установки с ее источником.
Каждому из интегрированных партнеров AppsFlyer присваивается уникальный идентификатор PID, который заканчивается на "_int". При использовании настраиваемых ссылок атрибуции можно указывать любое имя PID, которое не было зарезервировано для интегрированных партнёров.
Примеры некоторых важных ID интегрированных издателей: organic, googleadwords_int (Google Adwords), Facebook ads, Twitter. Можно использовать любое имя для неинтегрированных источников, таких как электронная почта или SMS-сообщения.
Постарайтесь избежать следующих типичных проблем с 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Вопросы и ответы
Какие буквы нужно использовать в именах параметров — строчные или прописные?
Можно использовать любые буквы, однако формат имени должен быть единообразным. Задавая имя настраиваемого параметра прописными или строчными буквами, следите за тем, чтобы оно везде было указано именно в таком формате.
Например, если вы установили 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 лучших метода оптимизации структуры ссылок и данных.