Чем мы можем помочь?

Поиск

Прямые ссылки атрибуции для платформ CTV, ПК и консолей

  • Обновлено

Вкратце:  Узнайте о структуре и параметрах ссылок атрибуции AppsFlyer для платформ CTV, ПК и консолей. Примечание: Для приложений Android и iOS, включая игры Android для ПК, используйте инструкции по созданию мобильных ссылок атрибуции.

Обзор

Прямые ссылки атрибуции для платформ CTV, ПК и консолей позволяют рекламодателям перенаправлять пользователей и собирать данные после кликов. Эти прямые ссылки атрибуции — это ссылки AppsFlyer, поддерживающие перенаправление и атрибуцию для одного целевого приложения на одной платформе одновременно. Цель перенаправления указывается значением параметра af_r, включенного в ссылку. 

Примечание: Для приложений Android и iOS, включая игры Android для ПК, используйте инструкции по созданию мобильных ссылок атрибуции.

Ссылки атрибуции можно создать самостоятельно и размещать их в рекламе. Чтобы создать такие ссылки, следуйте инструкциям в этой статье.

Кроме того, ссылки можно создавать через S2S, используя API для вовлечения. Это требует работы разработчиков. Примечание: Ссылки, созданные через S2S, также могут собирать данные о показах.

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

Свойство Значения
Базовый URL-адрес engagements.appsflyer.com/v1.0/c2s/click/app/
Обязательные параметры пути
  • платформа
    Пример: steam
  • app_id
    Пример: 123456
Обязательные параметры запроса
  • media_source (медиа-источник)
  • af_campaign_id
Другие параметры См. все параметры
Структура URL-адреса https://engagements.appsflyer.com/v1.0/c2s/click/app/{platform}/{app_id}?af_media_source={media_source}&af_campaign_id={campaign_id}&af_r={app_store_url}
Пример URL-адреса https://engagements.appsflyer.com/v1.0/c2s/click/app/steam/123456?af_media_source=aloha&af_campaign_id=1234&af_r=https%3A%2F%2Fstore.steampowered.com%2Fapp%2F440%2FTest_app2%2F%3Futm_term%3Dhello

Параметры

Параметр Отображаемое имя в экспорте необработанных данных и Pull API Описание Тип поля
платформа платформа
  • Параметр пути, указывающий платформу приложения.
  • Возможные значения:
    • SmartCast
    • тизен
    • Roku
    • webOS
    • VIDAA
    • PlayStation
    • Steam
    • Quest
    • battlenet
    • epic
    • switch
    • xbox
    • Native PC 
 строка
app_id (идентификатор приложения) Идентификатор приложения
  • Параметр пути, указывающий идентификатор приложения, для которого вы публикуете.
  • Пример: ap123456
  • Не добавляйте префикс платформы к значению идентификатора приложения. Например, если идентификатор приложения ap123456, а платформа platformX, не используйте platformX_ap123456 в качестве значения app_id.
 строка
media_source (медиа-источник) Медиа-источник Уникальный идентификатор партнера, определенный на платформе AppsFlyer.
Следующие специальные символы не допускаются: ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, %.		 строка
af_campaign Кампания Название кампании строка
af_campaign_id Идентификатор кампании Идентификатор кампании строка
af_request_id Не применимо Идентификатор, который однозначно идентифицирует запрос партнера. строка
af_adset Группа объявлений Название группы объявлений строка
af_adset_id идентификатор группы объявлений идентификатор группы объявлений строка
af_ad Реклама Название рекламы строка
af_ad_id Идентификатор рекламы Идентификатор рекламы строка
af_campaign_type Тип кампании

Либо:

  • user_acquisition
  • ретаргетинг
 строка
af_prt Партнер
  • Имя аккаунта агентства, позволяющее атрибутировать установки к агентству
  • Внимание: Не используйте этот параметр, пока не проверите, что разрешения агентства включены.
 строка
af_siteid идентификатор сайта

Уникальный идентификатор издателя, показывающего рекламу

 строка
af_sub_siteid идентификатор подсайта

Идентификатор подсети рекламы или издателя

 строка
af_click_id Не применимо

Уникальный идентификатор транзакции рекламной сети

 строка
af_lookback_window Не применимо
  • Конфигурируемое количество дней/часов для периода окна атрибуции по кликам. Доступные ценности, значения параметров: 
    • Клики: 1 d–7 d (дней).
    • Показы: 1 d–7 d (дней) ИЛИ 1 h–23 h (часов).
  • Валидация: максимум 3 символа, используя схему выше.
  • Валидация: Максимум 3 символа, используя схему выше.
 строка
af_ad_placement Н/Д

Уникальный идентификатор транзакции рекламной сети

 строка
af_ad_type Тип рекламы
  • Тип рекламы. Используйте следующее соглашение об именовании:
    • текст: рекламный блок, содержащий только текст, например результат поиска
    • баннер: базовый формат, который отображается в верхней или нижней части экрана устройства
    • межстраничное объявление: полностраничное объявление, которое появляется во время перерывов в текущем опыте
    • видео: стандартное видео, без вознаграждения
    • rewarded_video: рекламный блок, предлагающий награды в приложении в обмен на просмотр видео
    • playable: рекламный блок, содержащий интерактивный предварительный просмотр приложения
    • аудио: аудиореклама
  • Чувствительность к регистру.
 строка
af_channel Канал

Канал медиа-источника, через который распространяется реклама, например UAC_Search, UAC_Display, Instagram, Meta Audience Network и т. д.

 строка
af_model Модель устройства

Модель устройства

 Строка 64
af_os_version Н/Д
  • Версия ОС устройства
  • Разрешены только цифры и точки
  • Пример: 8.1.0
 строка
af_device_id_type Н/Д

Тип идентификатора устройства. Либо:

  • VIDA
  • TIFA
  • rida
  • lgudid
  • fire
  • рекламный_идентификатор
  • fire
  • пользовательский
 строка
af_device_id_value Не применимо

Тип идентификатора устройства

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

Примечание: Проверьте, чтобы домен URL для af_r был включен в ваш список разрешенных перенаправлений.

 строка

Характеристики и ограничения

Атрибуция агентства
  • Поток CTV-PC-Console на мобильный — поддерживается атрибуция агентства.
  • Поток с мобильного на CTV-ПК-консоль — атрибуция агентства не поддерживается.

 

Связанный с