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

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

ウェブデータトラッカーは、クリックされたアイテム、検索されたアイテム、フォーム送信など、訪問者がウェブサイトとやり取りする方法をキャプチャします。そのアクティビティを 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 Profile に関連付ける

ウェブデータトラッカーによってキャプチャされたクリックストリームデータは、Customer Profiles に継続的にストリーミングされます。データがプロファイルにどのように関連付けられるかは、ウィジェットの初期化中にプロファイルキーが提供されるかどうかによって異なります。

ウェブ分析イベントを既存のプロファイルにリンクする

追跡を既知のプロファイルに関連付けるには、JWT クレームprofileKeysで を設定して、接続時に既存のプロファイルを検索して関連付けます。サービスはこれらのキーを使用して SearchProfiles API を介して一致するプロファイルを検索します。そのためには、コミュニケーションウィジェットでセキュリティを有効にする必要があります。セットアップの詳細については、「」を参照してくださいステップ 3: コミュニケーションウィジェットのコードとセキュリティキーを確認してコピーする。

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

カスタム識別子によるイベントのグループ化

既存のプロファイルにリンクする必要はなく、クリックストリームアクティビティを独自にグループ化する場合は、カスタム識別子を指定できます。同じ識別子を共有するクリックストリームイベントは、共通の_webAnalyticsUserIdプロファイルキーの下にグループ化されます。

これを提供するには、次の 2 つの方法があります。

キャプチャされる内容

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

プライバシーと同意

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