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

# ウェブデータトラッカーを使用してウェブサイト訪問者のアクティビティをキャプチャする
<a name="chat-widget-data-tracker"></a>

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

## 前提条件
<a name="chat-widget-data-tracker-prereqs"></a>
+ コミュニケーションウィジェットが設定された Connect Customer インスタンス。詳細については、「[Connect Customer がホストするウェブサイトにチャットユーザーインターフェイスを追加する](add-chat-to-website.md)」を参照してください。
+ インスタンスで有効な Customer Profiles。詳細については、「[Connect Customer インスタンスの Customer Profiles を有効にする](enable-customer-profiles.md)」を参照してください。

## ステップ 1: コミュニケーションウィジェットでデータ収集を有効にする
<a name="chat-widget-enable-data-collection"></a>

1.  Connect Customer 管理者ウェブサイトにサインインします。

1. ナビゲーションメニューで、**チャネル**を選択し、**コミュニケーションウィジェット**を選択します。

1. 新しいウィジェットを作成するか、既存のウィジェットを編集します。詳細については、「[Connect Customer がホストするウェブサイトにチャットユーザーインターフェイスを追加する](add-chat-to-website.md)」を参照してください。

1. **データ収集**を有効にしてクリックストリームの追跡を有効にします。

1. (オプション) **データ収集**設定には、**高度なデータ収集**のオプションが含まれています。これをオンにすると、サービスが HTML コンテンツとの訪問者インタラクションを自動的に収集し、より豊かで正確な予測インサイトが生成されます。

1. (オプション) このウィジェットからプロアクティブ通知を送信する場合は、**ウェブ**通知を有効にします。詳細については、「[Connect Customer アウトバウンドキャンペーンでウェブ通知を送信する](outbound-campaigns-web-notification.md)」を参照してください。

1. ウィジェットが埋め込まれるウェブサイトドメインを許可ドメインリストに追加します。

1. ウィジェットを保存し、ウィジェットスニペットコードをコピーします。次のステップで、このスニペットをウェブサイトに埋め込みます。

## ステップ 2: ウィジェットを埋め込み、追跡を初期化する
<a name="chat-widget-embed-and-init-tracking"></a>

ウィジェットスニペットをウェブサイトの 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();
```

**重要**  
追跡は、プライバシーポリシーと適用される規制に従って、適切な訪問者の同意を得た後にのみ初期化します。

**注記**  
シングルページアプリケーションの場合は、最上位ページでスニペットを 1 回埋め込みます。マルチページアプリケーションの場合は、アクティビティをキャプチャするすべてのページにスニペットを埋め込みます。

## ステップ 3: (オプション) ビジネス固有のイベントを追跡する
<a name="chat-widget-track-business-events"></a>

購入の完了、add-to-cartアクション、製品ビューなどのカスタムビジネスイベントをキャプチャするには、イベントが発生したときにウェブサイト JavaScript `recordBusinessMetric`から を呼び出します。

**重要**  
`Find Similar Items` や などのアイテムコンテキストを必要とするレコメンダーでデータトラッカーを使用する場合は`Frequently Paired Items`、ビジネス固有のイベントを使用し、 `item_id`フィールドを含める必要があります。

### メソッド署名
<a name="chat-widget-track-business-events-method"></a>

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


| **パラメータ** | **タイプ** | **説明** | 
| --- | --- | --- | 
| `eventType` | string | ビジネスイベント名 – 予約タイプまたは任意のカスタム文字列。 | 
| `eventPayload` | オブジェクト | 以下のオブジェクトスキーマを使用して構造化されたイベントデータ。 | 

### オブジェクトスキーマ
<a name="chat-widget-track-business-events-schemas"></a>

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


| **オブジェクト** | **キーフィールド** | **説明** | 
| --- | --- | --- | 
| **item** | `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` | スクロール位置 (少なくとも 1 つのフィールドが必要です) | 
| **event\_value** | 数値 | イベントの重要性を表す数値 | 

\* 必須フィールド

### 統合ステップと使用例
<a name="chat-widget-track-business-events-examples"></a>

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

### 予約イベントタイプ
<a name="chat-widget-track-business-events-reserved"></a>

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


| **イベントタイプ** | **必須オブジェクト** | **説明** | 
| --- | --- | --- | 
| `add_to_cart` | item | 訪問者がカートにアイテムを追加するタイミングを追跡します | 
| `purchase` | 順序 | 完了した購入を追跡します | 
| `view_items` | item\_list | 訪問者が 1 つ以上の項目を表示するタイミングを追跡します | 

### カスタムイベント:
<a name="chat-widget-track-business-events-custom"></a>

予約イベントタイプ以外にも、任意のカスタムイベントタイプ文字列 ( `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 }
    ]
});
```

## 認証されたユーザーにクリックストリームを関連付ける
<a name="chat-widget-data-tracker-authenticated-users"></a>

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


| **訪問者タイプ** | **プロファイルの関連付け動作** | 
| --- | --- | 
| 匿名訪問者 | セッション識別子でのみ追跡されます。動作データはキャプチャされますが、既知の顧客 ID にリンクされません。個人を特定できる情報は収集されません。 | 
| 認証された訪問者 | ウィジェットの初期化中に認証されたユーザー ID を渡すと、サービスはすべてのクリックストリームアクティビティを Customer Profiles のそのユーザーの既知のプロファイルにリンクします。これにより、よりリッチなパーソナライゼーションとより正確なトリガー条件が可能になります。 | 

認証されたユーザーに追跡を関連付けるには、次のいずれかの方法を使用します。
+ **(推奨) CustomerId JWT クレームを使用する** – コミュニケーションウィジェットでセキュリティを有効にした場合は、JSON ウェブトークン (JWT) クレームの `CustomerId`フィールドに認証されたユーザー ID を含めます。これにより、クライアント側のコードで ID を公開することなく、クリックストリームアクティビティがユーザーのプロファイルにリンクされます。セットアップの詳細については、「」を参照してください[ステップ 3: コミュニケーションウィジェットのコードとセキュリティキーを確認してコピーする](add-chat-to-website.md#confirm-and-copy-chat-widget-script)。
+ **初期化中にユーザー ID を渡す** – ウィジェットでセキュリティが有効になっていない場合は、トラッカーを初期化するときに、認証されたユーザー ID を引数として渡します。

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

**重要**  
認証されたユーザー ID が渡されると、アカウントキーを介して既存のプロファイルにリンクされます。データトラッカーイベントは時間の経過とともに蓄積されるため、 `WebAnalytics-Clickstream`と のオブジェクト制限を設定`_webAnalytics`して、プロファイルオブジェクトの制限に達すると、新しいイベントが他のオブジェクトタイプを上書きしないようにします。設定ガイダンスについては、[「Customer Profiles データ制限](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-data-limits.html)」を参照してください。

## キャプチャされる内容
<a name="chat-widget-data-tracker-what-is-captured"></a>

トラッカーがデフォルトでキャプチャするアクティビティの完全なリストについては、「」を参照してください[ウェブデータトラッカーがキャプチャする内容](customer-profiles-web-tracker-and-notification.md#web-tracker-what-is-captured)。

## プライバシーと同意
<a name="chat-widget-data-tracker-privacy"></a>

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

**重要**  
お客様は、お客様のプライバシーポリシーおよび一般データ保護規則 (GDPR) やカリフォルニア消費者プライバシー法 (CCPA) などの適用可能な規制に従って、データ追跡を初期化する前に適切な訪問者の同意を得る責任があります。