---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://appmetrica.yandex.by/docs/en/mobile-tracking/ctv-desktop-attribution.md
- https://appmetrica.yandex.by/docs/ru/mobile-tracking/ctv-desktop-attribution.md
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/ru/llms.txt
# CTV/Desktop-атрибуция
В AppMetrica доступна технология атрибуции кампаний продвижения на устройствах Connected TV (CTV), Desktop-устройствах и игровых консолях. Это позволяет учитывать влияние объявлений, показанных на CTV/Desktop устройствах, на установки мобильного приложения.
Атрибуция выполняется по технологии IP-matching: мобильное устройство и CTV/Desktop-устройство должны находиться в одной сети, то есть иметь общий внешний IP-адрес в момент показа объявления и установки приложения.
Для сопоставления мобильного и CTV/Desktop-устройства используется вероятностный алгоритм, см. [Probabilistic Matching](https://appmetrica.yandex.by/docs/ru/mobile-tracking/technology.md#device-fingerprint-matching).
## Условия атрибуции по показам {#conditions}
Установки атрибутируются к CTV/Desktop-показам при следующих условиях:
- CTV/Desktop-показ произошел в рамках окна атрибуции — не ранее 24 часов до момента установки.
- Если было найдено несколько CTV/Desktop-показов — установка будет отнесена к последнему.
- По умолчанию клики и показы на том же устройстве имеют приоритет перед CTV/Desktop-показами. Но если в трекере включена опция **Равный приоритет для CTV/Desktop**, то в рамках заданного окна равного приоритета установка будет отнесена к наиболее близкому взаимодействию, независимо от типа источника.
- Отправку CTV/Desktop-показов в AppMetrica необходимо настроить в рекламной сети, используя специальную ссылку **Impression url**, полученную при настройке трекера. В трекере должна быть активирована опция **Аттрибуция по CTV/Desktop**. Дополнительные настройки в AppMetrica не потребуются.
## Настройка трекинга {#setup}
Процесс настройки CTV/Desktop-атрибуции аналогичен настройке атрибуции по кликам и заключается в [создании трекера](https://appmetrica.yandex.by/docs/ru/mobile-tracking/add-tracker.md). Особенности процедуры настройки:
1. При создании трекера на этапе [настройки атрибуции](https://appmetrica.yandex.by/docs/ru/mobile-tracking/add-tracker.md#attribution) включите опцию **Атрибуция по CTV/Desktop** и укажите окно атрибуции для CTV и/или Desktop-устройств.
1. На этапе [настройки постбеков](https://appmetrica.yandex.by/docs/ru/mobile-tracking/add-tracker.md#postbacks) для отправки типа атрибуции в рекламную сеть используйте макрос `{attributed_touch_type}` со значением `impression`. Это позволит рекламной сети лучше оптимизироваться и отображать корректную статистику.
1. При настройке кампании в рекламной сети вместо трекинг-ссылки используется ссылка для отправки показов [Impression URL](https://appmetrica.yandex.by/docs/ru/mobile-tracking/add-tracker.md#apply). В ссылке можно использовать дополнительные [параметры](https://appmetrica.yandex.by/docs/ru/mobile-tracking/tracking-specification.md).
1. Если приложение использует отдельные [API key](https://appmetrica.yandex.by/docs/ru/settings/general.md) для разных операционных систем, настройте для них отдельные трекеры и передайте партнеру обе ссылки. Партнеру в момент показа нужно перейти по обеим ссылкам.
В трекерах для CTV/Desktop-атрибуции доступна [проверка на фрод](https://appmetrica.yandex.by/docs/ru/common/fraud-score.md).
## Оценка результатов {#result}
**Отчеты**
: Используйте отчет [User Acquisition](https://appmetrica.yandex.by/docs/ru/mobile-reports/user-acquisition-report.md). Установки, атрибутированные к CTV/Desktop-показам, отображаются в общей статистике аналогично остальным. В параметрах установки хранятся данные соответствующего показа.
Для оценки дополнительного эффекта атрибуции по CTV/Desktop-показам используйте группировку **Тип атрибуции**.
**Сегментация**
: Детализация каждой установки фиксируется в соответствии с атриубтированным показом — партнер, трекер и параметры установки. Для фильтрации данных при [сегментации](https://appmetrica.yandex.by/docs/ru/mobile-reports/segmentation.md) вы можете использовать параметр **Тип атрибуции**.
**Проверка на фрод**
: Проверка CTV/Desktop на фрод доступна в интеграции с [FraudScore](https://appmetrica.yandex.by/docs/ru/common/fraud-score.md).
## Для рекламных сетей / паблишеров {#adv}
CTV/Desktop-атрибуция основана на событиях, переданных рекламной сетью. События доступны в трекинге, только если s2s-интеграция реализована корректно со стороны рекламной сети:
- Интеграция настроена в соответствии с документацией.
- При отправке запросов используется метод `GET`.
- В запросе передаются все обязательные параметры.
- Для параметров соблюдаются требуемый формат и кодировка.
Если условия не соблюдаются, атрибутировать события невозможно.
[Примеры корректных запросов](https://appmetrica.yandex.by/docs/ru/mobile-tracking/s2s.md#example).
{% note info "" %}
Если продвигаемое приложение использует отдельные [API key](https://appmetrica.yandex.by/docs/ru/settings/general.md) для разных операционных систем и для них настроены отдельные трекеры, то в момент показа необходимо передавать информацию о показе по обоим трекерам.
{% endnote %}
Параметры impression URL:
#|
||
**Параметр** | **Обязательный** | **Пример** | **Описание**
||
||
`device_ip` | Да | device_ip=192.0.2.0/24 | URL-encoded IP адрес устройства пользователя. Поддерживаются IPv4 и IPv6.
||
||
`device_type` | Да| device_type=DESKTOP | Тип устройства. Возможные значения:
- `TV`
- `DESKTOP`
- `CONSOLE`
- `UNKNOWN` (для нестандартных устройств)
Если `device_type` указан неверно, атрибутировать CTV/Desktop-показ невозможно.
||
||
`click_timestamp` | Да | click_timestamp=1453895044 | UTC timestamp клика в секундах. Если параметр не передан, используется время получения показа на серверах AppMetrica.
||
|#
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.
Написать в службу поддержки
Предложить улучшение для документации