Вкратце: Узнайте о структуре и параметрах ссылок атрибуции AppsFlyer.
Обзор
Ссылки атрибуции позволяют рекламодателям собирать данные о вовлечении пользователей с рекламой. Ссылки атрибуции добавляются к рекламе и уведомляют AppsFlyer, когда пользователи взаимодействуют с рекламой. Вовлечение может происходить через клик по рекламе или при просмотре показов рекламы. Копия URL-адреса атрибуции отправляется в AppsFlyer.
Ссылки атрибуции создаются с помощью OneLink или одноплатформенной ссылки.
OneLink (многоплатформенная ссылка) | Одноплатформенная ссылка | |
---|---|---|
Описание и когда использовать |
Используйте, когда:
|
Используйте, когда:
|
Предпосылки | Шаблон 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 | Не применимо |
|
|
clickid | Не применимо | Уникальный идентификатор клика рекламной сети | |
af_siteid | 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_ad_format | Формат рекламы | Используйте следующие соглашения об именовании:
|
|
af_click_lookback | Окно атрибуции |
|
3 символа максимум. |
af_viewthrough_lookback |
Не применимо |
|
3 символа максимум. |
af_channel | Канал | Канал медиа-источника, через который распространяется реклама, например, UAC_Search, UAC_Display, Instagram, Meta Audience Network и т. д. | Динамическое перечисление. Строка 20 |
af_keywords | Ключевые слова | Список ключевых слов для текстовых кампаний. | Строка 100 |
af_cost_model | Модель стоимости |
|
Строка 20 |
af_cost_currency | Валюта стоимости |
|
Перечисление. 3 символа |
af_cost_value | Ценность стоимости |
|
Строка 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 | Не применимо |
|
|
af_base_params_forward | Не применимо |
|
|
af_partner_account_id | Идентификатор аккаунта сети | Идентификатор аккаунта рекламодателя у партнера | Строка 100 |
перенаправление | Не применимо | Когда&redirect=false этот параметр дает знать AppsFlyer, что это S2S-клик и что партнер несет ответственность за перенаправление пользователя, который кликнул. |
|
af_ua | User-agent |
Актуально для рекламных сетей, которые отправляют клики и показы с сервера на сервер. Строка User-agent отправляется как:
User-Agent должен быть одинаковым как в параметре URL-адреса, так и в заголовке HTTP. Примечание: В Android строка user-agent иногда сокращается из-за клиентских подсказок. Она должна быть отправлена в любом случае.
|
|
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 | Ретаргетинг (кампания) | Клик URL-адрес всех ретаргетинговых кампаний должен включать &is_retargeting=true .Если параметр не включен или его значение равно «false», кампания считается обычной кампанией по привлечению пользователей. |
Перечисление 5 символов |
af_reengagement_window | Окно повторного вовлечения |
Измените окно атрибуции повторного вовлечения, добавив этот параметр в ссылку атрибуции. Возможные варианты диапазона окна:
Значение по умолчанию: 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
Две важные вещи, которые следует знать о пользовательских параметрах:
- Пользовательские параметры не отображаются в необработанных данных.
- Пользовательские параметры можно извлечь из API SDK получения данных о конверсии.
Параметр идентификатор партнера (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 после перехода по ссылке атрибуции:
Это происходит из-за того, что ссылка атрибуции содержит символ #. Например:
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-адреса не должна превышать 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 | Подробности ограничения можно узнать здесь |