---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/mobile-tracking/ctv-desktop-attribution.md
  - https://boost.yandex.com/doc/ru/analytics/content/mobile-tracking/ctv-desktop-attribution.md
  - https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/ctv-desktop-attribution.md
  - href: https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/ctv-desktop-attribution.md
    type: text/markdown
    title: Markdown version
  - href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21876058
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21876058

# CTV/桌面归因

Analytics module 支持为通过连接式电视（CTV）、台式电脑和游戏主机进行的促销活动进行归因。 你可以用这来评估CTV和桌面设备上显示的广告对移动应用安装的影响。

归因过程依赖于 IP 匹配技术，这要求在广告展示和应用安装时，移动设备与CTV或台式机处于同一网络并共享相同的外部IP地址。

系统通过[概率匹配](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/technology.md#device-fingerprint-matching)识别跨移动设备、CTV 和台式机的同一用户。

## 展示归因条件 {#conditions}

安装会归因于CTV或桌面展示，在以下条件下：

- CTV 或桌面展示发生在归因窗口内（不早于安装前 24 小时）。
- 如果发现多个CTV或桌面端展示，则安装归因于最新的展示。
- 默认情况下，同一设备上的点击和展示优先于CTV/桌面展示。 但如果追踪器中启用了**CTV/Desktop 等级优先**选项，那么在指定的等级优先窗口内，安装将归属于最近的交互，无论源类型是什么。
- 转到广告网络，并将CTV和桌面展示投放到Analytics module，使用在设置跟踪器时获取的特殊**Impression URL**。 确保跟踪器已启用**CTV/桌面归因**。 无需在 Analytics module 中设置额外参数。

## 设置跟踪 {#setup}

CTV 和桌面归因的设置过程与点击归因类似，涉及 [创建跟踪器](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/add-tracker.md)。 设置过程：

1. 在创建跟踪器的[归因设置](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/add-tracker.md#attribution)阶段，启用**CTV/桌面归因**选项，并为CTV设备和桌面设置归因窗口。

1. 在[回传设置](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/add-tracker.md#postbacks)阶段，使用`{attributed_touch_type}`宏，并将其值设为`impression`，以将归因类型发送到广告网络。 这有助于广告网络更好地优化并显示更准确的统计数据。

1. 在广告网络中设置广告投放时，请使用[展示URL](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/add-tracker.md#apply)而不是跟踪链接。 您可以在 URL 中添加额外的[参数](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/tracking-specification.md)。

1. 如果应用程序为不同操作系统使用不同的[API 密钥](https://boost.yandex.com/doc/zh/analytics/content/settings/general.md)，请为它们配置不同的跟踪器，并将两个链接提供给合作伙伴。 伙伴需要在显示时点击两条链接。


## 评估结果 {#result}

**报告**
:   使用[用户获取](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/user-acquisition-report.md)报告。 CTV 和桌面广告展示带来的安装量会与其他安装量一样显示在总体统计中。 安装数据存储在属性展示参数中。

    要分析CTV和桌面广告展示归因的影响，请使用**归因类型**维度。

**分段**
:   每次安装都与其对应的展现相关联——包括伙伴、跟踪器和安装参数。 在 [分段](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/segmentation.md) 期间进行数据过滤，请使用 **归因类型** 参数。


## 广告网络（出版商） {#adv}

CTV/桌面归因基于广告网络传输的事件。 事件仅在广告网络正确实现 s2s 集成时才可用于跟踪：

- 集成根据文档进行配置。
- 在发送请求时使用 `GET` 方法。
- 请求中已传递所有必需参数。
- 参数符合要求的格式和编码。

如果这些条件未满足，就无法归因事件。

[正确请求的示例](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/s2s.md#example).

{% note info "" %}

如果被推广的应用为不同操作系统使用单独的[API 密钥](https://boost.yandex.com/doc/zh/analytics/content/settings/general.md)，并且为它们配置了单独的跟踪器，那么在展示广告时，必须通过两个跟踪器传输展示信息。 

{% endnote %}

展现 URL 参数：

#|
||
**参数** | **必需** | **示例** | **描述**
||
||
`设备IP` | Yes | device_ip=192.0.2.0/24 | URL编码的用户设备IP地址。 IPv4 和 IPv6 都受支持。
||
||
`device_type` | Yes| device_type=桌面 | 设备类型。 可能的值：

- `TV`
- `桌面`
- `控制台`
- `未知`（用于非标准设备）

如果指定的`device_type`不正确，CTV 或桌面展示无法归属。

||
||
`click_timestamp` | Yes | click_timestamp=1453895044 | UTC 点击时间戳（以秒为单位）。 如果省略该参数，则使用Analytics module服务器接收到展现的时间。
||
|#

<!-- source: zh/analytics/content/_includes/feedback-button.md -->
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

<a href="../troubleshooting/feedback-new">
  <span class="button">联系支持</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">为文档提出改进建议</span>
</a>
<!-- endsource: zh/analytics/content/_includes/feedback-button.md -->