---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.1
alternate:
  - https://yandex.com/support/metrica/en/data/chat.md
  - https://yandex.com/support/metrica/es/data/chat.md
  - https://yandex.com/support/metrica/pt/data/chat.md
  - https://yandex.com/support/metrica/ru/data/chat.md
  - https://yandex.com/support/metrica/tr/data/chat.md
  - https://yandex.com/support/metrica/zh/data/chat.md
  - href: zh/data/chat.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: 导入聊天
description: 如果用户在与您的网站互动时更倾向于通过即时通讯工具（WhatsApp、Telegram 或 Viber）获取信息或下单，您可以通过聊天事件跟踪此类联系，并将其与用户在网站上的操作关联起来。
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/metrica/zh/llms.txt


# 导入聊天

如果用户在与您的网站互动时更倾向于通过即时通讯工具（WhatsApp、Telegram 或 Viber）获取信息或下单，您可以通过聊天事件跟踪此类联系，并将其与用户在网站上的操作关联起来。 

导入聊天可以帮助您：

- 了解您获得了多少次聊天转化。
- 评估其质量：例如，了解有多少聊天尚未得到回复。
- 评估结果。 例如，您可以查看某次对话是否促成了购买。
- 更全面地了解您与客户的互动情况，并查看促成即时通讯对话的广告渠道是否有效。

## 如何在 Yandex Metrica 中跟踪来电 {#follow}

要收集数据，请使用[聊天跟踪服务](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)或自定义解决方案，然后通过 [API](https://yandex.com/dev/metrika/ru/data-import/) 将聊天数据传输到 Yandex Metrica。 

{% note info %}

如果您使用自定义解决方案并通过 API 传输数据，您的网站必须具备并运行用于收集用户 ID（`ClientID`、`UserID`、`Yclid`、`EPurchaseID`）的系统，以便您将线下聊天与特定的网站会话关联起来。

{% endnote %}

Yandex Metrica 使用[目标](https://yandex.com/support/metrica/zh/general/goals.md)跟踪聊天：当您首次上传聊天转化数据时，服务会自动创建一个特殊的 **Chat** 目标。 随后，这个自动生成的目标会显示在 Yandex Metrica 界面的目标管理页面上。 


您无需手动创建单独的目标：Yandex Metrica 会识别上传的聊天事件并开始统计转化量。 

您可以将 **Chat** 目标添加到所有 Yandex Metrica 报表中。 您将能够查看此目标的转化指标（转化量、已达成目标数等）。 您还可以使用该目标及其转化量来优化广告，对该目标及其转化量进行调整，使其仅针对特定聊天触发，并添加此类新目标。 

## 您可以传输哪些聊天数据 {#info}

{% note warning %}

上传的聊天数据会在 3 小时内显示在 Yandex Metrica 报表中。

{% endnote %}

您可以使用 API 或[即时通讯工具跟踪服务](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)，将聊天的基本信息和附加信息传输到 Yandex Metrica。 必填数据包括可让您按时间和即时通讯工具识别聊天事件的数据，以及对话的 ID。 此外，您还可以传输用于评估聊天质量和价值的指标。 

有关可用数据及其在报表中的使用方式，请参阅下文。

**聊天上传字段**

#|
|| **信息** | **必填？** | **描述** ||
|| 聊天日期和时间（Unix 时间，UTC） | 是 | 用于记录聊天事件。 必须以 Unix 时间戳格式（UTC）指定。 ||
|| 聊天平台（即时通讯工具：`whatsapp`、`telegram`、`viber`） | 是 | 即时通讯工具的名称。 可接受的值：`whatsapp`、`telegram` 和 `viber`。 ||
|| 聊天 ID（用户名、ID、电话号码） | 是（至少一个 ID） | 以下字段中至少必须填写一项：`ChatUsername`、`ChatUserID` 或 `PhoneNumber`。 ||
|| 聊天回复情况（用户是否收到回复） | 否 | 记录客服人员是否对聊天作出了回复。 值：`1` 或 `0`。 ||
|| 聊天标签 | 否 | 最多 100 个字符的文本标签。 用于聊天细分。 ||
|| 转化金额（聊天价值）和货币 | 否 | 使用它传输聊天的收入数据：一个数值和一个 ISO 4217 货币代码。 ||
|| 发起聊天的网站页面 URL | 否 | 用户发起对话的页面 URL。 ||
|| 来自即时通讯工具跟踪服务的链接 | 否 | 用于内部分析的跟踪系统中聊天的技术链接。 ||
|#

## 如何传输聊天数据 {#how-send}

有两种方式可执行集成：

- **使用[聊天跟踪服务](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)** 
  
  供应商会提供一段代码，例如小部件或脚本，您可将其添加到您的网站中。 该代码片段会自动收集所需的 ID，并准备导入 Yandex Metrica 的事件。

- **直接通过 API**
   
  对于此方法，请遵循以下建议。

### 第 1 步. 收集用户 ID {#step-1}

**Goal**：确保聊天链接到网站会话或广告点击。

- **如果您使用[聊天跟踪服务](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)** 

  只需安装提供给您的代码片段。 它会自动检索所需的 ID 并将其传输到 Yandex Metrica，其中包括：
  
  - **ClientID**，来自 `_ym_uid`。 
  - **UserID**（如果需要）。 
  - **Yclid**，用于来自 Yandex Direct 的流量。

- **如果您使用自定义集成**

  请传输以下一个或多个 ID：

  - **ClientID**：Yandex Metrica 中用户的主要标识符。 如果聊天源自网站会话，我们建议您发送该信息。
  - **UserID**：您的内部用户 ID（如果启用了 UserID 功能）。
  - **Yclid**：Yandex Direct 中使用的点击 ID。 当用户直接前往即时通讯工具而未访问网站时，此项非常有用。
  - **PurchaseID**：聊天与特定交易相关联时使用的订单 ID。 这是一种很少见的情况。

如果未传输任何 ID，则上传的事件会被视为**未归因**，且不会关联到任何会话或点击。

### 第 2 步. 向即时通讯工具链接添加您自己的聊天 ID {#step-2}

**Goal**：在发起新对话时，将聊天明确匹配到步骤 1 中的 Yandex Metrica ID。

我们建议采用以下算法，该算法由[聊天跟踪服务](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)使用，也适用于自定义集成：

1. 生成**唯一的聊天 ID**。 例如：`CT8F2A9`。

2. 安装在您网站上的代码片段会**将此 ID 添加到每个即时通讯工具链接中：**

   - **Telegram bot**：通过深度链接（启动参数）。 用户不会看到该 ID，但机器人会在首次被联系时收到它。
   - **Telegram、WhatsApp 或 Viber 中的个人账户**：通过预先填入该 ID 的**首条消息模板**。 例如，可以将该 ID 作为技术标签传递在消息末尾。

3. 对话开始后，服务会从深度链接或首条消息中检索聊天 ID，并将其与先前收集的 Yandex Metrica ID 进行 **匹配**：`ClientID`、`UserID`、`Yclid`。

4. 然后，服务会建立起 **chat-ID ↔ Yandex Metrica IDs** 之间的强关联，这足以实现正确归因。

### 第 3 步. 将事件导入 Yandex Metrica {#step-3}

建立链接后，您可以开始通过 [Yandex Metrica 聊天导入 API](https://yandex.com/dev/metrika/ru/management/chats)传输聊天事件。 数据格式要求（如事件时间、可接受的平台值、字段结构等）已在 API 规范中说明。 

<!-- source: zh/_includes/buttons/chat-button.md -->
[与我们聊天](https://yandex.com/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}

<!-- source: zh/_includes/styles/href-to-button.md -->

<!-- endsource: zh/_includes/styles/href-to-button.md -->
<!-- endsource: zh/_includes/buttons/chat-button.md -->

<!-- source: zh/_includes/reports/support-button.md -->
[联系我们](https://yandex-ad.cn/contact){.button}


<!-- source: zh/_includes/styles/cut-button.md -->

<!-- endsource: zh/_includes/styles/cut-button.md -->

<!-- source: zh/_includes/styles/href-to-button.md -->

<!-- endsource: zh/_includes/styles/href-to-button.md -->
<!-- endsource: zh/_includes/reports/support-button.md -->

<!-- source: zh/_includes/footer-links.md -->
- - -

<div class="borderless-table">

#|
||
实用链接

- [演示计数器](https://metrica.yandex.com/r/dashboard?)
- [添加计数器](https://metrica.yandex.com/add/)
- [免费计数器设置](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&utm_medium=cpc&utm_campaign=1)
- [Yandex Metrica API](https://tech.yandex.com/metrika/)
- [提出您的想法](https://yandex.com/support/metrica/troubleshooting/idea.html)
|
线上培训



- [参加培训课程](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)

||
|#

</div>

<!-- source: zh/_includes/styles/table-style.md -->

<!-- endsource: zh/_includes/styles/table-style.md -->
<!-- endsource: zh/_includes/footer-links.md -->

<!-- source: zh/_includes/styles/border-style.md -->

<!-- endsource: zh/_includes/styles/border-style.md -->