View a markdown version of this page

使用网络数据跟踪器捕获网站访客活动 - Amazon Connect Customer
先决条件第 1 步：在 “通信” 插件上启用数据收集第 2 步：嵌入控件并初始化跟踪第 3 步：（可选）跟踪特定业务事件将点击流与客户资料相关联捕获了什么隐私和同意

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用网络数据跟踪器捕获网站访客活动

网络数据跟踪器捕捉访问者如何与您的网站进行交互——点击的项目、进行的搜索、提交表单。它将该活动与他们在客户档案中的个人资料相关联。跟踪器是通信控件的一部分，在控件级别上进行控制。有关 Web 数据跟踪器和 Web 通知如何协同工作的概述，请参阅网络数据跟踪器和网络通知。

先决条件

第 1 步：在 “通信” 插件上启用数据收集

  1. 登录 Connect Customer 管理员网站。

  2. 在导航菜单中，选择 “频道”，然后选择 “通信” 插件。

  3. 创建新控件或编辑现有控件。有关更多信息，请参阅 将聊天用户界面添加到由 Connect Customer 托管的网站中。

  4. 启用数据收集以开启点击流跟踪。

  5. （可选）数据收集设置包括高级数据收集选项。开启此功能后，该服务会自动收集访客与 HTML 内容的互动，从而生成更丰富、更准确的预测见解。

  6. （可选）如果您计划通过此小组件发送主动通知，请启用 Web 通知。有关更多信息，请参阅 通过 Connect 客户外发活动发送 Web 通知。

  7. 将要嵌入小工具的网站域名添加到允许的域名列表中。

  8. 保存控件并复制控件代码片段代码。下一步将此片段嵌入到您的网站上。

第 2 步：嵌入控件并初始化跟踪

将小工具片段嵌入到您网站的 HTML 中。加载代码片段后，在获得访客同意后初始化跟踪器。

// Start tracking visitor behavior (after obtaining consent)
await window.amazon_connect.Web.ClickStream.init();

// (Optional) Enable web notifications for this visitor
await window.amazon_connect.Web.Notification.init();
重要

只有在根据您的隐私政策和适用法规获得相应访客同意后，才能初始化跟踪。

注意

对于单页应用程序，将代码片段嵌入到顶级页面一次。对于多页面应用程序，将代码片段嵌入到要捕获活动的每个页面上。

第 3 步：（可选）跟踪特定业务事件

要捕获自定义业务事件（例如购买完成、添加到购物车操作或产品视图），请在事件发生 JavaScript 时recordBusinessMetric从您的网站致电。

重要

如果您计划将数据跟踪器与需要项目上下文（例如Find Similar Items和）的推荐者一起使用Frequently Paired Items，则必须使用业务特定事件并包含该item_id字段。

方法签名

await amazon_connect.Web.ClickStream.recordBusinessMetric(eventType, eventPayload)

参数

Type

描述

eventType

字符串

业务事件名称-保留类型或任何自定义字符串。

eventPayload

object

使用下面的对象架构结构化事件数据。

对象架构

eventPayload支持以下对象。使用任意字段组合以适合您的用例。

Object

关键字段

描述

项目

item_id*, item_name*, quantity*, category, price, currency, impression_type, impression_id

单个产品或项目

item_list

清单 <item>

物品对象数组（最少 1 个）

购物车

cart_id*, item_list*, total_value, currency

购物车

订购

order_id*, item_list*, total_value, currency, payment_method, shipping_address, discount

已完成的订单

search

search_query*, total_matching_results, results_per_page, filter_expression, sort_criteria

搜索操作

表格

form_id*, form_name, form_length, validation_errors, fields_completed

表单互动

滚动

depth_percentage, position_x, position_y

滚动位置（至少需要一个字段）

事件值

数字

代表事件重要性的数值

* 必填字段

集成步骤和用法示例

调用后amazon_connect.Web.ClickStream.init()，在网站的事件处理程序中添加recordBusinessMetric()调用（例如 onclick）。

示例 — 加入购物车 

await amazon_connect.Web.ClickStream.recordBusinessMetric('add_to_cart', {
    item: {
        item_id: 'prod-123',
        item_name: 'Wireless Headphones',
        price: 49.99,
        quantity: 1,
        currency: 'USD'
    }
});

示例-查看项目 

await amazon_connect.Web.ClickStream.recordBusinessMetric('view_items', {
    item_list: [
        {
            item_id: 'item_10',
            quantity: 1,
            item_name: 'Premium Wireless Headphones',
            category: 'Electronics',
            price: 89.99,
            currency: 'USD'
        }
    ]
});

预留活动类型

以下事件类型由预定义架构保留：

事件类型

必填对象

描述

add_to_cart

item

跟踪访客何时将物品添加到购物车

purchase

顺序

追踪已完成的购买

view_items

物品清单

跟踪访客何时查看一个或多个项目

自定义事件

除了预留事件类型外，您还可以定义任何自定义事件类型字符串（例如，clear_cart或wishlist_add）。对于自定义事件：

  • 该服务不强制对事件结构进行严格验证。

  • 您可以根据自己的用例使用上述对象架构中的任意字段组合。

  • 完全按照所示使用字段名称（例如cart_id，不是cartId）。

await amazon_connect.Web.ClickStream.recordBusinessMetric('clear_cart', {
    cart_id: 'cart-123',
    item_list: [
        { item_id: 'p1', item_name: 'Widget', quantity: 1 }
    ]
});

将点击流与客户资料相关联

网络数据跟踪器捕获的点击流数据会持续传输到客户档案。数据如何与配置文件关联取决于在控件初始化期间是否提供配置文件密钥。

访客类型

个人资料关联行为

没有个人资料密钥的访客（匿名）

由存储在浏览器 Cookie 中的匿名标识符进行跟踪，该标识符将在 7 天后过期。在此期间，来自同一访客的点击流数据将链接到一个匿名个人资料。Cookie 过期后，将生成一个新的匿名标识符，并在新的配置文件下跟踪后续活动。不收集任何个人身份信息。

如果在控件初始化期间提供了配置文件密钥，则点击流数据将链接到相应的已知配置文件而不是匿名配置文件。

持有个人资料密钥的访客

当您在控件初始化期间传递配置文件密钥时，该服务会将所有点击流活动链接到该用户在 “客户资料” 中的已知个人资料。这样可以实现更丰富的个性化设置和更准确的触发条件。

将网络分析事件与现有配置文件关联起来

要将跟踪与已知配置文件相关联，请在您的 JWT 声明profileKeys中设置在连接时搜索现有配置文件并与之关联，该服务使用这些密钥通过 SearchProfiles API 查找匹配的配置文件。这需要在 “通信” 插件上启用安全功能。有关设置的详细信息，请参阅第 3 步：确认并复制通信小部件代码和安全密钥。

{
  "sub": "<widgetId>",
  "iat": 1234567890,
  "exp": 1234571490,
  "profileKeys": {
    "_email": "user@example.com",
    "_account": "ACCT-12345"
  },
  "profileKeysOperator": "OR"
}

  • profileKeys— 一个键值对象，其中每个密钥都是可搜索的客户档案标识符（例如_email、_phone、_account），值是查询值。

  • profileKeysOperator（可选）— "AND" 或"OR"（默认："OR"）。确定配置文件必须匹配所有密钥还是任何密钥。

  • 如果只找到一个配置文件，则该配置文件与该会话相关联。

  • 如果找不到任何个人资料，则会话将匿名进行（稍后可以创建新的配置文件）。

  • 如果找到多个配置文件，则window.amazon_connect.Web.ClickStream.init()返回错误。修改您的密钥选择以确保唯一性。

设置对象数量限制以防止驱逐问题

如果与现有配置文件关联，我们建议设置MaxProfileObjectCountWebAnalytics-Clickstream和_webAnalytics对象类型。这些数据跟踪器事件对象会随着时间的推移而累积。如果没有此设置，则当配置文件达到其对象限制时，服务不会考虑将其驱逐。有关数据限制的更多信息，请参阅客户资料数据限制。

按自定义标识符对事件进行分组

如果您不需要链接到现有个人资料，但想自行对点击流活动进行分组，则可以提供自定义标识符。共享相同标识符的点击流事件分组在通用_webAnalyticsUserId配置文件密钥下。

有两种提供方式：

  • 通过 JWT 声明 — 在 JWT 声明中设置customerId字段（需要启用安全保护）。

  • 通过初始化 — 在初始化跟踪器时将标识符作为参数传递：

    // Pass the custom user id as a positional string argument.
await window.amazon_connect.Web.ClickStream.init('<custom-user-id>');
注意

如果profileKeys还提供了配置文件并将其解析为现有配置文件，则配置文件解析将使用该结果并跳过此自定义标识符。

捕获了什么

有关跟踪器默认捕获的活动的完整列表，请参阅网络数据跟踪器捕获的内容。

隐私和同意

根据设计，网络数据跟踪器是可选的。如果您未在 “通信” 控件上启用 “数据收集”，则不会捕获任何点击流数据。即使跟踪表单提交事件，也不会自动收集表单字段值、密码和付款信息。

重要

根据您的隐私政策和适用法规，例如《通用数据保护条例》(GDPR) 和《加州消费者隐私法》(CCPA)，您有责任在初始化数据跟踪之前获得适当的访客同意。