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 資料會持續串流至客戶設定檔，並與訪客的設定檔相關聯。下表說明該關聯對匿名和已驗證訪客的行為。

訪客類型

設定檔關聯行為

匿名訪客

僅由工作階段識別符追蹤。擷取行為資料，但未連結至已知的客戶身分。不會收集任何個人身分識別資訊。

已驗證的訪客

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

若要將追蹤與已驗證的使用者建立關聯，請使用下列其中一種方法：

  • （建議） 使用 CustomerId JWT 宣告 – 如果您在通訊小工具上啟用安全性，請在 JSON Web Token (JWT) 宣告的 CustomerId 欄位中包含已驗證的使用者 ID。這會將點擊串流活動連結至使用者的設定檔，而不會在用戶端程式碼中公開 ID。如需設定詳細資訊，請參閱 步驟 3：確認並複製通訊小工具程式碼和安全密鑰。

  • 在初始化期間傳遞使用者 ID – 如果您的小工具上未啟用安全性，請在初始化追蹤器時傳遞已驗證的使用者 ID 做為引數：

    await window.amazon_connect.Web.ClickStream.init('<authenticated-user-id>');
重要

如果傳遞已驗證的使用者 ID，會透過帳戶金鑰連結到現有的設定檔。由於資料追蹤器事件會隨著時間累積，請設定 WebAnalytics-Clickstream和 的物件限制_webAnalytics，以防止新事件在達到設定檔物件限制時覆寫其他物件類型。如需組態指引，請參閱客戶設定檔資料限制。

擷取的內容

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

隱私權與同意

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

重要

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