---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com/support/metrica/en/data/offline-params.md
  - https://yandex.com/support/metrica/es/data/offline-params.md
  - https://yandex.com/support/metrica/pt/data/offline-params.md
  - https://yandex.com/support/metrica/ru/data/offline-params.md
  - https://yandex.com/support/metrica/tr/data/offline-params.md
  - https://yandex.com/support/metrica/zh/data/offline-params.md
title: 导入离线数据
description: 当用户访问您的网站时，Yandex Metrica 会自动收集他们如何与网站页面互动以及他们在这些页面上执行的关键操作的数据。
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/metrica/zh/llms.txt


# 导入离线数据

当用户访问您的网站时，Yandex Metrica 会自动收集他们如何与网站页面互动以及他们在这些页面上执行的关键操作的数据。

然而，您的业务销售漏斗可能不仅仅限于网站上的操作，还可能包括电话呼叫、快递到货付款、与客户谈判后的签约、线下销售点的付款等。 此类操作（例如已付款订单、电话、即时通讯中的聊天）的数据可以发送到 Yandex Metrica，以便将客户在网站上的行为与他们的站外行为关联，并将这些数据用于广告投放。


## 您可以借助离线数据做什么 {#what}

发送离线数据可以帮助网站所有者解决广泛的任务。 以下是其中一些应用：


{% cut "构建端到端分析" %}


通过将离线操作数据发送至 Yandex Metrica（无论是实际销售还是来自 CRM 的交易阶段），您可以将其与用户在您网站上的在线历史记录关联，从而获得完整销售漏斗的分析。


{% endcut %}

{% cut "根据离线转化优化 Yandex Direct 中的广告" %}


为已确认的用户操作创建目标，并利用这些目标优化广告投放，以促成付费订单、签订合同、在收到您网站上的请求后进行付款或其他操作。


{% endcut %}

{% cut "创建细分" %}


根据离线数据和相似用户识别创建用户细分。 细分还可以包括在购买之前未访问过您网站的客户。


{% endcut %}

{% cut "获取更准确的数据" %}


尽量减少 Yandex Metrica 的数据与您的 CRM 系统或销售部门的信息之间的差异。 当您的客户通过采购在网站上付款但付款后没有返回网站（即没有访问“感谢您的订单”页面）时，离线转化也能提供帮助。


{% endcut %}

{% cut "对表单提交进行分类" %}


并非所有在网站上提交的表单和下达的订单都会导致付款。 发送“有效”提交的数据，以识别最有效的销售渠道。


{% endcut %}

{% cut "构建 ROPO 报表" %}


如果您有实体店，可以将这些店铺的销售数据发送至 Yandex Metrica，以衡量线上广告对线下销售的影响。


{% endcut %}



## 您可以发送哪些离线数据 {#data}

### 网站用户的离线转化 {#conversion}

您可以通过记录会话后发送的 JavaScript 事件类型的转化来补充有关用户会话的数据。 这使您可以对站外用户行为进行细分和分析，并在广告中使用准确反映业务指标的转化数据。

该方法基于 Yandex Metrica 通过传输的标识符搜索相应的用户会话，并将转化记录到该会话中。

要查找会话及其中的转化，您必须发送以下内容：

- **Yandex Metrica 中的用户标识符**：[ClientId](https://yandex.com/support/metrica/zh/general/clientid-userid.md)、UserId、[Yclid](https://yandex.com/support/metrica/zh/data/get-yclid.md) 或 PurchaseId。 这些标识符可以在网站会话期间获得。
- **目标 ID**。 定义用户会话中应实现的目标。 只有 [JavaScript 事件](https://yandex.ru/support/metrica/general/goal-js-event.html)类型的目标适合发送。 如果您已经有此类合适的目标，请使用它们。 否则，创建一个新目标。
- **转化的日期和时间**。 使用 [Unix 时间戳](http://www.unixtimestamp.com/index.php)格式将目标与特定用户会话相匹配。 Yandex Metrica 将搜索与您提供的日期最接近的会话匹配，以将转化关联到该会话。

此外，您还可以指定转化的值（收入）和使用的货币。 数据可以通过 Yandex Metrica 界面中的 CSV 文件发送，也可以使用 [API](https://yandex.ru/dev/metrika/doc/api2/practice/offline-conv.html) 传输。

[通过 Yandex Metrica 界面上传线下转化数据](https://yandex.com/support/metrica/zh/data/offline-conversion-data.md)

[使用 API 传输数据](https://tech.yandex.com/metrika/doc/api2/practice/offline-conv-docpage/)

### 有关 CRM 中的客户和订单的信息 {#crm}

这种格式使您可以访问 Yandex Metrica 中的以下数据：来自 CRM 的客户信息、他们与网站的互动、订单、这些订单的状态，以及有关转化和随订单发送的购买商品的数据。

发送有关客户和订单的数据可以帮助您根据高价值客户、订单中的特定产品、CRM 中的交易状态等创建细分。 此外，该格式还提供通过电子邮件和电话发送数据的功能，从而能够创建 ROPO 报表。

要使用此功能，您必须发送以下信息：

**客户信息**

 
:    
    - 您的 CRM 中的客户 ID。
    - 名称。
    - 您选择的附加参数。
    - Yandex Metrica 用来在计数器上查找会话的标识符（[`ClientId`](https://yandex.com/support/metrica/zh/general/clientid-userid.md)、`电话`、`电子邮件`、`phones_md5`、`emails_md5`）。


**订单（交易）**

 
:    
    - 您的 CRM 中的订单 ID。
    - 下单客户的 ID。
    - 订单时间。
    - 订单状态、收入和成本。
    
    根据传输的状态，转化将在订单匹配的会话中实现。 此外，您还可以发送订单中产品的数据。

要启用数据发送，请设置客户端标识符集合并将其保存在您的 CRM 中。 然后通过  或使用 上传有关客户和订单的数据。

您可以使用 Order sources from CRM 和 Sources, costs, and ROI 报表分析数据。


### 有关呼叫的信息 {#calls}

如果客户访问您的网站后经常通过电话确认信息、预约或确认订单，您可以跟踪这些呼叫并将其与用户在网站上的操作关联起来。

例如，您可以分析呼叫数量、呼叫质量以及最终结果（例如访问网站后进行购买）。

此外，发送呼叫信息可以让您使用基于传输呼叫数据特征的目标 — 例如，您可以为首次通话时长超过 5 分钟的呼叫设置目标，并在呼叫跟踪服务中用“Good Call”计数器标记。

第三方呼叫跟踪服务通常用于跟踪呼叫。 这通常要求您除了 Yandex Metrica 计数器之外，在网站上放置特殊的呼叫跟踪代码。 此代码会将网站上的电话号码替换为其他号码，从而使 Yandex Metrica 中的 [`ClientId`](https://yandex.com/support/metrica/zh/general/clientid-userid.md) 与用户呼叫的事实相关联。

因此，您可以根据呼叫特征或呼叫总数为网站上的用户会话设置完成某些转化的属性。 数据分析可以在“Call”报表组中进行，或通过在标准 Yandex Metrica 报表中选择呼叫目标来进行分析。

如果您的呼叫跟踪服务支持将呼叫发送到 CRM 系统，您可以在 Yandex Metrica 中跟踪呼叫的完整销售漏斗，除了呼叫信息外，还能通过 CRM 传输客户和订单信息。


## Yandex Metrica 如何将离线数据链接到会话 {#ids}

实施离线转化数据的发送需要您为网站上的关键事件（例如，填写潜在客户表单、下订单或拨打替代电话号码）保存一个或多个 Yandex Metrica 标识符。 这些标识符随后会用于发送数据。

为了将离线数据与您的网站用户及其会话关联，Yandex Metrica 使用以下标识符：


{% cut "ClientID" %} {#clientid}


由 Yandex Metrica 自动创建的独立网站用户 ID。 Cookie 中的 [_ym_uid](https://yandex.com/support/metrica/zh/general/cookie-usage.md) 值。

用于发送离线转化、呼叫、用户参数，以及来自 CRM 的客户和订单数据。 要获取标识符，请使用 getClientID 方法。

使用 `ClientId` 是将数据与会话匹配的最精确的方法。 这是离线数据的推荐参数。

`ClientId` 适用于所有离线数据传输格式 — 离线转化、CRM 数据和呼叫。


{% endcut %}

{% cut "UserID" %} {#userid}


网站所有者设置的用户 ID（例如，当网站用户登录其个人帐户时）。

如果您已经在网站上设置了用户标识符系统，并且在积极处理这些数据，可以使用 `UserID`。 如果您希望 Yandex Metrica 通过专用框架检测独立用户，则需要使用 setUserID 方法将 `UserID` 链接到 `ClientID`。

<!-- source: zh/_includes/objects/set-user-id/id-set-user-id/2.md -->
自定义 ID 仅会与在会话期间调用了 `setUserID` 方法的网站用户的 [ClientID](*ClientID) 相关联。
<!-- endsource: zh/_includes/objects/set-user-id/id-set-user-id/2.md -->


`UserID` 可用于发送离线转换和呼叫的数据。


{% endcut %}

{% cut "yclid" %} {#yclid}


由 Yandex Direct 分配的 Yandex Direct 广告的点击 ID。 如果您仅对发送离线数据以便在 Yandex 上进行推广感兴趣，请使用此标识符。

仅适用于发送离线转化和呼叫数据。 [通过 yclid 跟踪转化](https://yandex.com/support/metrica/zh/data/yclid.md)


{% endcut %}

{% cut "PurchaseId" %} {#purchaseid}


由网站所有者在购买商品时设置的电子商务购买标识符。

如果您需要通过附加信息补充购买目标，请使用 PurchaseId。 例如，如果客户在您的网站上进行购买时未完成全额付款，您可以发送 PurchaseId 来标识已付款订单。

PurchaseId 可用于发送离线转化数据。


{% endcut %}

{% cut "电子邮件（包括 MD5 散列算法）" %} {#email}


客户的电子邮件地址。 仅用于链接 CRM 中的客户数据和订单数据。 如果您在设置发送 [`ClientId`](https://yandex.com/support/metrica/zh/general/clientid-userid.md) 以及请求或购买时遇到困难，或者如果您从线下销售网点发送购买数据并希望查看您的流量的 ROPO 效果，这个标识符会很有用。

Yandex Metrica 不会以原始格式存储导入的电子邮件地址；这些地址在导入时即由 Yandex Metrica 进行哈希处理。

如果您自己对格式错误的电子邮件地址进行散列处理，Yandex Metrica 将无法确定转化与哪个会话相关。

您可以使用电子邮件地址 `mail@yandex.ru` 测试您的散列算法。 该地址的预期散列值为 `3c56ff8fef0f6c65b36b2d25720fe276`。

电子邮件地址仅在来自 CRM 的数据传输中可用。


{% endcut %}

{% cut "手机（包括 MD5 散列算法）" %} {#phones}


客户的电话号码。 仅用于链接 CRM 中的客户数据和订单数据。 与电子邮件地址类似，如果您在设置发送 [`ClientId`](https://yandex.com/support/metrica/zh/general/clientid-userid.md) 以及请求或购买时遇到困难，或者如果您从线下销售网点发送购买数据并希望查看您的流量的 ROPO 效果，这个标识符会很有用。

Yandex Metrica 不会以原始格式存储导入的电话号码；这些号码在导入时即由 Yandex Metrica 进行哈希处理。

如果您自己对格式错误的电话号码进行哈希处理，Yandex Metrica 将无法确定转化与哪个会话相关。

要检查您用于散列处理的算法，可以使用电话号码 `79995551111`。 此号码的预期散列值为 `f09f2c3d48f31e2a802944ade2e5aec5`。

电话号码仅在来自 CRM 的数据传输中可用。


{% endcut %}



## 将离线数据添加到会话的时间段 {#conversion-period}

**将离线数据添加到会话的时间段** 是指可以使用发送到 Yandex Metrica 的离线数据补充会话的间隔。

对于所有离线数据（离线转化、呼叫、CRM 订单），将离线数据添加到会话的期限为 21 天。 如果用户在网站上的最后一次会话与转化数据文件处理之间的时间间隔不超过 21 天，则数据将被添加到会话中。

来自 CRM 的订单还有一个延长的修改已添加到会话的订单的期限：您可以在添加此订单的会话之日起 111 天内修改此类订单的信息或将其添加到会话中。 当您需要在购买后更改转化收入或将转化状态从**进行中**更改为**已付款**时，这可能很有用。

**如果您使用不同的 ID，转化归因方法会有所不同：**

- **ClientID**、**UserID**、**电子邮件**和**电话**（包括散列）。 离线转化和呼叫会添加到之前的用户会话中。
    
    例如，用户有三个会话：3 月 1 日、3 月 5 日和 3 月 11 日。 在 3 月 10 日，此用户在一家零售店支付了订单，并且此日期已在 CRM 中统计。 在 3 月 20 日，经理将数据发送到 Yandex Metrica。 3 月 10 日支付的订单已添加到 3 月 5 日的客户网站会话中。
    
- **yclid**。 转化将添加到通过链接到已传输 `yclid` 的广告启动的会话中。

- **PurchaseId**。 转化将会添加到包含已传输标识符的电子商务购买所对应的会话中。
    


## 问题与解答 {#ganda}

**如果用户浏览了我的页面但进行了离线订购，是否可以跟踪转化？**

 
:   要跟踪这些转化，请将客户和订单数据（包括电子邮件地址或电话号码）从 CRM 传输到 Yandex Metrica。 如果您想要将网站会话与离线活动链接，则可以向用户显示独立促销代码，然后他们可以在商店中展示这些代码。

<!-- 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 -->

[*ClientID]: 由 Yandex Metrica 自动创建的独立网站用户 ID。