Salesforce Interaction Studio コネクタの構成ガイド | サーバーサイドコネクタ

API 情報

このコネクタは、次のベンダー API を使用します：

API 名: パーソナライゼーションイベント API
API バージョン: v2
ドキュメント: パーソナライゼーションイベント API

コネクタのアクション

アクション名	AudienceStream	EventStream
信頼されたチャネルを介してイベントデータを送信する (SalesforceInteractions 名前空間)	✗	✓
信頼されたチャネルを介してイベントデータを送信する (Evergage 名前空間)	✗	✓

構成の構成

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

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

アカウント名
必須項目です。 Interaction Studio のアカウント名を入力します。
Salesforce の Interaction Studio UI から Gears にアクセスし、URL を確認することでアカウント名を取得できます。たとえば、Gears の URL が https://demo.us-1.evergage.com/ の場合、アカウント名は demo です。
インスタンス識別子
必須項目です。 Interaction Studio のインスタンス識別子を入力します。
Salesforce の Interaction Studio UI から Gears にアクセスし、URL を確認することでインスタンス識別子を取得できます。たとえば、Gears の URL が https://demo.us-1.evergage.com/ の場合、インスタンス識別子は us-1 です。
データセット識別子
必須項目です。 送信先の Interaction Studio データセットの名前/識別子を入力します。
API キー ID
必須項目です。 API トークンを生成するために使用される API キー ID を入力します。
API トークンについての詳細は、Salesforce パーソナライゼーションナレッジベースの API トークンドキュメントを参照してください。
API キーのシークレット
必須項目です。 API トークンを生成するために使用される API キーのシークレットを入力します。
API トークンについての詳細は、Salesforce パーソナライゼーションナレッジベースの API トークンドキュメントを参照してください。

コネクタの構成が完了したら、Done をクリックします。

アクションの構成 — パラメータとオプション

Continue をクリックして、コネクタのアクションを構成します。アクションの名前を入力し、ドロップダウンメニューからアクションのタイプを選択します。

以下のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション — 信頼されたチャネルを介してイベントデータを送信する (SalesforceInteractions 名前空間)

パラメータ

パラメータ	説明
Explain	`true` の場合、キャンペーンがレンダリングされたかどうかに関する追加情報をレスポンスに返します。
Page View	`true` の場合、イベントがページの読み込みからトリガーされたことを示します。
Time	UNIX エポックからの経過時間（ミリ秒単位）でイベントの日時を指定します。このフィールドはオプションで、null の場合は現在の時刻が自動的に入力されます。
Interaction Type	インタラクションのタイプを選択します。カタログオブジェクトインタラクション - カタログオブジェクトに関するエンゲージメントデータをキャプチャします。カートインタラクション - ユーザーのカートの内容に関するエンゲージメントデータをキャプチャします。オーダーインタラクション - ユーザーの注文に関するエンゲージメントデータをキャプチャします。パーソナライゼーションでは、PurchaseOrderInteraction のみがユーザーの現在の注文に影響を与えて更新されます。
Interaction Name	インタラクションの名前を選択します。選択した Interaction Type に応じて名前が表示されます。
ID	カタログオブジェクトを表す一意の ID。
Type	カタログオブジェクトを表すタイプ名。
Catalog Object Attributes	Interaction Type セクションで選択したタイプが Catalog Object Interaction でない場合、このセクションは無視されます。 Catalog Object Attributes は、カタログオブジェクトのメタデータとして保存されるキーと値のペアです。これらの属性はプラットフォームで定義する必要があります。 Salesforce Interaction Studio の Event API ドキュメントを参照して使用例を確認してください。ネストされたオブジェクトのサポートが必要な場合は、Templates セクションを使用してテンプレートを定義できます。テンプレートは、一致する二重中括弧で参照されることでマッピングされます：`{{template_name}}`。
Related Catalog Objects	Interaction Type セクションで選択したタイプが Catalog Object Interaction でない場合、このセクションは無視されます。関連するカタログオブジェクトのキーと値のペア。これらの関連するカタログオブジェクトはプラットフォームで定義する必要があります。 Salesforce Interaction Studio の Event API ドキュメントを参照して使用例を確認してください。
Cart Data	Interaction Type セクションで選択したタイプが Cart Interaction でない場合、このセクションは無視されます。このタイプのインタラクションは、ユーザーのカートの内容に関するエンゲージメントデータをキャプチャするために使用されます。 Salesforce Interaction Studio の Event API ドキュメントを参照して使用例を確認してください。ネストされたオブジェクトのサポートが必要な場合は、Templates セクションを使用してテンプレートを定義できます。テンプレートは、一致する二重中括弧で参照されることでマッピングされます： `{{template_name}}`。
Catalog Object ID	カタログオブジェクトを表す一意の ID。
Catalog Object Type	カタログオブジェクトを表すタイプ。
Currency	購入の通貨コード（オプション）。null の場合はデータセットの構成された通貨がデフォルトになります。
Price	ラインアイテムのカタログオブジェクトの価格。
Quantity	ラインアイテムのカタログオブジェクトの数。
Cart Line Items Attributes	Interaction Type セクションで選択したタイプが Cart Interaction でない場合、このセクションは無視されます。 Cart Line Items Attributes は、ラインアイテムオブジェクトのメタデータとして保存されるキーと値のペアです。これらの属性はプラットフォームで定義する必要があります。Salesforce Interaction Studio の Event API ドキュメントを参照してオブジェクトの構造を確認してください。複数のアイテムを追加するためには、配列型の属性を提供します。配列型の属性は同じ長さである必要があります。 Cart Line Items Attributes の配列と Cart Line Items の配列は同じ長さである必要があります。単一の値属性を使用することもでき、それは各アイテムに適用されます。
Cart Line Items Template Variables	Cart Line Items Template のデータ入力としてテンプレート変数を提供します。使用例については、テンプレート変数ガイドドキュメントを参照してください。ネストされたテンプレート変数は、ドット表記法で名前を付けます。たとえば、`items.name` のようにします。ネストされたテンプレート変数は、通常、データレイヤーのリスト属性から構築されます。
Cart Line Items Template	Interaction Type セクションで選択したタイプが Cart Interaction でない場合、このセクションは無視されます。ネストされたオブジェクトのサポートが必要な場合は、このセクションを使用してテンプレートを定義します。テンプレートは、Interaction Name セクションで Add To Cart または Remove From Cart の値が選択されている場合は JSON オブジェクト形式を想定します。それ以外の場合は JSON 配列形式を想定します。テンプレートが定義されている場合、Cart Line Items および Cart Line Items Attributes セクションの構成は無視されます。 Cart Line Items Template Variables セクションでマッピングされたテンプレート変数を使用できます。詳細については、テンプレートガイドドキュメントを参照してください。
Order ID	購入した注文の ID。
Currency	購入の通貨コード。
Total Value	購入の合計金額。
Order Attributes	Interaction Type セクションで選択したタイプが Order Interaction でない場合、このセクションは無視されます。 Order Attributes は、注文オブジェクトのメタデータとして保存されるキーと値のペアです。これらの属性はプラットフォームで定義する必要があります。 Salesforce Interaction Studio の Event API ドキュメントを参照して使用例を確認してください。ネストされたオブジェクトのサポートが必要な場合は、Templates セクションを使用してテンプレートを定義できます。テンプレートは、一致する二重中括弧で参照されることでマッピングされます：`{{template_name}}`。
Catalog Object ID	カタログオブジェクトを表す一意の ID。
Catalog Object Type	カタログオブジェクトを表すタイプ。
Currency	購入の通貨コード（オプション）。null の場合はデータセットの構成された通貨がデフォルトになります。
Price	ラインアイテムのカタログオブジェクトの価格。
Quantity	ラインアイテムのカタログオブジェクトの数。