SHOPLINE Pixel 与客户事件（限定权限）

SHOPLINE Pixel 可帮助您追踪和分析在线商店中的客户行为，并将相关客户事件数据发送至数据分析工具、广告平台或其他业务系统，帮助您更灵活地评估营销表现并追踪重要业务指标。

您可通过【客户事件】统一添加和管理店铺中的像素代码。相较于以往将代码分散添加在主题代码或结账脚本中的方式，【客户事件】可帮助您更集中地管理像素代码。

注意：

像素代码为白名单功能。如需申请使用此功能，请联系 SHOPLINE 客服。
此功能仅限店铺管理员（Store Manager）使用。

适用场景

当您需要进行以下操作时，可使用 SHOPLINE Pixel：

追踪店铺中的关键客户行为，例如页面浏览、加入购物车、结账相关事件
将客户事件数据传送到广告投放或数据分析工具
在 SHOPLINE 后台更集中地管理像素代码

如果您当前仍在使用早期手动插入的追踪脚本，建议先检查相关代码，再启用【客户事件】中的像素代码，以避免重复统计。

关于隐私控制与沙盒环境

为帮助保护店铺性能与客户数据安全，客户事件中的像素代码会在沙盒环境中运行。这样可减少对主题代码或其他脚本的干扰。

在启用任何像素代码前，请确认其使用方式符合您店铺的隐私政策及当地适用法规。如您不确定现有代码是否适用于该环境，建议先与开发人员确认，或联系 SHOPLINE 客服。

进入客户事件管理像素代码

请按照以下步骤，在 SHOPLINE 后台进入并管理像素代码：

在 SHOPLINE 后台，前往【设置】>【客户事件】。
在【客户事件】页面，您可以添加、查看和管理像素代码。当前 SHOPLINE 支持以下两种类型的像素代码：

应用像素代码：由支持 SHOPLINE 官方像素能力的应用提供。安装并完成应用配置后，应用像素代码会显示在【客户事件】中，方便您查看和测试。

自定义像素代码：由您或开发人员根据业务需求在 SHOPLINE 后台手动添加，用于追踪 SHOPLINE 标准客户事件。

SHOPLINE Pixel 目前支持 15 个标准事件，例如页面浏览、加入购物车和完成结账等，并提供相关事件值及关键参数，帮助您更灵活地追踪重要业务指标。

添加应用像素代码

应用像素代码由已接入 SHOPLINE 官方像素能力的应用提供，常用于营销、数据分析或事件采集等场景。

与手动添加的代码相比，应用像素代码通常由应用侧完成配置，并在【设置】 > 【客户事件】中展示，方便您查看状态与进行测试。

当您安装并配置支持的应用后，对应的应用像素代码可能会显示在【设置】 > 【客户事件】 > 【应用像素代码】页签中。

您可以在这里：

查看已添加的应用像素代码
查看当前连接状态
管理相关测试操作

添加自定义像素代码

自定义像素代码是由您或开发人员根据业务需求手动添加的像素代码。它可用于追踪 SHOPLINE 标准客户事件，并将相关数据发送至您的数据分析工具、广告平台或其他系统。

自定义像素代码需由商家或开发人员自行维护，包括代码更新、问题排查及合规检查。

添加自定义像素代码

如需添加自定义像素代码，请按照以下步骤操作：

重要提示： 在添加自定义像素代码前，请先检查您的店铺是否已存在用于相同目的的追踪脚本，并按需移除或更新，以避免重复追踪。

您可以检查主题代码、结账脚本，或其他曾添加追踪代码的位置。

添加步骤如下：

在 SHOPLINE 后台，前往【设置】>【客户事件】。
在【像素代码】区块中，点击【添加自定义像素代码】，输入唯一的像素代码名称并保存。
配置客户隐私设置，并在编辑器中输入您的像素代码。
点击【保存】保存自定义像素代码。

连接自定义像素代码

确认自定义像素代码可正常使用，且符合 SHOPLINE服务条款的隐私要求后，即可将其连接至店铺。您可通过以下任一方式连接：

方式一

进入SHOPLINE后台，转至【设置】 >【客户事件】。
完成添加自定义像素代码操作后，点击右上角【连接】。

方式二

进入SHOPLINE后台，转至【设置】 >【客户事件】。
代码栏会显示已添加的自定义像素代码状态。找到您想连接的像素代码，点击操作下方的【···】，选择【连接】。

断开自定义像素代码连接

断开连接可停止已添加的自定义像素代码的跟踪活动。

进入SHOPLINE后台，转至【设置】 >【客户事件】。
在自定义像素代码列表中，只有状态为已连接的自定义像素代码才能进行断开连接操作。
点击操作下方的【···】，选择断开连接。

更改自定义像素代码

无论自定义像素代码是否连接，均可修改像素代码内容或者像素代码名称。如果您想进行修改自定义像素代码的操作，可通过以下步骤实现。

更改像素代码内容

进入SHOPLINE后台，转至【设置】 >【客户事件】。
在搜索框里搜索需更改的像素代码，或者直接点击代码列表中需更改的像素代码的名称，进入编辑页面。
在沙盒区域进行更改，并点击【更新】。

更改像素代码名称

进入SHOPLINE后台，转至【设置】 >【客户事件】。
在自定义像素代码列表中找到您想更改的像素代码，点击操作下方的【···】，选择编辑像素代名称。
更改像素代码名称，并点击【保存】。

删除自定义像素代码

可删除您不再需要或者报错的自定义像素代码。

备注: 需注意的是，删除自定义像素代码是一个不可撤销的操作，因此在进行删除之前，请务必确保正确执行。

进入SHOPLINE后台，转至【设置】 >【客户事件】。
在自定义像素代码列表中找到您想删除的像素代码，点击操作下方的【···】，选择【删除】。

将现有追踪代码迁移至像素代码

如果您的店铺过去是在主题文件或其他自定义代码位置中添加追踪脚本，您可以考虑将其迁移至【客户事件】中统一管理。

迁移前，请先确认相同的追踪逻辑是否仍存在于店铺其他位置。请勿在多个位置同时保留相同代码，否则可能导致事件重复上报。

如需将现有脚本迁移至自定义像素代码，或确认某个应用是否支持应用像素代码，建议先与您的开发人员或应用服务商确认。

备注： SHOPLINE Pixel API 开放文档预计将于后续版本正式上线。

测试像素代码

完成像素代码设置后，您可以使用【测试】功能检查相关客户事件是否已正确订阅。

操作步骤如下：

进入 SHOPLINE 后台，前往【设置】 >【客户事件】。
根据您要检查的像素代码类型，切换到【自定义像素代码】或【应用像素代码】页签。
找到您想测试的像素代码，点击操作栏中的【···】选择【测试】。

您可通过该功能验证相关客户事件是否已按预期订阅。如需进一步确认，也可结合对应平台提供的浏览器调试工具进行检查。