SHOPLINE Pixel 与客户事件
SHOPLINE Pixel 可帮助您追踪和分析在线商店中的客户行为，并将相关客户事件数据发送至数据分析工具、广告平台或其他业务系统，帮助您更灵活地评估营销表现并追踪重要业务指标。
您可通过【客户事件】统一添加和管理店铺中的像素代码。相较于以往将代码分散添加在主题代码或结账脚本中的方式，【客户事件】可帮助您更集中地管理像素代码。
本文将介绍如何进入【客户事件】、添加和管理应用像素代码与自定义像素代码，以及测试像素代码。
| 备注：【客户事件】默认仅由店铺管理员使用。如需让其他员工使用，须先由店铺管理员在【设置】＞【管理员和权限】＞【店铺设置】＞【客户事件】中为其分配相应权限，授权后员工方可使用。 |
SHOPLINE Pixel 适用场景
当您需要进行以下操作时，可使用 SHOPLINE Pixel：
- 追踪店铺中的关键客户行为，例如页面浏览、加入购物车、结账相关事件
- 将客户事件数据传送到广告投放或数据分析工具
- 在 SHOPLINE 后台更集中地管理像素代码
如果您当前仍在使用早期手动插入的追踪脚本，建议先检查相关代码，再启用【客户事件】中的像素代码，以避免重复统计。
关于隐私控制与沙盒环境
为帮助保护店铺性能与客户数据安全，【客户事件】中的像素代码会在沙盒环境中运行。这样可减少对主题代码或其他脚本的干扰。
在启用任何像素代码前，请确认其使用方式符合您店铺的隐私政策及当地适用法规。如您不确定现有代码是否适用于该环境，建议先与开发人员确认，或联系 SHOPLINE 客服。
进入客户事件管理像素代码
请按照以下步骤，在 SHOPLINE 后台进入并管理像素代码：
- 在 SHOPLINE 后台，前往【设置】>【客户事件】。
- 在【客户事件】页面，您可以添加、查看和管理像素代码。当前 SHOPLINE 支持以下两种类型的像素代码：
- 应用像素代码：由支持 SHOPLINE Pixel 的应用提供。安装应用后会自动启用，无需手动编写代码，并在严格的沙盒环境中运行。您可在【客户事件】中查看和测试。
- 自定义像素代码：由您或开发人员根据业务需求在【客户事件】中手动添加，适合为单一店铺灵活设置追踪需求，并在宽松沙盒环境中运行。
SHOPLINE Pixel 支持追踪标准事件、页面互动事件及自定义客户事件，详情请参阅下一节。
了解 SHOPLINE Pixel 支持的客户事件
SHOPLINE Pixel 支持追踪以下三类客户事件：
- 标准事件：SHOPLINE 预设的常见购物行为，例如浏览页面、加入购物车、完成结账。目前共支持 15 个标准事件（见下表）。
- 页面互动事件（DOM 事件）：客户在页面上的操作，包括点击、输入、选项变更和表单提交。
- 自定义客户事件：由开发人员根据业务需求自行定义的事件，可用于追踪标准事件以外的特定行为。
下表列出了 15 个标准事件及其触发时机：
| 标准事件 | 触发时机 |
| page_viewed | 客户打开商店页面且页面加载完成时。 |
| product_viewed | 客户打开商品详情页且页面加载完成时。 |
| collection_viewed | 客户打开任一分类页面且页面加载完成时。 |
| search_submitted | 客户提交搜索时。 |
| search_view_results | 客户查看搜索结果页且页面加载完成时。 |
| product_added_to_cart | 客户将商品加入购物车，或在购物车中增加商品数量时。 |
| product_removed_from_cart | 客户移除购物车中的商品、减少商品数量或清空购物车时。 |
| cart_viewed | 客户打开购物车页面时。 |
| checkout_started | 客户进入结账页面时。客户每次进入结账页面均会触发。 |
| checkout_contact_info_submitted | 客户在结账页成功提交联系信息后。 |
| payment_info_submitted | 客户在结账页成功提交支付信息后。 |
| checkout_completed | 客户下单后成功进入 Thank you 页面时。 |
| lead | 客户成功提交询盘，或在订阅栏留下邮箱时。 |
| login | 客户成功登录账号时。 |
| registration_completed | 客户成功注册账号时。 |
各事件的参数说明及代码示例，请参阅《SHOPLINE Pixel 接入指南：标准事件》。
添加应用像素代码
应用像素代码由已接入 SHOPLINE Pixel 的应用提供，常用于营销、数据分析或事件采集等场景。
与手动添加的代码相比，应用像素代码通常由应用侧完成配置，并在【设置】 > 【客户事件】中展示，方便您查看状态与进行测试。
当您安装并配置支持的应用后，对应的应用像素代码可能会显示在【设置】 > 【客户事件】 > 【应用像素代码】页签中。
您可以在这里：
- 查看已添加的应用像素代码
- 查看当前连接状态
- 管理相关测试操作
添加自定义像素代码
自定义像素代码是您或您的开发者在 SHOPLINE 后台【客户事件】像素管理器中手动添加的自定义 JavaScript 代码。通常用于特定的第三方追踪或临时脚本接入，可用于追踪 SHOPLINE 标准客户事件，并将相关数据发送至您的分析工具、广告平台或其他系统。
自定义像素代码运行在宽松沙箱环境中，需由商家或开发人员自行维护，包括代码更新、问题排查及合规检查。
完整的事件列表、事件参数及代码示例，请参阅《SHOPLINE Pixel 接入指南》。
如何添加自定义像素代码
如需添加自定义像素代码，请按照以下步骤操作：
|
重要提示： 在添加自定义像素代码前，请先检查您的店铺是否已存在用于相同目的的追踪脚本，并按需移除或更新，以避免重复追踪。 您可以检查主题代码、结账脚本，或其他曾添加追踪代码的位置。 |
添加步骤如下：
- 在 SHOPLINE 后台，前往【设置】>【客户事件】。
- 在【像素代码】区块中，点击【添加自定义像素代码】，输入唯一的像素代码名称并保存。
- 配置客户隐私设置，并在编辑器中输入您的像素代码。
- 点击【保存】保存自定义像素代码。
连接自定义像素代码
确认自定义像素代码可正常使用，且符合 《SHOPLINE 隐私政策》的要求后，即可将其连接至店铺。您可通过以下任一方式连接：
方式一
- 进入SHOPLINE后台，转至【设置】 >【客户事件】。
- 完成添加自定义像素代码操作后，点击右上角【连接】。
方式二
- 进入SHOPLINE后台，转至【设置】 >【客户事件】。
- 代码栏会显示已添加的自定义像素代码状态。找到您想连接的像素代码，点击【操作】栏下方的【···】，选择【连接】。
断开自定义像素代码连接
断开连接可停止已添加的自定义像素代码的跟踪活动。
- 进入SHOPLINE后台，转至【设置】 >【客户事件】。
- 在自定义像素代码列表中，只有状态为【已连接】的自定义像素代码才能进行断开连接操作。
- 点击【操作】栏下方的【···】，选择【断开连接】。
更改自定义像素代码
无论自定义像素代码是否连接，均可修改像素代码内容或者像素代码名称。如果您想进行修改自定义像素代码的操作，可通过以下步骤实现。
更改像素代码内容
- 进入SHOPLINE后台，转至【设置】 >【客户事件】。
- 在搜索框里搜索需更改的像素代码， 或者直接点击像素代码列表中需更改的像素代码的名称，进入编辑页面。
- 在沙盒区域进行更改，并点击【更新】。
更改像素代码名称
- 进入SHOPLINE后台，转至【设置】 >【客户事件】。
- 在自定义像素代码列表中找到您想更改的像素代码，点击【操作】栏下方的【···】，选择【编辑像素代码名称】。
- 更改像素代码名称，并点击【保存】。
删除自定义像素代码
可删除您不再需要或者报错的自定义像素代码。
| 备注: 需注意的是，删除自定义像素代码是一个不可撤销的操作，因此在进行删除之前，请务必确保正确执行。 |
- 进入SHOPLINE后台，转至【设置】 >【客户事件】。
-
在自定义像素代码列表中找到您想删除的像素代码，点击【操作】栏下方的【···】，选择【删除】。
将现有追踪代码迁移至像素代码
如果您的店铺过去是在主题文件或其他自定义代码位置中添加追踪脚本，您可以考虑将其迁移至【客户事件】中统一管理。
迁移前，请先确认相同的追踪逻辑是否仍存在于店铺其他位置。请勿在多个位置同时保留相同代码，否则可能导致事件重复上报。
如需将现有脚本迁移至自定义像素代码，或确认某个应用是否支持应用像素代码，建议先与您的开发人员或应用服务商确认。
| 提示： 迁移前，建议开发人员先参阅《SHOPLINE Pixel 接入指南》，确认所需的事件及参数是否已支持。 |
测试像素代码
完成像素代码设置后，您可以使用【测试】功能检查相关客户事件是否已正确订阅。
操作步骤如下：
- 进入 SHOPLINE 后台，前往【设置】 >【客户事件】。
- 根据您要检查的像素代码类型，切换到【自定义像素代码】或【应用像素代码】页签。
- 找到您想测试的像素代码，点击操作栏中的【···】选择【测试】。
关于 SHOPLINE Pixel 的常见问题
Q：SHOPLINE Pixel 可以追踪哪些客户事件？
可追踪标准事件、页面互动事件（DOM 事件）及自定义客户事件。详情请参阅《SHOPLINE Pixel 接入指南：客户事件》。
Q：在哪里可以查看各事件的参数和代码示例？
每个标准事件的参数说明，以及应用像素代码和自定义像素代码的示例，均可在《SHOPLINE Pixel 接入指南：标准事件》中查看。
Q：编写自定义像素代码时，需要额外设置或引入代码吗？
不需要。【客户事件】代码编辑器已预先载入 SHOPLINE Pixel，开发人员可直接订阅所需事件，无需额外设置。代码示例请参阅《SHOPLINE Pixel 接入指南：自定义像素》。
Q：可以追踪客户点击某个按钮的行为吗？
可以。您可通过页面互动事件追踪客户在店铺页面上的点击、输入、选项变更和表单提交。详情请参阅《SHOPLINE Pixel 接入指南：DOM 事件》。
Q：可以追踪标准事件以外的客户行为吗？
可以。开发人员可自行定义并发布自定义客户事件，再通过像素代码订阅。详情请参阅《SHOPLINE Pixel 接入指南：自定义客户事件》。