Salesforce Marketing Cloud Personalization(Interaction Studio)コネクタ構成ガイド
この記事では、Salesforce Marketing Cloud Personalization(Interaction Studio)コネクタの構成方法について説明します。
API 情報
このコネクタは、次のベンダー API を使用します。
- API 名:Personalization Event API
- API バージョン:v2
- ドキュメント:Personalization Event API
コネクタアクション
| アクション名 | 訪問プロファイル | イベントデータ |
|---|---|---|
| 信頼済みチャネル経由でイベントデータを送信(SalesforceInteractions 名前空間) | ✓ | ✓ |
| 信頼済みチャネル経由でイベントデータを送信(Evergage 名前空間) | ✓ | ✓ |
構成の構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。
コネクタを追加したら、次の構成を構成します。
- アカウント名
(必須)Marketing Cloud Personalization のアカウント名。
アカウント名を確認するには、Salesforce の Interaction Studio UI から Gears にアクセスし、URL を確認します。たとえば、Gears の URL がhttps://demo.us-1.evergage.com/の場合、アカウント名はdemoです。 - インスタンス識別子
(必須)Marketing Cloud Personalization のインスタンス識別子。
インスタンス識別子を確認するには、Salesforce の Interaction Studio UI から Gears にアクセスし、URL を確認します。たとえば、Gears の URL がhttps://demo.us-1.evergage.com/の場合、インスタンス識別子はus-1です。 - データセット識別子
(必須)データの送信先となる Marketing Cloud Personalization データセットの名前または識別子。 - API キー ID
(必須)API トークンの生成に使用する API キー ID。
API トークンの詳細については、Salesforce:Personalization API Tokensを参照してください。 - API キーシークレット
(必須)API トークンの生成に使用する API キーシークレット。
API トークンの詳細については、Salesforce:Personalization API Tokensを参照してください。
コネクタの構成が完了したら、完了をクリックします。
アクション構成 — パラメータとオプション
続行をクリックして、コネクタアクションを構成します。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションを構成する方法について説明します。
アクション — 信頼済みチャネル経由でイベントデータを送信(SalesforceInteractions 名前空間)
イベントデータのパラメータ
| パラメータ | 説明 |
|---|---|
| Explain | true の場合、キャンペーンがレンダリングされた、またはレンダリングされなかった理由に関する追加情報をレスポンスで返します。 |
| Page View | 値が true の場合、ページの読み込みによってイベントがトリガーされたことを示します。 |
| Time | (任意)UNIX エポックからイベント発生時までの経過時間を表す日時(ミリ秒単位)。このフィールドが null の場合は、現在時刻が自動的に入力されます。 |
インタラクションタイプのパラメータ
| パラメータ | 説明 |
|---|---|
| Interaction Type | インタラクションタイプを選択します。 Catalog Object Interaction:カタログオブジェクトに関するエンゲージメントデータを取得します。 Cart Interaction:ユーザーのカート内容に関するエンゲージメントデータを取得します。 Order Interaction:ユーザーの注文内のアイテムに関するエンゲージメントデータを取得します。Personalization では、PurchaseOrderInteraction のみがユーザーの現在の注文に影響を与え、その注文を更新します。 |
インタラクション名のパラメータ
| パラメータ | 説明 |
|---|---|
| Interaction Name | インタラクション名を選択します。選択した Interaction Type に応じた名前が表示されます。 |
カタログオブジェクトデータのパラメータ
| パラメータ | 説明 |
|---|---|
| ID | カタログオブジェクトを表す一意の ID。 |
| Type | カタログオブジェクトを表すタイプ名。 |
カタログオブジェクト属性のパラメータ
| パラメータ | 説明 |
|---|---|
| Catalog Object Attributes | Interaction Type セクションで選択したタイプが Catalog Object Interaction でない場合、このセクションは無視されます。 キーと値のペアは、カタログオブジェクトのメタデータとして保存されます。これらの属性は、プラットフォームで定義されている必要があります。 詳細および使用例については、Salesforce:Marketing Cloud Personalization Event APIを参照してください。 ネストされたオブジェクトをサポートする必要がある場合は、Templates セクションを使用してテンプレートを定義できます。テンプレートは、その名前を対応する二重中括弧で囲んで参照し、マッピングする必要があります: {{template_name}}。 |
関連カタログオブジェクトのパラメータ
| パラメータ | 説明 |
|---|---|
| Related Catalog Objects | Interaction Type セクションで選択したタイプが Catalog Object Interaction でない場合、このセクションは無視されます。関連カタログオブジェクトは、キーと値のペアで構成されるオブジェクトの配列として指定します。これらの関連カタログオブジェクトは、プラットフォームで定義されている必要があります。詳細および使用例については、Salesforce:Marketing Cloud Personalization Event APIを参照してください。 |
カートデータのパラメータ
| パラメータ | 説明 |
|---|---|
| Cart Data | Interaction Type セクションで選択したタイプが Cart Interaction でない場合、このセクションは無視されます。このタイプのインタラクションは、ユーザーのカート内容に関するエンゲージメントデータを取得します。詳細および使用例については、Salesforce:Marketing Cloud Personalization Event APIを参照してください。ネストされたオブジェクトをサポートする必要がある場合は、Templates セクションを使用してテンプレートを定義できます。テンプレート名を対応する二重中括弧で囲んで参照します:{{template_name}}。 |
カートデータの明細項目パラメータ
| パラメータ | 説明 |
|---|---|
| Catalog Object ID | カタログオブジェクトを表す一意の ID。 |
| Catalog Object Type | カタログオブジェクトを表すタイプ。 |
| Currency | (任意)購入時の通貨コード。値が null の場合、データセットに構成されている通貨がデフォルト値になります。 |
| Price | 明細項目内のカタログオブジェクトの価格。 |
| Quantity | 明細項目内のカタログオブジェクトの数量。 |
カート明細項目属性のパラメータ
| パラメータ | 説明 |
|---|---|
| Cart Line Items Attributes | Interaction Type セクションで選択したタイプが Cart Interaction でない場合、このセクションは無視されます。 キーと値のペアは、明細項目オブジェクトのメタデータとして保存されます。これらの属性は、プラットフォームで定義されている必要があります。詳細およびオブジェクト構造については、Salesforce:Event API Requestsを参照してください。 複数のアイテムを追加するには、配列型の属性を指定します。配列型の属性は、すべて同じ長さである必要があります。 Cart Line Items Attributes 配列と Cart Line Items 配列は、同じ長さである必要があります。 単一値の属性も使用でき、その場合は各アイテムに適用されます。 |
カート明細項目テンプレート変数のパラメーター
| パラメーター | 説明 |
|---|---|
| カート明細項目テンプレート変数 | カート明細項目テンプレートへのデータ入力としてテンプレート変数を指定します。 詳細と使用例については、コネクターテンプレート変数を参照してください。 ネストされたテンプレート変数には、ドット表記を使用して名前を付けます。例: items.name。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から作成されます。 |
カート明細項目テンプレートのパラメーター
| パラメーター | 説明 |
|---|---|
| カート明細項目テンプレート | インタラクションタイプセクションで選択したタイプがカートインタラクションでない場合、このセクションは無視されます。 ネストされたオブジェクトをサポートする必要がある場合は、このセクションを使用してテンプレートを定義します。 インタラクション名セクションでカートに追加またはカートから削除の値が選択されている場合、テンプレートにはJSONオブジェクト形式が必要です。それ以外の場合、テンプレートにはJSON配列形式が必要です。 テンプレートが定義されている場合、カート明細項目およびカート明細項目属性セクションの構成は無視されます。 カート明細項目テンプレート変数セクションでマッピングしたテンプレート変数を使用できます。 詳細については、コネクタテンプレートについてを参照してください。 |
注文データのパラメーター
| パラメーター | 説明 |
|---|---|
| 注文ID | 購入された注文のID。 |
| 通貨 | 購入通貨のコード。 |
| 合計金額 | 購入の合計金額。 |
注文属性のパラメーター
| パラメーター | 説明 |
|---|---|
| 注文属性 | インタラクションタイプセクションで選択したタイプが注文インタラクションでない場合、このセクションは無視されます。 キーと値のペアは、注文オブジェクトのメタデータとして保存されます。これらの属性はプラットフォームで定義されている必要があります。 詳細と使用例については、Salesforce:Marketing Cloud Personalization Event APIを参照してください。 ネストされたオブジェクトをサポートする必要がある場合は、テンプレートセクションを使用してテンプレートを定義できます。テンプレート名を対応する二重波括弧で囲んで参照することにより、テンプレートをマッピングする必要があります: {{template_name}}。 |
注文明細項目のパラメーター
| パラメーター | 説明 |
|---|---|
| カタログオブジェクトID | カタログオブジェクトを表す一意のID。 |
| カタログオブジェクトタイプ | カタログオブジェクトを表すタイプ。 |
| 通貨 | (任意)購入通貨のコード。値がnullの場合、データセットに構成されたデフォルトの通貨が使用されます。 |
| 価格 | 明細項目内のカタログオブジェクトの価格。 |
| 数量 | 明細項目内のカタログオブジェクトの数。 |
注文明細項目属性のパラメーター
| パラメーター | 説明 |
|---|---|
| 注文明細項目属性 | インタラクションタイプセクションで選択したタイプが注文インタラクションでない場合、このセクションは無視されます。 キーと値のペアは、明細項目オブジェクトのメタデータとして保存されます。これらの属性はプラットフォームで定義されている必要があります。詳細およびオブジェクト構造については、Salesforce:Event APIリクエストを参照してください。 複数の項目を追加するには、配列型の属性を指定します。配列型の属性は同じ長さである必要があります。 注文明細項目属性の配列と注文明細項目の配列は同じ長さである必要があります。 単一値の属性も使用でき、その場合は各項目に適用されます。 |
注文明細項目テンプレート変数のパラメーター
| パラメーター | 説明 |
|---|---|
| 注文明細項目テンプレート変数 | 注文明細項目テンプレートへのデータ入力としてテンプレート変数を指定します。 詳細と使用例については、コネクターテンプレート変数を参照してください。 ネストされたテンプレート変数には、ドット表記を使用して名前を付けます。例: items.name。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から作成されます。 |
注文明細項目テンプレートのパラメーター
| パラメーター | 説明 |
|---|---|
| 注文明細項目テンプレート | インタラクションタイプセクションで選択したタイプが注文インタラクションでない場合、このセクションは無視されます。 ネストされたオブジェクトをサポートする必要がある場合は、このセクションを使用してテンプレートを定義します。 テンプレートにはJSON配列形式が必要です。 テンプレートが定義されている場合、注文明細項目および注文明細項目属性セクションの構成は無視されます。 注文明細項目テンプレート変数セクションでマッピングしたテンプレート変数を使用できます。 詳細については、コネクタテンプレートについてを参照してください。 |
同意のパラメーター
| パラメーター | 説明 |
|---|---|
| プロバイダー | 同意プロバイダー。 |
| 目的 | 同意の目的。例:パーソナライゼーション。 |
| ステータス | 同意ステータス。例:オプトインまたはオプトアウト。 |
デバッグのパラメーター
| パラメーター | 説明 |
|---|---|
| テストメッセージ | イベント内で強制的に返すキャンペーンエクスペリエンスIDのカンマ区切りリスト。通常であればキャンペーンが返されない原因となるルールは無視されます。代わりに、文字列値trueを使用すると、テストモードのすべてのキャンペーンを返すことができますが、その場合はすべてのルールが適用されます。 |
フラグのパラメーター
| パラメーター | 説明 |
|---|---|
| キャンペーンなし | trueの場合、レスポンスでキャンペーンを返しません。 |
| 非インタラクティブ | trueの場合、イベント内の指定されたユーザーについて訪問は作成(または更新)されません。また、そのユーザーについて訪問リファラーも元のリファラーも作成されません。 |
ソースのパラメーター
| パラメーター | 説明 |
|---|---|
| アプリケーション | イベントの発生元となるアプリケーションレベルのソース。例:ReactApp、3rdParty、ReactNative。 |
| チャネル | イベントの発生元ソース。例:Web、MobileApp、CallCenter。 |
| クライアントIP | イベントを送信するIPアドレス。clientIpは自動的に構成されますが、必要に応じて上書きできます。 |
| 構成バージョン | SDKの構成のバージョン番号。 |
| コンテンツゾーン | 現在のページ上にあるコンテンツゾーンの配列。 |
| デバイス | モバイルイベントにのみ適用されます。 |
| ロケール | ISO 639 alpha-2言語コードおよびISO 3166 alpha-2国コードで定義された、現在のページのロケール。例:en_USおよびde_DE。 |
| オペレーティングシステム | モバイルイベントにのみ適用されます。 |
| オペレーティングシステムのバージョン | モバイルイベントにのみ適用されます。 |
| ページタイプ | イベントの送信元となるページのタイプ。例:PDP、Blog、Pricing。 |
| アンケートID | 送信されるアンケートのID。Survey Gearを通じて送信されるイベントでは自動的に構成されます。 |
| アンケート開始時刻 | 送信されるアンケートの開始時刻。Survey Gearを通じて送信されるイベントでは自動的に構成されます。 |
| URL | イベントの送信元となるページのURL。 |
| URLリファラー | ユーザーが直前にアクセスしたURL。Webでは、デフォルトでurlReferrerにdocument.referrerの値が構成されます。必要に応じて、サイトマップ内で他の任意の値に上書きできます。 |
| ユーザーエージェント | イベントのユーザーエージェント。userAgentは自動的に構成されますが、必要に応じて上書きできます。 |
ユーザーデータのパラメーター
| パラメーター | 説明 |
|---|---|
| 匿名ID | 匿名ユーザーのID。 |
| 暗号化ID | IDフィールドを含むイベントから返される暗号化されたID。ID情報を指定したイベントへのレスポンスで、暗号化IDが返されます。 |
ユーザー ID パラメータ
| パラメータ | 説明 |
|---|---|
| ユーザー ID | キーと値のペアがユーザーの ID 情報として保存されます。 詳細および使用例については、Salesforce:Event API Requestsを参照してください。 |
ユーザー属性パラメータ
| パラメータ | 説明 |
|---|---|
| ユーザー属性 | キーと値のペアがユーザーのメタデータとして保存されます。これらの属性は、プラットフォームで定義する必要があります。 詳細および使用例については、Salesforce:Marketing Cloud Personalization Event APIを参照してください。 ネストされたオブジェクトをサポートする必要がある場合は、テンプレートセクションでテンプレートを定義できます。テンプレートは、その名前を対応する二重中括弧で参照してマッピングする必要があります: {{template_name}}。 |
プロファイルオブジェクトテンプレート変数パラメータ
| パラメータ | 説明 |
|---|---|
| プロファイルオブジェクトテンプレート変数 | プロファイルオブジェクトテンプレートのデータ入力としてテンプレート変数を指定します。 詳細および使用例については、コネクターテンプレート変数を参照してください。 ネストされたテンプレート変数には、ドット表記を使用して名前を付けます。例: items.name。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から作成されます。 |
プロファイルオブジェクトテンプレートパラメータ
| パラメータ | 説明 |
|---|---|
| プロファイルオブジェクトテンプレート | ユーザーのメタデータとして保存されるプロファイルオブジェクトのキーと値のペアを送信するためのテンプレートを指定します。 プロファイルオブジェクト、その属性、および関連するカタログオブジェクトは、プラットフォームで定義する必要があります。詳細およびオブジェクト構造については、Salesforce:Event API Requestsを参照してください。 テンプレートには、有効な JSON オブジェクト形式を使用する必要があります。 プロファイルオブジェクトテンプレート変数セクションでマッピングしたテンプレート変数を使用できます。 詳細については、コネクタテンプレートについてを参照してください。 |
アカウントデータパラメータ
| パラメータ | 説明 |
|---|---|
| ID | アカウントの ID。 |
アカウント属性パラメータ
| パラメータ | 説明 |
|---|---|
| アカウント属性 | キーと値のペアがアカウントのメタデータとして保存されます。これらの属性は、プラットフォームで定義する必要があります。 詳細およびオブジェクト構造については、Salesforce:Event API Requestsを参照してください。 ネストされたオブジェクトをサポートする必要がある場合は、テンプレートセクションでテンプレートを定義できます。テンプレートは、その名前を対応する二重中括弧で参照してマッピングする必要があります: {{template_name}}。 |
パフォーマンス指標パラメータ
| パラメータ | 説明 |
|---|---|
| ネットワーク時間 | 直前のリクエストが返されるまでの時間(ミリ秒)。 |
| ページ読み込み時間 | DOM の読み込みにかかる時間(ミリ秒)。 |
| SDK 読み込み時間 | Web SDK をネットワーク経由で読み込むのにかかる時間(ミリ秒)。 |
| SDK 解析時間 | ページ読み込み中にビーコンが解析されるまでの時間(ミリ秒)。 |
CampaignStat 配列テンプレート変数パラメータ
| パラメータ | 説明 |
|---|---|
| CampaignStat 配列テンプレート変数 | CampaignStat 配列テンプレートのデータ入力としてテンプレート変数を指定します。 詳細および使用例については、コネクターテンプレート変数を参照してください。 ネストされたテンプレート変数には、ドット表記を使用して名前を付けます。例: items.name。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から作成されます。 |
CampaignStat 配列テンプレートパラメータ
| パラメータ | 説明 |
|---|---|
| CampaignStat 配列テンプレート | 関連付けられたイベントのキャンペーン統計を追跡するために使用する campaignStats 配列を送信するテンプレートを指定します。詳細およびオブジェクト構造については、Salesforce:Event API Requestsを参照してください。 テンプレートには、有効な JSON 配列形式を使用する必要があります。 CampaignStat 配列テンプレート変数セクションでマッピングしたテンプレート変数を使用できます。 テンプレートの詳細については、テンプレートガイドを参照してください。 |
テンプレート変数パラメータ
| パラメータ | 説明 |
|---|---|
| テンプレート変数 | テンプレートのデータ入力としてテンプレート変数を指定します。 使用例については、テンプレート変数ガイドを参照してください。 ネストされたテンプレート変数には、ドット表記を使用して名前を付けます。例: items.name。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から作成されます。 |
テンプレートパラメータ
| パラメータ | 説明 |
|---|---|
| テンプレート | イベントデータ、カタログオブジェクトデータ、カタログオブジェクト属性、カートデータ、注文データ、注文属性、デバッグ、フラグ、ソース、ユーザーデータ、ユーザー属性、アカウントデータ、アカウント属性、およびパフォーマンス指標の各セクションで参照するテンプレートを指定します。 テンプレートには、有効な JSON オブジェクト形式を使用する必要があります。 詳細については、コネクタテンプレートについてを参照してください。 テンプレートは、サポートされているフィールドに二重中括弧を使用して名前で挿入されます。例: {{SomeTemplateName}}。 |
アクション — 信頼済みチャネル経由でイベントデータを送信(Evergage 名前空間)
アイテムアクションパラメータ
| パラメータ | 説明 |
|---|---|
| アイテムアクション | カタログアイテムに対して実行されたアクションを選択します。 サポートされているアイテムアクションの詳細については、Salesforce:Item Actionsを参照してください。 |
イベントデータパラメータ
| パラメータ | 説明 |
|---|---|
| アクション | イベントの名前。セグメンテーション、ターゲティング、およびレポートに使用されます。 |
カタログデータパラメータ
| パラメータ | 説明 |
|---|---|
| アイテムタイプ | (必須)catalog オブジェクトを送信するアイテムのタイプを指定します。 |
注文データパラメータ
| パラメータ | 説明 |
|---|---|
| アイテムタイプ | (必須)order オブジェクトを送信するアイテムのタイプを指定します。 |
| 注文 ID | 購入された注文の ID。 |
| 通貨 | (任意)購入時の通貨コード。値が null の場合、デフォルト値はデータセットに構成された通貨です。 |
| 合計金額 | 購入の合計金額。デフォルト値は、各明細アイテムの価格に数量を掛けた値の合計です。 |
注文明細アイテムパラメータ
| パラメータ | 説明 |
|---|---|
| ID | アイテムの ID。 |
| 価格 | アイテムの価格。 |
| 数量 | アイテムの数。 |
カートデータパラメータ
| パラメータ | 説明 |
|---|---|
| アイテムタイプ | (必須)cart オブジェクトを送信するアイテムのタイプを指定します。 |
カート明細アイテムパラメータ
| パラメータ | 説明 |
|---|---|
| ID | アイテムの ID。 |
| 価格 | アイテムの価格。 |
| 数量 | アイテムの数。 |
同意パラメーター
| パラメーター | 説明 |
|---|---|
| プロバイダー | 同意プロバイダー。 |
| 目的 | 同意の目的。たとえば、パーソナライゼーション。 |
| ステータス | 同意ステータス。たとえば、OptIn または OptOut。 |
デバッグパラメーター
| パラメーター | 説明 |
|---|---|
| 説明 | true の場合、キャンペーンがレンダリングされた、またはされなかった理由に関する追加情報を応答で返します。 |
| テストメッセージ | イベントで強制的に返すキャンペーンエクスペリエンス ID のカンマ区切りリスト。キャンペーンが返されないようにする通常のルールは無視されます。または、文字列値 true を使用すると、テストモードのすべてのキャンペーンを返すことができますが、すべてのルールが適用されます。 |
フラグパラメーター
| パラメーター | 説明 |
|---|---|
| トラッキング拒否 | true の場合、イベントがサーバーに送信された後、そのイベントを処理しません。 |
| キャンペーンなし | true の場合、応答でキャンペーンを返しません。 |
| 非インタラクティブ | true の場合、イベント内の指定されたユーザーについて訪問は作成(または更新)されません。また、そのユーザーについて訪問リファラーも初回流入リファラーも作成されません。 |
| ページビュー | true の場合、イベントがページの読み込みによってトリガーされたことを示します。 |
ソースパラメーター
| パラメーター | 説明 |
|---|---|
| アプリケーション | イベントの発生元であるアプリケーションレベルのソース。たとえば、ReactApp、3rdParty、ReactNative。 |
| チャネル | イベントの発生元ソース。たとえば、Web、MobileApp、CallCenter。 |
| クライアント IP | イベントを送信する IP アドレス。clientIp は自動的に構成されますが、必要に応じて上書きできます。 |
| 構成バージョン | SDK の構成のバージョン番号。 |
| コンテンツゾーン | 現在のページ上のコンテンツゾーンの配列。 |
| デバイス | モバイルイベントにのみ適用されます。 |
| ロケール | ISO 639 alpha-2 言語コードおよび ISO 3166 alpha-2 国コードで定義された、現在のページのロケール。たとえば、en_US および de_DE。 |
| オペレーティングシステム | モバイルイベントにのみ適用されます。 |
| オペレーティングシステムのバージョン | モバイルイベントにのみ適用されます。 |
| ページタイプ | イベントの送信元ページのタイプ。たとえば、PDP、Blog、Pricing。 |
| アンケート ID | 送信されるアンケートの ID。Survey Gear を通じて送信されるイベントの場合は自動的に構成されます。 |
| アンケート開始時刻 | 送信されるアンケートの開始時刻。Survey Gear を通じて送信されるイベントの場合は自動的に構成されます。 |
| 時刻 | (任意)UNIX エポックからイベントまでの経過日時(ミリ秒単位)。このフィールドが null の場合、現在時刻が自動的に構成されます。 |
| URL | イベントの送信元ページの URL。 |
| URL リファラー | ユーザーが直前に訪問した URL。Web では、デフォルトで urlReferrer に document.referrer の値が構成されます。必要に応じて、サイトマップ内で任意の値に上書きできます。 |
| ユーザーエージェント | イベントのユーザーエージェント。userAgent は自動的に構成されますが、必要に応じて上書きできます。 |
暗号化 ID パラメーター
| パラメーター | 説明 |
|---|---|
| 暗号化 ID | ID フィールドを含むイベントから返される暗号化 ID。暗号化 ID は、user.id を指定したイベントへの応答で返されます。 |
| ID | 既知のユーザーの ID。 |
ユーザー属性パラメーター
| パラメーター | 説明 |
|---|---|
| ユーザー属性 | キーと値のペアがユーザーのメタデータとして保存されます。これらの属性はプラットフォームで定義する必要があります。 詳細および使用例については、Salesforce:Event API リクエストを参照してください。 ネストされたオブジェクトをサポートする必要がある場合は、テンプレートセクションを使用してテンプレートを定義できます。テンプレートは、対応する二重中括弧で囲んだ名前を参照することでマッピングする必要があります: {{template_name}}。 |
プロファイルオブジェクトテンプレート変数パラメーター
| パラメーター | 説明 |
|---|---|
| プロファイルオブジェクトテンプレート変数 | プロファイルオブジェクトテンプレートのデータ入力としてテンプレート変数を指定します。 詳細および使用例については、コネクターテンプレート変数を参照してください。 ネストされたテンプレート変数にはドット表記で名前を付けます。たとえば、 items.name。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から構築されます。 |
プロファイルオブジェクトテンプレートパラメーター
| パラメーター | 説明 |
|---|---|
| プロファイルオブジェクトテンプレート | ユーザーのメタデータとして保存されるプロファイルオブジェクトのキーと値のペアを送信するためのテンプレートを指定します。 プロファイルオブジェクト、その属性、および関連するカタログオブジェクトは、プラットフォームで定義する必要があります。詳細および使用例については、Salesforce:Event API リクエストを参照してください。 テンプレートには有効な JSON オブジェクト形式が必要です。 プロファイルオブジェクトテンプレート変数セクションでマッピングされたテンプレート変数を使用できます。 詳細については、コネクタテンプレートについてを参照してください。 |
アカウントデータパラメーター
| パラメーター | 説明 |
|---|---|
| ID | アカウントの ID。 |
アカウント属性パラメーター
| パラメーター | 説明 |
|---|---|
| アカウント属性 | キーと値のペアがアカウントのメタデータとして保存されます。これらの属性はプラットフォームで定義する必要があります。 詳細および使用例については、Salesforce:Event API リクエストを参照してください。 ネストされたオブジェクトをサポートする必要がある場合は、テンプレートセクションを使用してテンプレートを定義できます。テンプレートは、対応する二重中括弧で囲んだ名前を参照することでマッピングする必要があります: {{template_name}}。 |
パフォーマンスパラメーター
| パラメーター | 説明 |
|---|---|
| DOM 読み込み時間 | DOM の読み込みが完了するまでの時間(ミリ秒単位)。 |
| イベント DNS 時間 | アカウント固有のドメインを名前解決するための時間(ミリ秒単位)。 |
| ネットワーク時間 | 直前のリクエストに対する応答が返るまでの時間(ミリ秒単位)。 |
| ページ読み込み時間 | DOM の読み込みにかかる時間(ミリ秒単位)。 |
| SDK DNS 時間 | SDK の CDN ドメインを名前解決するための時間(ミリ秒単位)。 |
| SDK 読み込み時間 | ネットワークが Web SDK を読み込むための時間(ミリ秒単位)。 |
| SDK 解析時間 | ページ読み込み中にビーコンを解析するための時間(ミリ秒単位)。 |
CampaignStat 配列テンプレート変数パラメーター
| パラメーター | 説明 |
|---|---|
| CampaignStat 配列テンプレート変数 | CampaignStat 配列テンプレートのデータ入力としてテンプレート変数を指定します。 詳細および使用例については、コネクターテンプレート変数を参照してください。 ネストされたテンプレート変数にはドット表記で名前を付けます。たとえば、 items.name。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から構築されます。 |
CampaignStat 配列テンプレートパラメーター
| パラメーター | 説明 |
|---|---|
| CampaignStat 配列テンプレート | 関連付けられたイベントのキャンペーン統計を追跡するために使用される campaignStats 配列を送信するテンプレートを指定します。詳細および使用例については、Salesforce:Event API リクエストを参照してください。 テンプレートには有効な JSON 配列形式が必要です。 CampaignStat 配列テンプレート変数セクションでマッピングされたテンプレート変数を使用できます。 テンプレートの詳細については、テンプレートガイドを参照してください。 |
テンプレート変数のパラメーター
| パラメーター | 説明 |
|---|---|
| テンプレート変数 | テンプレートへのデータ入力としてテンプレート変数を指定します。 使用例については、テンプレート変数ガイドを参照してください。 ネストされたテンプレート変数には、ドット表記を使用して名前を付けます。例: items.name。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から構築されます。 |
テンプレートのパラメーター
| パラメーター | 説明 |
|---|---|
| テンプレート | イベントデータ、カタログデータ、注文データ、カートデータ、デバッグ、フラグ、ソース、ユーザーデータ、ユーザー属性、アカウントデータ、アカウント属性、およびパフォーマンスの各セクションで参照するテンプレートを指定します。 テンプレートには、有効なJSONオブジェクト形式を指定する必要があります。 詳細については、コネクタテンプレートについてを参照してください。 サポートされているフィールドには、二重波括弧を使用してテンプレート名を挿入します。例: {{SomeTemplateName}}。 |
最終更新日 :: 2026年November月10日