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

Вкратце:  Узнайте о структуре и параметрах ссылок атрибуции AppsFlyer.

Обзор

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

Ссылки атрибуции создаются с помощью OneLink или одноплатформенной ссылки.

  OneLink (многоплатформенная ссылка) Одноплатформенная ссылка
Описание и когда использовать

Используйте, когда:

  • Вам нужна единая ссылка для всех платформ.
  • Требуются возможности диплинкинга.
  • Для открытия приложения вы хотите использовать Android App Links или глобальные ссылки iOS.

Узнать больше о OneLink

Используйте, когда:

  • Вы используете только одну платформу. Например, Android, а не iOS.
  • Для открытия приложения используются только схемы URI.

Узнать больше о том, как создать интегрированного партнера

Предпосылки Шаблон OneLink Нет
Обязательная информация
Базовый URL-адрес {поддомен}.onelink.me app.appsflyer.com
Уникальный идентификатор Идентификатор шаблона app_id
Структура URL-адреса https://{subdomain}.onelink.me/
{templateid}?pid={media_source}
&af_siteid={ApplicationID}
&c={CampaignName}
https://app.appsflyer.com/{app_id}?pid={media_source}&af_siteid={ApplicationID}&c={CampaignName}
Пример https://yourbrand.onelink.me/aAB1?pid=greatnetwork_int
&c=GreatCampaign&af_siteid=A1b1
https://app.appsflyer.com/com.greatapp?pid=greatnetwork_int&
c=GreatCampaign&af_siteid=A1b1

 Важно!

Для входящего трафика взаимодействия, т.е. кликов и показов, AppsFlyer поддерживает только протокол HTTPS.

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

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

Параметры ссылки атрибуции — UA и ретаргетинг

Следующую таблицу можно скачать как файл.

Параметр Отображаемое имя в необработанных данных Описание Тип и длина поля
pid Медиа-источник Уникальный идентификатор интегрированного партнера AppsFlyer. Не изменяйте его. Подробнее. Строка 150
c Кампания Предоставляется рекламодателем или издателем. См. ограничения на названия кампаний. Строка 100
af_prt Партнер
  • Имя учетной записи агентства позволяет атрибутировать установки к агентству
  • Внимание: Не используйте этот параметр, пока не убедитесь, что разрешения агентства включены.
Строка 50
af_mp Не применимо
  • Включить отправку постбэков маркетинговым партнером издателя за каждую установку.
  • Примечание: В настоящее время этот параметр актуален только для маркетинговых партнеров Pinterest.
 
clickid Не применимо Уникальный идентификатор клика рекламной сети  
af_siteid ID сайта
  • Уникальный идентификатор, определяющий издателя, показывающего рекламу. Узнать больше
Строка 24
af_sub_siteid ID подсайта
  • ID подсети/издателя. 
  • Если в дополнение к основному издателю (ID сайта) существует субиздатель, или вы хотите включить дополнительную информацию, такую как тип/размещение рекламы в приложении, например баннер, межстраничная реклама, видео и т.д., используйте af_sub_siteid. Например: af_sub_siteid =ABCD_4567
Строка 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 Тип рекламы  Используйте следующие соглашения об именовании:
  • нативная реклама: Платные медиа, разработанные с учётом содержания медиа-источника. Эти медиа разработаны с учётом визуального оформления и функций естественного контента и отображаются в вашей ленте рекомендуемых видео.
  • баннер: Рекламные объявления, которые обычно представляют собой небольшие прямоугольные рекламные блоки, появляющиеся в различных местах веб-страницы или интерфейса приложения. 
  • межстраничная реклама: Полноэкранные объявления, покрывающие весь интерфейс хост-приложения. Эти рекламные объявления предназначены для показа между контентом и обычно отображаются в точках перехода в потоке приложения, например, между действиями или уровнями игры, а также во время паузы.
  • видео с вознаграждением: Реклама, которую пользователи могут просмотреть полностью в обмен на внутреннее вознаграждение — например, просмотр видео ради дополнительной жизни в игре, доступ к статье или доступ к Wi-Fi в аэропорту. Такая «вознаграждаемая» реклама привлекает пользователей и улучшает общий опыт приложения.
  • аудио: Реклама в аудиоформате, предлагающаяся в онлайн-подкастах или на платформах потоковой передачи музыки.
  • Offerwall (офферы): Внутренний рекламный блок, который разработчики используют для монетизации своих приложений. Он функционирует как мини-магазин в приложении, предлагая множество «офферов», которые пользователи могут выполнить для получения внутреннего вознаграждения.
Строка 24
af_ad_format Формат рекламы  Используйте следующие соглашения об именовании:
  • текст: Текстовая реклама, которая обычно отображается в виде короткого фрагмента текста. Оно может включать заголовок, описание, а также ссылку или призыв к действию, чтобы вызвать интерес и побудить клик на веб-сайт или целевую страницу.
  • изображение: Визуальная реклама, демонстрирующая продукт, услугу или бренд с помощью графики или фотографий. Обычно она включает в себя привлекательное изображение и краткий текст, а также может содержать призыв к действию.
  • видео: Цифровая реклама, использующая аудиовизуальный контент для передачи маркетингового сообщения. Она может иметь разную продолжительность и может появляться в начале, в середине или в конце видеоконтента в интернете либо быть отдельными видеороликами на различных платформах.
  • игровое: Интерактивная реклама, позволяющая пользователям взаимодействовать с мини-версией игры или приложения перед загрузкой или покупкой. Она дает пользователям возможность ощутить реальный игровой процесс или функционал приложения.
  • интерактивная: Интерактивная и динамичная реклама, побуждающая пользователей к взаимодействию или участию. Это могут быть викторины, опросы или другие интерактивные элементы, которые привлекают внимание пользователей и стимулируют их активное участие.
  • динамический_продукт: Персонализированный формат рекламы, который динамически заполняется информацией о продукте на основе поведения пользователя, его предпочтений или истории просмотров. Он позволяет рекламодателям отображать высокорелевантные и специально адаптированные рекламные объявления о продуктах для отдельных пользователей.
  • карусель: Формат рекламы, состоящий из нескольких слайдов или карточек в рамках одной рекламы. Каждая карточка может содержать отдельное изображение, заголовок и описание, позволяя рекламодателям демонстрировать несколько продуктов или функций в одной рекламе.
 
af_click_lookback Окно атрибуции
  • Окно атрибуции по кликам. Длительность этого окна — это максимальный CTIT (время от клика до установки), в течение которого новый пользователь будет отнесен к источнику, отображающему рекламу или ссылку.
  • Конфигурируемое количество дней для периода окна атрибуции по кликам. Доступные ценности, значения параметров: 1д - 30д (дней) ИЛИ 1ч-23ч (часов). Ценность, значение по умолчанию — 7 дней.
  • Окно атрибуции может быть настроено для OneLinks и SRN.
Примечание: Влияет только на URL-адреса кликов, но не на URL-адреса показов.
3 символа максимум.
af_viewthrough_lookback
Не применимо
  • Настраиваемое количество часов для окна атрибуции по просмотрам. Доступные ценности, значения параметров: 1ч - 24ч (часов). Ценность, значение по умолчанию — 24 часа.
  • Окно атрибуции можно настроить для SRN.
Примечание: Влияет только на URL-адреса показов, но не на URL-адреса кликов.
3 символа максимум.
af_channel Канал Канал медиа-источника, через который распространяется реклама, например, UAC_Search, UAC_Display, Instagram, Meta Audience Network и т. д. Динамическое перечисление. Строка 20
af_keywords Ключевые слова Список ключевых слов для текстовых кампаний. Строка 100
af_cost_model Модель стоимости
  • Модель стоимости CPI (Плата за установку) (по умолчанию), в настоящее время является единственной поддерживаемой моделью при отчетности о стоимости по кликам, которая заполняет ценность, значение стоимости в отчетах по агрегированным данным AppsFlyer.
  • По возможности, отчет о стоимости через API. В случаях, когда стоимость сообщается как по ссылке, так и через API - приоритет отдается API.
Строка 20
af_cost_currency Валюта стоимости
  • Трехбуквенный код валюты, соответствующий ISO-4217. Например, USD, ZAR, EUR
  • [По умолчанию]: USD
Перечисление. 3 символа 
af_cost_value Ценность стоимости
  • Ценность стоимости, выраженное в используемой валюте.
  • До 4 знаков после десятичной точки.
  • Задайте ТОЛЬКО числовые значения (при необходимости используйте десятичную точку). Пример: "56", "2.85"
Строка 20

af_sub[n] 

(n=1-5) пример: af_sub1

Подпараметр [n] Необязательный пользовательский параметр, определяемый рекламодателем. Для получения дополнительной информации об использовании этих параметров, смотрите раздел Характеристики и ограничения. Строка 100
af_r Не применимо

Применяется для перенаправления пользователей на указанный URL-адрес на всех платформах (Android, iOS и ПК).

В многоплатформенных ссылках (OneLink) этот параметр:

  • Переопределяет настройку перенаправления на уровне шаблона
  • Переопределяется следующими параметрами уровня ссылки:

Примечание: см. дополнительные характеристики и ограничения параметров перенаправления.

 
af_web_dp Не применимо

URL-адрес для перенаправления пользователей настольных компьютеров (например, Windows или Mac) на другую веб-страницу, отличную от настроенной в шаблоне OneLink. Используйте это для сохранения данных атрибуции пользователей настольных компьютеров на других платформах (например, Google Analytics или Omniture).

Примечание: см. дополнительные характеристики и ограничения параметров перенаправления.

 
af_dp Не применимо

Резервное значение схемы URI для запуска приложения, используется в случае сбоя метода глобальных ссылок или Android App Link или для пользователей Android ниже версии 6.0. Он должен указывать только на базовый путь, то есть стандартную активность.

Примечание: Если вы используете значение веб-URL для этого параметра (не рекомендуется), обязательно ознакомьтесь с характеристиками и ограничениями параметра перенаправления.

 
af_force_deeplink Не применимо Принудительный диплинкинг в активность, указанную в значении af_dp.  
af_ref Не применимо
Рекламные сети, работающие с кликами S2S, могут отправлять уникальное значение реферера, используя следующий параметр: &af_ref=ReferrerValue
Значение af_ref должно состоять из уникального значения, сформированного следующим образом:
NetworkName_UniqueClickValueForEachClick
Пример: af_ref=networkname_123456789ABCDEF
 
Имя сети может быть любой допустимой строкой. Это может быть networkname_int или просто название сети.
 
AppsFlyer может использовать этот параметр для Атрибуции на устройствах Android. AppsFlyer не использует этот параметр для Атрибуции на устройствах под управлением iOS или Windows.
 
is_incentivized Не применимо
Логический: true/false
Стимулирующие или нестимулирующие кампании
 
af_param_forwarding Не применимо
  • Если задано значение false, параметры, указанные в ссылке Атрибуции, не передаются на редиректную страницу.
  • использовать это для создания более чистого URL-адреса на редиректной странице или если параметры ссылки Атрибуции могут вызвать проблемы из-за обработки параметров запроса на редиректной странице.
 
af_base_params_forward Не применимо
  • Если задано значение false, параметры AppsFlyer PID и C, находящиеся в ссылке Атрибуции, не перенаправляются на редиректную страницу.
  • использовать это, если URL-адрес будет кликнут с рабочего стола и вы хотите сохранить основные параметры CRM, но удалить параметры AppsFlyer PID и C. Это позволит избежать наличия нескольких PID в URL-адресе.
 
af_partner_account_id Идентификатор аккаунта сети Идентификатор аккаунта рекламодателя у партнера Строка 100
перенаправление Не применимо Когда&redirect=false этот параметр дает знать AppsFlyer, что это S2S-клик и что партнер несет ответственность за перенаправление пользователя, который кликнул.  
af_ua User-agent

Актуально для рекламных сетей, которые отправляют клики и показы с сервера на сервер.

Строка User-agent отправляется как:

  1. Параметр URL-адреса (кодированного в URL)
  2. Заголовок HTTP-запроса (некодированного)

User-Agent должен быть одинаковым как в параметре URL-адреса, так и в заголовке HTTP.

Примечание: В Android строка user-agent иногда сокращается из-за клиентских подсказок. Она должна быть отправлена в любом случае.

  • Пример полного user-agent: Mozilla/5.0 (Linux; Android 12; Pixel 5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.16 Mobile Safari/537.36
  • Пример сокращенного user-agent: Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.0.0 Mobile Safari/537.36
 
af_ip IP

Актуально для рекламных сетей, которые отправляют клики и показы с сервера на сервер.

IP адрес устройства

Рекомендация: Если возможно, предоставьте IP адрес устройства в параметре af_ip.

Следующая опция: Если доступно, AppsFlyer будет использовать IP в X-Forwarded-For.

 
[Устаревшее] af_os Версия ОС

[Только для iOS] Версия операционной системы устройства.

Этот параметр устарел, но всё ещё поддерживается AppsFlyer. Рекомендуется: Используйте параметр af_os_version вместо этого. 

 
af_os_version Версия ОС
  • Актуально для рекламных сетей, которые отправляют клики и показы с сервера на сервер.
  • Версия операционной системы устройства.
    • Android:
      • Пример: 12
      • Для сокращенных пользовательских агентов (из-за браузеров на настольных компьютерах или Android и использующих движок Chrome 110+), рекламная сеть должна использовать Client Hints API, чтобы получить это значение.
      • Для пользовательского агента, который не сокращен, используйте следующее регулярное выражение для извлечения версии ОС Android из строки user-agent: .
    • iOS:
      • Пример: 16.2
 
af_model Модель устройства
  • Актуально для рекламных сетей, которые отправляют клики и показы с сервера на сервер.
  • Модель устройства.
    •  Android:
      • Пример: Pixel 5
      • Для сокращенных пользовательских агентов (из-за браузеров на настольных компьютерах или Android и использующих движок Chrome 110+), рекламная сеть должна использовать Client Hints API, чтобы получить это значение.
      • Для пользовательского агента, который не сокращен, используйте следующее регулярное выражение для извлечения модели Android из строки user-agent: .
    • iOS:
      • Либо iphone, либо ipad (все строчные буквы)
 
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 Ретаргетинг (кампания)  Клик URL-адрес всех ретаргетинговых кампаний должен включать &is_retargeting=true.
Если параметр не включен или его значение равно «false», кампания считается обычной кампанией по привлечению пользователей.
Перечисление 5 символов
af_reengagement_window Окно повторного вовлечения

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

Возможные варианты диапазона окна:

  • Дни: 1-90 или Часы 1-36
  • Срок действия: Это означает, что окно повторного вовлечения не ограничено. Пример: &af_reengagement_window=lifetime

Значение по умолчанию: 30 дней

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

Не применимо

Параметры видимости

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

Параметр Формат ценности, значения Описание
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 Рекламный идентификатор Рекламный идентификатор Google — требуется поддержка рекламной сети Максимум 40 символов
sha1_advertising_id Не применимо Рекламный идентификатор Google, хешированный с помощью SHA1 — требуется поддержка рекламной сети  
md5_advertising_id Не применимо Рекламный идентификатор Google, хешированный с помощью MD5 — требуется поддержка рекламной сети Поддерживается только для установок и повторных атрибуций
android_id Android ID Устройство Android_id — требуется поддержка рекламной сети Максимум 20 символов
sha1_android_id Не применимо Устройство Android_id, хешированный с помощью SHA1 — требуется поддержка рекламной сети  
md5_android_id Не применимо Устройство Android_id, хешированный с помощью MD5 — требуется поддержка рекламной сети Поддерживается только для установок и повторных атрибуций
imei IMEI Идентификатор устройства IMEI  
sha1_imei Не применимо Идентификатор IMEI, хешированный с помощью SHA1 — требуется поддержка рекламной сети  
md5_imei Не применимо Идентификатор IMEI, хешированный с помощью 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. Использовать для сторонних магазинов приложений.

Примечание: см. дополнительные характеристики и ограничения параметров перенаправления.

 
sha1_el Не применимо Используется для мобильной атрибуции при переходе с настольных компьютеров — электронная почта, электронное сообщение хэшируется с помощью SHA1. Требуется поддержка рекламной сети  
fire_advertising_id Не применимо Рекламный идентификатор Amazon Fire  
af_android_store_csl страница_Продукта_магазина Пользовательский список магазина в Google Console строка

iOS-специфичные параметры

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

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

Тип поля: Максимум 40 символов

IDFV IDFV Использовать заглавные буквы. 
af_ios_url  

Использовать для перенаправления целевых страниц, чтобы перенаправлять пользователей iOS (iPhone или iPad) на другой URL-адрес, отличный от страницы Приложения в iTunes.

Примечание: см. дополнительные характеристики и ограничения параметров перенаправления.

af_ios_store_cpp страница_Продукта_магазина

Пользовательский идентификатор страницы Продукта (ppid)

Примечание: В необработанных данных и агрегированной отчетности значение параметра af_ios_store_cpp (пользовательский идентификатор страницы Продукта) регистрируется для кликов, но не для показов.

af_ios_fallback [устарело] Не применимо Устарело: Пользователи перенаправляются на основе потока схемы iOS URI
sha1_idfa Не применимо IDFA хэшируется с помощью SHA1. Требуется поддержка рекламной сети
sha1_idfv Не применимо IDFV хэшируется с помощью SHA1
mac Не применимо MAC-адрес устройства. Требуется поддержка рекламной сети
md5_idfa Не применимо IDFA хэширован с помощью MD5
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

Две важные вещи, которые следует знать о пользовательских параметрах:

Параметр идентификатор партнера (PID)

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

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

Примеры важных интегрированных зарезервированных идентификаторов издателей: organic, googleadwords_int (Google AdWords), facebook_int (Meta ads) и twitter_int (X Ads). Для неинтегрированных источников, таких как электронная почта, СМС и даже голубиная почта, можно использовать любые имена.

Избегайте распространенных проблем с PID:

  • Всегда включайте PID в ссылки атрибуции. Без PID в ссылке атрибуции пользователь автоматически приписывается медиа-источнику «Нет», и исходный источник установки исчезает.
  • Для пользовательских источников используйте PID неинтегрированных партнеров. Для каждого интегрированного источника используйте только назначенный PID для корректной атрибуции установок. Для любого пользовательского медиа-источника, например, электронной почты, СМС или вирусных бесплатных публикаций на Facebook, используйте другие, неинтегрированные значения PID.
  • Используйте только разрешенные символы. Если параметр PID в ссылке атрибуции содержит один из следующих символов \/<>&*?\
    • Клик или установка отобразятся в дэшборде под af_invalid_param
    • Ссылки атрибуции не будут приписаны.
    • Возможности диплинкинга не будут работать для кликов.

Совет

Избегайте использования пробелов в значении PID или обязательно кодируйте URL-адрес ваших ссылок атрибуции перед их использованием.

Параметр идентификатор сайта

Идентификатор сайта — это уникальный идентификатор издателя, размещающего рекламу. Другими словами, это веб-сайт или приложение, отображающее рекламу. Рекламные сети выделяют уникальные идентификаторы сайтов для каждого издателя. 

Этот идентификатор включен в параметр af_siteid, переданный в AppsFlyer через ссылку атрибуции, и доступен через различные панели мониторинга, отчетность и постбеки. 

Идентификатор сайта необходимо передать в AppsFlyer через ссылку атрибуции, потому что он:

  • Обеспечивает ясность и прозрачность в отношении издателя
  • Используется AppsFlyer для выявления и устранения мошеннических издателей и других кластеров трафика.

Параметр идентификатора сайта включает только идентификатор издателя, размещающего рекламу.

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

Пример

Следующая ссылка атрибуции включает:

  • af_siteid (идентификатор сайта): Идентификатор издателя
  • af_sub_siteid (идентификатор подсайта): Дополнительная информация об идентификаторе (в данном случае — аффилированный источник и тип размещения рекламы)

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 = Тип размещения рекламы в приложении, например, баннер, межстраничное или видео

Часто задаваемые вопросы: Почему трафик приводит к большому количеству заблокированных установок?

Заблокированные установки могут быть вызваны следующими причинами:

  • Отсутствует идентификатор сайта: Параметр af_siteid в URL-адресе клика пуст. Отправка с пустым идентификатором сайта указывает либо на техническую проблему, либо на намеренную попытку обойти механизмы обнаружения мошенничества.
  • Несколько идентификаторов сайтов: Один и тот же издатель отправляется по нескольким URL-адресам кликов с использованием разных идентификаторов сайтов. Это считается мошенническим поведением, которое маскирует реальную активность издателя и часто связано с клик-флудингом.
  • Идентификатор сайта отформатирован неправильно: Неправильный формат в сочетании с другими признаками мошенничества может привести к блокировке не только конкретного издателя, но и кластера более высокого уровня, и может воздействовать на большие объемы партнерской активности.

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

Уровни детализации данных

Вы можете использовать до четырех параметров URL-адреса, чтобы глубже изучить эффективность вашей рекламы.

Используя все 4 параметра во всех ваших активных ссылках атрибуции, вы можете:

  • Атрибутировать все установки пользователей и события к определенной рекламе
  • Детализировать и сравнивать эффективность всей вашей рекламы по наборам объявлений, кампаниям и медиа-источникам на агрегированных отчетах для оптимизации на каждом уровне.
  • Сравнивать всю вашу рекламу по всем медиа-источникам в отчетах о необработанных данных и сводной таблице

Параметры следующие:

  • Media source (pid=)
  • campaign name (c=)
  • Ad set (af_adset=)
  • Ad name (af_ad=)

Пример

Следующая ссылка атрибуции использует 4 уровня детализации для записи рекламы "кашемир" в наборе объявлений "пальто" в кампании "зима", работающей на интегрированном медиа-источнике "сеть".

https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmere

Часто задаваемые вопросы

Следует ли использовать строчные или заглавные буквы для параметров?

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

Например, если вы установили pid=MyMediaSource, убедитесь, что всегда используете его. Если вы используете pid=MyMediaSource в одной ссылке атрибуции и pid=mymediasource в другой, могут возникнуть расхождения в данных. То же самое относится и к любому другому параметру, установленному для ссылки атрибуции.

Ссылка атрибуции AppsFlyer - динамическая или статическая?

Ссылки атрибуции могут быть динамическими или статическими.
Как определить, является ли ссылка динамической или статической?
Если ссылка атрибуции содержит параметры, она является длинной предопределенной и, следовательно, статической.
Только короткие URL-адреса (например, yourbrand.onelink.me/HaT8/r5c2b371), используемые для пользовательских ссылок атрибуции, являются динамическими.
Это означает, что как только вы начнете использовать ссылку Атрибуции для интегрированного партнера или длинный 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_sub2, ..., af_sub_5, можно использовать для записи любых полезных KPI. Эти параметры анализируются и отображаются в отчете о необработанных данных, что делает их очень удобными для агрегации или фильтрации данных.

Пример

Приложение для заказа такси Luber предлагает креативы с тремя цветовыми шаблонами: синим, желтым и красным. Мобильный маркетолог Luber, Линда, хочет проверить, какой цветовой шаблон принесет больше установок. Для этого она добавляет &af_sub3=blue в ссылки атрибуции всех синих реклам во всех медиа, не относящихся к SRN. То же самое делается для желтых и красных реклам. Проанализировав эту информацию и отобразив ее в отчетах о необработанных данных, Линда может оценить успешность различных цветных реклам и выбрать наиболее конвертирующую.

Какие ограничения существуют на названия кампаний?

  • Максимальная длина названия кампании в URL-адресе атрибуции ограничена 100 символами. При превышении название кампании меняется на: c_name_exceeded_max_length
  • Название кампании не должно начинаться с пробела или заканчиваться им, так как это может привести к расхождениям в панелях мониторинга и отчетах.

Особенности и ограничения

Особенности Замечания
Специальные символы  Следующие специальные символы не допускаются в ключах и значениях параметров (не применимо к параметрам redirect и af_dp):  ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, %
Параметры перенаправления
  • Убедитесь, что домены ваших URL-адресов перенаправления добавлены в ваш список разрешенных перенаправлений.
  • Значение перенаправления должно быть полным действительным веб-URL (https://[домен][необязательный-путь]) в соответствии со стандартами RFC 1738;
  • Идентификаторы фрагментов URI не поддерживаются в URL-адресах перенаправления (например, #webpagesection, который прокручивает пользователей вниз к конкретному разделу статьи). 
Ограничение количества символов в URL-адресе  Общая длина URL-адреса не должна превышать 2000 символов.
Переадресация диплинков в WebView социальных приложений Android Подробности ограничения можно узнать здесь
Диплинкинг не поддерживается в приложении Android Naver Blog Диплинкинг не поддерживается в приложении Android Naver Blog. Пользователи будут перенаправлены в магазин Google Play или на веб-страницу, указанную в ссылке.
При нажатии на ссылку URI-схемы в браузере Chrome на iOS появляется всплывающее окно Из-за изменений в Chrome iOS, при нажатии пользователем на ссылку URI-схемы в Chrome на iOS, появляется всплывающее окно, предлагающее пользователю подтвердить открытие приложения или переход в App Store.
Требования к допустимости URI-схемы Мы рекомендуем использовать допустимую URI-схему, соответствующую RFC 3986. Схемы, которые не соответствуют указанным требованиям, могут не открывать приложение и вызывать ошибку при переходе из веб-просмотра или других веб-сред.
Атрибуция WebView в Telegram Подробности ограничения можно узнать здесь