启用 1C-Bitrix 模块

Yandex Metrica 团队开发了一个官方免费模块，用于在网站上安装 Web 分析计数器。该模块运行在 1C-Bitrix 18.0 及更高版本上，并支持所有“1C-Bitrix: Site Management”版本。

“Yandex Metrica”模块功能：

添加默认启用以下选项的新 Yandex Metrica 计数器：
- E-commerce。
- Session Replay。
- Click map。
传输 E-commerce 事件：
- 查看项目配置文件。
- 将商品添加到购物篮。
- 从购物篮中删除商品。
- 进行购买。
提供已传输产品数据的详细信息。

安装和设置模块

入门

如果您还没有 Yandex Metrica 计数器，则创建一个。确保在计数器设置中指定了正确的网站 URL。要检查这一点，请转到 Yandex Metrica Settings 页面。注意 Address 字段值：该字段应显示您要安装模块的网站的 URL。
In the tag settings, enable the E-commerce option. A container for collecting data from dataLayer will be added to the code snippet by default.
确保 1C-Bitrix 中没有激活安装 Yandex Metrica 计数器的类似模块。在管理面板中，打开 Marketplace → Solutions installed，搜索名为“Yandex Metrica”、“Metrica”或“Metrika”的模块。如果有，请将其删除。

第 1 步. 安装模块

转至 1C-Bitrix 管理面板，登录并使用以下方法之一添加模块：

通过管理面板

打开 Marketplace → Solutions installed，找到名为“Yandex Metrica”的模块。
点击图标并选择 Install now。

Via 1C-Bitrix: Marketplace

转到 1C-Bitrix: Marketplace，并找到名为“Yandex Metrica”的模块。
打开模块并点击 Install。

使用 ZIP 归档

下载带有 UTF8 或者 CP1251 编码的安装 ZIP 归档。
转到 1C-Bitrix 管理面板（在 Content 页面上）。
选择 Files and folders → bitrix → modules 部分并打开模块列表的最后一页。
点击 Upload → Add file 并选择包含 Yandex Metrica 模块的 ZIP 归档。
点击 Save。归档将上传至您服务器上的 modules 目录。
解压缩归档：在模块列表中找到它，点击并选择Unpack。确保 yandex.metrika 目录显示在列表中。
打开 Marketplace → Solutions installed，找到名为“Yandex Metrica”的模块。点击并选择 Install。

第 2 步. 设置模块

转到 Settings → Product settings→ Module settings→ Yandex Metrica。
选择网站。
输入您网站上安装的计数器的编号。如果该插件在网站上检测到 Yandex Metrica 计数器，则会自动填写这些字段。检查它们的值是否正确。如何找到计数器编号
默认启用 Session Replay 选项。该选项会录制用户会话，以便您可以更详细地分析统计。如有必要，您可以随时禁用 Session Replay。
保存更改。

提示

Brand Property 字段不是强制性的。如果您想在 Yandex Metrica 中跟踪商品品牌的统计数据，则填写该字段。例如，哪个品牌最受客户欢迎。
此外，要获得有关商品的更详细的统计数据（例如，用户最常浏览哪些商品），则配置 detail 事件。

第 3 步. 检查数据是否已发送

检查以下数据是否发送到 Yandex Metrica：

E-commerce。
网站会话。

E-commerce 数据在首次发送后显示在 Yandex Metrica 中几个小时。要查看 e-commerce 报表，请转至 Yandex Metrica 并打开 Reports → E-commerce。

E-commerce 报表

当您安装模块后出现第一个网站会话时，有关会话和页面浏览量的数据会显示在 Yandex Metrica 中。要查看统计，请转到 Yandex Metrica 并打开 Reports。有关使用报表的更多信息，请参阅设置和查看报表。

其他设置

如何在模块设置中填写“Brand Property”字段

您可以将有关您在线商店中的品牌的信息发送至 Yandex Metrica。根据此数据，Yandex Metrica生成报表，您可以使用它来确定最受客户欢迎的品牌或找出哪个品牌带来最多的利润等。

备注

1C-Bitrix 模板可以有多个商品目录。在 Yandex Metrica 模块设置中，仅显示活动目录的品牌属性。我们建议填写所有可用的 Brand Property 字段以确保数据正确发送到 Yandex Metrica。

要查找属性值：

转到 1C-Bitrix 管理面板。
转到 Content → Types of infoblocks → Catalogs 并选择目录。
打开右侧的 Features 选项卡。
在列表中，找到品牌对应的字段。
在“Yandex Metrica”模块设置中指定字段的名称。

如何传输有关商品浏览的信息（detail 属性）

您可以将商品浏览数据发送到 Yandex Metrica，以便 E-commerce 报表包含更详细的信息。例如，Popular items 报表就是这样形成的。

要配置产品浏览事件，您需要修改您网站上 bitrix:catalog 组件模板中 element.php 文件的代码。

注意

element.php 文件的路径在不同网站模板中可能有所不同。

以管理员身份登录网站。
在 Website 选项卡上，打开 Editing mode。

备注

如果您之前编辑过模板，请转到本指南的第 6 步。
在网站上，打开商品卡并将鼠标悬停在目录组件区域上以打开菜单。
点击，选择目录，然后选择 Copy the component template。
在 Copy to the site template 字段中，选择 current 并保存更改。
找到并打开 element.php 文件。在代码中，找到如下所示的行：
```
$elementId = $APPLICATION->IncludeComponent('bitrix:catalog.element', 'bootstrap_v4', $componentElementParams,
$component
);
```
如果在 bitrix:catalog.element 组件前未看到 "$elementId = "，请手动将该变量添加到代码中。

在其后，添加 $APPLICATION->IncludeComponent("yandex.metrika:detail", "", array("PRODUCT_ID" => $elementId), $component);。
检查 detail 代码中的变量和函数使用的大小写是否与 element.php 文件一致。

代码示例

...
$elementId = $APPLICATION->IncludeComponent('bitrix:catalog.element', 'bootstrap_v4', $componentElementParams,
$component
);
$APPLICATION->IncludeComponent("yandex.metrika:detail", "", array("PRODUCT_ID" => $elementId), $component);
...