View a markdown version of this page

使用 Web 資料追蹤器擷取網站訪客活動 - Amazon Connect 客戶
先決條件步驟 1：在通訊小工具上啟用資料收集步驟 2：嵌入小工具並初始化追蹤步驟 3：（選用） 追蹤業務特定事件將點擊串流與客戶設定檔建立關聯擷取的內容隱私權與同意

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Web 資料追蹤器擷取網站訪客活動

Web 資料追蹤器會擷取訪客與您的網站互動的方式 – 按一下的項目、進行搜尋、表單提交。它會將該活動與客戶設定檔中的設定檔建立關聯。追蹤器是通訊小工具的一部分，並在小工具層級控制。如需 Web 資料追蹤器和 Web 通知如何一起運作的概觀，請參閱 Web 資料追蹤器和 Web 通知。

先決條件

步驟 1：在通訊小工具上啟用資料收集

  1. 登入 Connect Customer 管理員網站。

  2. 在導覽功能表中，選擇頻道，然後選擇通訊小工具。

  3. 建立新的小工具或編輯現有的小工具。如需詳細資訊，請參閱將聊天使用者介面新增至 Connect Customer 託管的網站。

  4. 啟用資料收集以開啟點選串流追蹤。

  5. （選用） 資料收集設定包含進階資料收集的選項。開啟此功能，讓服務自動收集訪客與 HTML 內容的互動，進而產生更豐富且更準確的預測洞見。

  6. （選用） 如果您打算從此小工具傳送主動通知，請啟用 Web 通知。如需詳細資訊，請參閱使用 Connect Customer 對外行銷活動傳送 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：（選用） 追蹤業務特定事件

若要擷取自訂商業事件，例如購買完成、add-to-cart動作或產品檢視，請在事件發生時recordBusinessMetric從您的網站 JavaScript 呼叫 。

重要

如果您計劃將資料追蹤器與需要項目內容的推薦者搭配使用，例如 Find Similar Items和 Frequently Paired Items，您必須使用業務特定事件並包含 item_id 欄位。

方法簽章

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

Parameter (參數)

類型

Description

eventType

string

業務事件名稱 – 預留類型或任何自訂字串。

eventPayload

object

使用下列物件結構描述建構的事件資料。

物件結構描述

eventPayload 支援下列物件。使用欄位的任意組合以符合您的使用案例。

物件

金鑰欄位

Description

項目

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

單一產品或項目

item_list

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

捲動位置 （至少需要一個欄位）

event_value

number

代表事件重要性的數值

* 必要欄位

整合步驟和使用範例

呼叫 後amazon_connect.Web.ClickStream.init()，在網站的事件處理常式中新增recordBusinessMetric()呼叫 （例如，按一下）。

範例 – 新增至購物車

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'
        }
    ]
});

預留事件類型

下列事件類型會保留預先定義的結構描述：

事件類型

必要物件

Description

add_to_cart

item

追蹤訪客何時將項目新增至購物車

purchase

order

追蹤已完成的購買

view_items

item_list

追蹤訪客何時檢視一或多個項目

自訂事件

除了預留事件類型之外，您還可以定義任何自訂事件類型字串 （例如 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 }
    ]
});

將點擊串流與客戶設定檔建立關聯

Web 資料追蹤器擷取的 Clickstream 資料會持續串流至客戶設定檔。資料與設定檔的關聯方式取決於小工具初始化期間是否提供設定檔金鑰。

訪客類型

設定檔關聯行為

不含設定檔金鑰的訪客 （匿名）

由存放在瀏覽器 Cookie 中的匿名識別符追蹤，會在 7 天後過期。在此期間，來自相同訪客的點擊串流資料會連結到單一匿名設定檔。Cookie 過期後，會產生新的匿名識別符，並在新的設定檔下追蹤後續活動。不會收集任何個人身分識別資訊。

如果在小工具初始化期間提供設定檔金鑰，則點擊串流資料會連結到對應的已知設定檔，而不是匿名設定檔。

具有設定檔金鑰的訪客

當您在小工具初始化期間傳遞設定檔金鑰時，服務會將所有點擊串流活動連結至客戶設定檔中該使用者的已知設定檔。這可實現更豐富的個人化和更準確的觸發條件。

將 Web 分析事件與現有設定檔連結

若要將追蹤與已知設定檔建立關聯，請在 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()傳回錯誤。修改您的金鑰選擇，以確保唯一性。

設定物件計數限制以防止移出問題

如果與現有的設定檔連結，建議您在 WebAnalytics-Clickstream和 _webAnalytics 物件類型MaxProfileObjectCount上設定 。這些資料追蹤器事件物件會隨著時間累積。如果沒有此設定，服務不會在設定檔達到其物件限制時將其視為移出。如需資料限制的詳細資訊，請參閱客戶設定檔資料限制。

依自訂識別符分組事件

如果您不需要連結至現有的設定檔，但想要自行將點擊串流活動分組，您可以提供自訂識別符。共用相同識別符的 Clickstream 事件會以通用_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 也提供並解析為現有的設定檔，則設定檔解析會使用該結果並略過此自訂識別符。

擷取的內容

如需追蹤器預設擷取之活動的完整清單，請參閱 Web 資料追蹤器擷取的內容。

隱私權與同意

Web 資料追蹤器是依設計選擇加入。如果您未在通訊小工具上啟用資料收集，則不會擷取任何點擊串流資料。即使追蹤表單提交事件，也不會自動收集表單欄位值、密碼和付款資訊。

重要

您有責任根據您的隱私權政策和適用法規，例如一般資料保護法規 (GDPR) 和加州消費者隱私權法案 (CCPA)，在初始化資料追蹤之前取得適當的訪客同意。