セッションAIコネクタ構成ガイド

この記事では、セッションAIコネクタの構成方法について説明します。

アクション

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

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

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

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

アクション

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

CCPA同意の更新

パラメータ

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

ユーザー識別子

パラメータ	説明
`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`	(必須) ユーザーがログインしているかどうかを示します。可能な値：`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`。ネストされたテンプレート変数は、通常、データレイヤーリスト属性から構築されます。詳細については、コネクターテンプレート変数を参照してください。
カスタムイベント属性テンプレート	カスタムイベント属性で参照されるテンプレートを提供します。テンプレートは、例えば `{{SomeTemplateName}}` のように、サポートされるフィールドに名前で注入されます。詳細については、コネクタテンプレートについてを参照してください。

ファイル転送プロトコル

スマートデジタル

このページはお役にたちましたでしょうか？

最終更新日 :: 2025年July月22日