导入聊天
如果用户在与您的网站互动时更倾向于通过即时通讯工具（WhatsApp、Telegram 或 Viber）获取信息或下单，您可以通过聊天事件跟踪此类联系，并将其与用户在网站上的操作关联起来。
导入聊天可以帮助您：
- 了解您获得了多少次聊天转化。
- 评估其质量：例如，了解有多少聊天尚未得到回复。
- 评估结果。 例如，您可以查看某次对话是否促成了购买。
- 更全面地了解您与客户的互动情况，并查看促成即时通讯对话的广告渠道是否有效。
如何在 Yandex Metrica 中跟踪来电
要收集数据，请使用聊天跟踪服务或自定义解决方案，然后通过 API 将聊天数据传输到 Yandex Metrica。
备注
如果您使用自定义解决方案并通过 API 传输数据，您的网站必须具备并运行用于收集用户 ID（ClientID、UserID、Yclid、EPurchaseID）的系统，以便您将线下聊天与特定的网站会话关联起来。
Yandex Metrica 使用目标跟踪聊天：当您首次上传聊天转化数据时，服务会自动创建一个特殊的 Chat 目标。 随后，这个自动生成的目标会显示在 Yandex Metrica 界面的目标管理页面上。
您无需手动创建单独的目标：Yandex Metrica 会识别上传的聊天事件并开始统计转化量。
您可以将 Chat 目标添加到所有 Yandex Metrica 报表中。 您将能够查看此目标的转化指标（转化量、已达成目标数等）。 您还可以使用该目标及其转化量来优化广告，对该目标及其转化量进行调整，使其仅针对特定聊天触发，并添加此类新目标。
您可以传输哪些聊天数据
重要
上传的聊天数据会在 2 小时内显示在 Yandex Metrica 报表中。
您可以使用 API 或即时通讯工具跟踪服务，将聊天的基本信息和附加信息传输到 Yandex Metrica。 必填数据包括可让您按时间和即时通讯工具识别聊天事件的数据，以及对话的 ID。 此外，您还可以传输用于评估聊天质量和价值的指标。
有关可用数据及其在报表中的使用方式，请参阅下文。
聊天上传字段
|
信息 |
必填？ |
描述 |
|
聊天日期和时间（Unix 时间，UTC） |
是 |
用于记录聊天事件。 必须以 Unix 时间戳格式（UTC）指定。 |
|
聊天平台（即时通讯工具： |
是 |
即时通讯工具的名称。 可接受的值： |
|
聊天 ID（用户名、ID、电话号码） |
是（至少一个 ID） |
以下字段中至少必须填写一项： |
|
聊天回复情况（用户是否收到回复） |
否 |
记录客服人员是否对聊天作出了回复。 值： |
|
聊天标签 |
否 |
最多 100 个字符的文本标签。 用于聊天细分。 |
|
转化金额（聊天价值）和货币 |
否 |
使用它传输聊天的收入数据：一个数值和一个 ISO 4217 货币代码。 |
|
发起聊天的网站页面 URL |
否 |
用户发起对话的页面 URL。 |
|
来自即时通讯工具跟踪服务的链接 |
否 |
用于内部分析的跟踪系统中聊天的技术链接。 |
如何传输聊天数据
有两种方式可执行集成：
-
使用聊天跟踪服务
供应商会提供一段代码，例如小部件或脚本，您可将其添加到您的网站中。 该代码片段会自动收集所需的 ID，并准备导入 Yandex Metrica 的事件。
-
直接通过 API
对于此方法，请遵循以下建议。
第 1 步. 收集用户 ID
Goal：确保聊天链接到网站会话或广告点击。
-
如果您使用聊天跟踪服务
只需安装提供给您的代码片段。 它会自动检索所需的 ID 并将其传输到 Yandex Metrica，其中包括：
- ClientID，来自
_ym_uid。 - UserID（如果需要）。
- Yclid，用于来自 Yandex Direct 的流量。
- ClientID，来自
-
如果您使用自定义集成
请传输以下一个或多个 ID：
- ClientID：Yandex Metrica 中用户的主要标识符。 如果聊天源自网站会话，我们建议您发送该信息。
- UserID：您的内部用户 ID（如果启用了 UserID 功能）。
- Yclid：Yandex Direct 中使用的点击 ID。 当用户直接前往即时通讯工具而未访问网站时，此项非常有用。
- PurchaseID：聊天与特定交易相关联时使用的订单 ID。 这是一种很少见的情况。
如果未传输任何 ID，则上传的事件会被视为未归因，且不会关联到任何会话或点击。
第 2 步. 向即时通讯工具链接添加您自己的聊天 ID
Goal：在发起新对话时，将聊天明确匹配到步骤 1 中的 Yandex Metrica ID。
我们建议采用以下算法，该算法由聊天跟踪服务使用，也适用于自定义集成：
-
生成唯一的聊天 ID。 例如：
CT8F2A9。 -
安装在您网站上的代码片段会将此 ID 添加到每个即时通讯工具链接中：
- Telegram bot：通过深度链接（启动参数）。 用户不会看到该 ID，但机器人会在首次被联系时收到它。
- Telegram、WhatsApp 或 Viber 中的个人账户：通过预先填入该 ID 的首条消息模板。 例如，可以将该 ID 作为技术标签传递在消息末尾。
-
对话开始后，服务会从深度链接或首条消息中检索聊天 ID，并将其与先前收集的 Yandex Metrica ID 进行 匹配：
ClientID、UserID、Yclid。 -
然后，服务会建立起 chat-ID ↔ Yandex Metrica IDs 之间的强关联，这足以实现正确归因。
第 3 步. 将事件导入 Yandex Metrica
建立链接后，您可以开始通过 Yandex Metrica 聊天导入 API传输聊天事件。 数据格式要求（如事件时间、可接受的平台值、字段结构等）已在 API 规范中说明。