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

Для:

Последнее обновление: 20/09/2024 13:42

Вкратце: Узнайте о структуре и параметрах ссылок атрибуции 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
Обязательные параметры запроса	af_media_source af_campaign_id af_r
Другие параметры	См. все параметры
Структура 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 tizen roku webos vidaa playstation steam quest battlenet epic switch xbox nativepc	Строка
app_id	Идентификатор приложения	Параметр пути, указывающий идентификатор приложения, для которого вы публикуете. Пример: ap123456	Строка
af_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д-30д (дней) ИЛИ 1ч-23ч (часов). Проверка: Максимум 3 символа, используя схему выше. Значение по умолчанию — 24 часа для показов и 7 дней для кликов.	Строка
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 advertising_id fire пользовательский	Строка
af_device_id_value	Н/Д	Тип идентификатора устройства	Строка
af_r	Н/Д	Обязательный параметр Содержит ссылку на нужный магазин приложений или целевую страницу. Все данные внутри параметра af_r необходимо кодировать. Сюда входят любые значения параметров UTM, если они добавлены.	Строка

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

Окно лукбэк	При вероятностном моделировании используется фиксированное окно лукбэк длительностью 24 часа для кликов и показов. Значение af_lookback_window игнорируется.
Атрибуция агентства	Поток CTV-PC-Console на мобильный — поддерживается атрибуция агентства. Поток с мобильного на CTV-ПК-консоль — атрибуция агентства не поддерживается.