---
title: セッションAIコネクタ構成ガイド
description: この記事では、セッションAIコネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/session-ai-connector/
---
## アクション

| アクション名 | AudienceStream | EventStream |
| --- | :---: | :---: |
| CCPA同意の更新 | ✓ | ✓ |
| イベントの送信 | ✓ | ✓ |

## 構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。

コネクタを追加した後、以下の構成を構成します：

* **ホスト**  
 必須。環境に関連付けられたホストを選択します。
セッションAIサンドボックス環境を指す場合は `https://csb.zineone.com` を使用します。本番環境を指す場合は `https://cloud.zineone.com` を使用します。
* **APIキー**  
APIキーを生成するには、**Session AI > Integrations > Data Channel** でチャネルを作成します。

## アクション

次のセクションでは、各アクションでサポートされるパラメータをリストします。

### CCPA同意の更新

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| オプトインアクション | 可能な値：<ul><li>`true` - オプトインリクエストを選択します。</li><li>`false` - オプトアウトリクエストを選択します。</li></ul> |

#### ユーザー識別子

| **パラメータ** | **説明** |
| --- | --- |
| `id` | 顧客プロファイルの一意のIDです。 |
| `email` | 顧客の一意のメールIDです。 |
| `deviceId` | 顧客の一意のデバイスIDです。 |

### イベントの送信

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| データチャネル | イベントを送信するチャネル。 |
| イベント名 | イベント名を選択するか、カスタム名を入力します。 |

#### 共通属性

| **パラメータ** | **説明** |
| --- | --- |
| `session_id `| (必須) セッションまたは訪問を一意に識別するIDです。 |
| `visitor_id `| (必須) サインインしていない場合のユーザーを識別するIDです。 |
| `customer_id` | サインインしている場合のユーザーを識別するIDです。 |
| `user_agent` | 利用可能な場合は、ブラウザのユーザーエージェント文字列です。 |
| `device_channel` | (必須) デバイスのタイプです。例：デスクトップ、タブレット、モバイル、アプリなど。 |
| `referrer_url` | (必須) 前のページのURLを参照するURLです。例えば、ユーザーがサードパーティのウェブサイトからあなたのサイトを初めて訪れた場合、これはサードパーティのURLになります。ユーザーがあなたのサイトのセッションの途中にいる場合、前のページのURLが現在のページのリファラーURLになります。 |
| `campaign_info` | キャンペーン名または構造です。例えば、`utm_campaign` の値です。 |
| `os` | デバイスのオペレーティングシステムです。 |
| `os_version` | オペレーティングシステムのバージョンです。 |
| `platform_os` | オペレーティングシステムのプラットフォームです。 |
| `language` | デバイスの言語です。 |
| `tz` | デバイスのタイムゾーンです。 |
| `devicetype` | デバイスのタイプです。 |
| `browser` | デバイスで使用されるブラウザです。 |
| `browserversion` | デバイスで使用されるブラウザのバージョンです。 |
| `resolution` | デバイスのディスプレイの解像度です。 |

#### イベント属性

| **パラメータ** | **説明** |
| --- | --- |
| `logged_in` | (必須) ユーザーがログインしているかどうかを示します。<br> 可能な値：`Y`、`N`、またはマップされたブール型属性。  |
| `pagename` | イベントがトリガーされたページ名です。 |
| `pagepath` | イベントがトリガーされたページパスです。 |
| `category` | 製品のカテゴリです。 |
| `product_id` | 製品のIDです。 |
| `price_sale` | 製品のセール価格です。 |
| `price_orig` | 製品の元の価格です。 |
| `sku` | 製品のSKUです。 |
| `search_term` | 製品を検索するために使用された検索用語です。 |
| `name` | 製品の名前です。 |
| `price` | 製品の価格です。 |
| `list_price` | 製品のリスト価格です。 |
| `sort_field` | ソートに使用されるプロパティです。 |
| `sort_order` | ソート順です。 |
| フィルター属性 | 適用されたフィルターに関する情報を含むグループです。 |

#### バリアント属性

| **パラメータ** | **説明** |
| --- | --- |
| `color` | バリアントの色です。 |
| `brand` | バリアントのブランドです。 |
| `size` | バリアントのサイズです。 |

#### カート属性

| **パラメータ** | **説明** |
| --- | --- |
| `quantity` | カート内のアイテムの数量です。 |
| `product_id`| カート内の製品のIDです。 |
| `list_price`| カート内のアイテムのセール価格です。 |
| `price` | カート内のアイテムの元の価格です。 |
| `sku` | カート内のアイテムのSKUです。 |
| `name` | 製品の名前です。|
| `category` | 製品のカテゴリです。 |
| `item_coupon_code` | クーポンコードです。 |
| `item_coupon_value` | クーポンの値です。 |
| `item_coupon_currency` | クーポン値が表現される通貨です。 |
| `item_coupon_type` | クーポンのタイプです。 |
| `item_coupon_terms` | クーポンの条件です。 |
| `item_coupon_method` | クーポンの方法です。 |
| `variant_color` | バリアントの色です。 |
| `variant_brand` | バリアントのブランドです。 |
| `variant_size` | バリアントのサイズです。 |

#### アイテム属性

| **パラメータ** | **説明** |
| --- | --- |
| `quantity` | 購入されたアイテムの数量です。 |
| `product_id` | 購入された製品のIDです。 |
| `list_price` | 購入されたアイテムの元の価格です。 |
| `price` | 購入されたアイテムのセール価格です。 |
| `sku` | 購入されたアイテムのSKUです。 |
| `name` | 購入されたアイテムの名前です。 |
| `category` | 製品のカテゴリです。 |
| `item_coupon_code` | クーポンコードです。 |
| `item_coupon_value`| クーポンの値です。 |
| `item_coupon_currency`| クーポン値が表現される通貨です。 |
| `item_coupon_type `| クーポンのタイプです。 |
| `item_coupon_terms `| クーポンの条件です。 |
| `item_coupon_method` | クーポンの方法です。 |
| `variant_color `| バリアントの色です。 |
| `variant_brand` | バリアントのブランドです。 |
| `variant_size`| バリアントのサイズです。 |

#### 購入属性

| **パラメータ** | **説明** |
| --- | --- |
| `order_id` | 注文のIDです。 |
| `order_total` | 注文に支払われた総額です。 |
| `discount` | 注文に適用された割引です。 |
| `taxes` | 注文に適用された税金です。 |
| `shipping` | 注文の送料です。 |
| `item_total` | 注文内のアイテムの総数です。 |
| `referred_id` | 紹介者のIDです。 |

#### 購入クーポン属性

| **パラメータ** | **説明** |
| --- | --- |
| `code` | クーポンコードです。 |
| `value` | クーポンの値です。 |
| `currency` | クーポン値が表現される通貨です。 |
| `type` | クーポンのタイプです。 |
| `terms` | クーポンの条件です。 |
| `method` | クーポンの方法です。 |
| カスタムイベント属性 | オプションのカスタム属性をマップします。 |
| カスタムイベント属性テンプレート変数 | より複雑なデータ構造を作成し、データ入力としてテンプレート変数を提供するために、ドット表記でテンプレート変数に名前を付けます。例：`items.name`。<li>ネストされたテンプレート変数は、通常、データレイヤーリスト属性から構築されます。</li><li>詳細については、[connector-template-variables](https://docs.tealium.com/connector-template-variables/)を参照してください。</li></ul> |
| カスタムイベント属性テンプレート | **カスタムイベント属性**で参照されるテンプレートを提供します。<ul><li>テンプレートは、例えば `{{SomeTemplateName}}` のように、サポートされるフィールドに名前で注入されます。</li><li>詳細については、[about-connector-templates](https://docs.tealium.com/about-connector-templates/)を参照してください。</li></ul> |

