翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ウェブデータトラッカーを使用してウェブサイト訪問者のアクティビティをキャプチャする

ウェブデータトラッカーは、クリックされたアイテム、検索が行われたアイテム、フォームの送信など、訪問者がウェブサイトとやり取りする方法をキャプチャします。そのアクティビティを Customer Profiles のプロファイルに関連付けます。トラッカーはコミュニケーションウィジェットの一部であり、ウィジェットレベルで制御されます。ウェブデータトラッカーとウェブ通知がどのように連携するかの概要については、「」を参照してくださいウェブデータトラッカーとウェブ通知。

前提条件

ステップ 1: コミュニケーションウィジェットでデータ収集を有効にする

ステップ 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アクション、製品ビューなどのカスタムビジネスイベントをキャプチャするには、イベントが発生したときにウェブサイト JavaScript recordBusinessMetricから を呼び出します。

メソッド署名

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

オブジェクトスキーマ

は、次のオブジェクトeventPayloadをサポートしています。ユースケースに合わせて任意のフィールドの組み合わせを使用します。

* 必須フィールド

統合ステップと使用例

を呼び出した後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'
        }
    ]
});

予約イベントタイプ

次のイベントタイプは、事前定義されたスキーマで予約されています。

カスタムイベント:

予約イベントタイプ以外にも、任意のカスタムイベントタイプ文字列 ( clear_cartや などwishlist_add) を定義できます。カスタムイベントの場合:

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

認証されたユーザーにクリックストリームを関連付ける

ウェブデータトラッカーによってキャプチャされたクリックストリームデータは、Customer Profiles に継続的にストリーミングされ、訪問者のプロファイルに関連付けられます。次の表は、匿名訪問者と認証された訪問者の関連付けの動作を示しています。

認証されたユーザーに追跡を関連付けるには、次のいずれかの方法を使用します。

キャプチャされる内容

トラッカーがデフォルトでキャプチャするアクティビティの完全なリストについては、「」を参照してくださいウェブデータトラッカーがキャプチャする内容。

プライバシーと同意

ウェブデータトラッカーは、設計上オプトインされています。コミュニケーションウィジェットでデータ収集を有効にしない場合、クリックストリームデータはキャプチャされません。フォームフィールドの値、パスワード、支払い情報は、フォーム送信イベントが追跡されている場合でも、自動的に収集されることはありません。