How can we help?

Прямые ссылки атрибуции для платформ 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-ПК-консоль — атрибуция агентства не поддерживается.

 

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: