Data Cloud 開発者ガイド
jサイトマップ
- 複数の listener。ページで実行された特定の顧客イベントを取得します。
- onActionEvent フック。これを使用してデータを傍受し、取得したデータを変更できます。
- name。ページ設定を識別します。
- ページで取得する locale。
- interaction。ページの読み込み後に取得します。
GlobalPageConfig
global 設定は、対象の Web ページに適用される PageConfig または DefaultPageConfig にマージされます。対象の Web ページに一致する設定がない場合、global 設定は適用されません。
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| listeners | listener | SalesforceInteractions.listener 関数を使用して作成されたイベントリスナーの配列。このイベントは、Web SDK を介したイベントの送信をトリガする顧客インタラクションをリスンします。 |
| locale | string | ISO 639 Alpha-2 言語コードと ISO 3166 Alpha-2 国コードで表される現在のページのロケール。例: en_US、de_DE |
| onActionEvent | (event: ActionEvent) => ActionEvent | ActionEvent オブジェクトが Web SDK に渡されるときに実行されるコールバック。このコールでは、送信前にイベントのプロパティを挿入または変更するためのフックが提供���れます。 |
DefaultPageConfig
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| listeners | listener | SalesforceInteractions.listener 関数を使用して作成されたイベントリスナーの配列。このイベントは、Web SDK を介したイベントの送信をトリガする顧客インタラクションをリスンします。 |
| locale | string | ISO 639 Alpha-2 言語コードと ISO 3166 Alpha-2 国コードで表される現在のページのロケール。例: en_US、de_DE |
| name | string | デフォルトページ設定を識別する名前。 |
| onActionEvent | (event:ActionEvent) => ActionEvent | ActionEvent オブジェクトが Web SDK に渡されるときに実行されるコールバック。このコールでは、送信前にイベントのプロパティを挿入または変更するためのフックが提供されます。 |
PageConfig
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| interaction | カートインタラクション | カタログインタラクション | 注文インタラクション | ページから取得するインタラクション。ページ設定が一致すると、この項目が自動的に抽出されて送信されます。サイトマップの設定時に、抽出するデータが完全にレンダリングされていないことがあるため、静的値または関数でラップされた値を指定して、値を後で評価するようにします。 |
| isMatch | () => Boolean | 必須。特定のページ設定を適用するかどうかをテストする関数。 |
| listeners | listener | SalesforceInteractions.listener 関数を使用して作成されたイベントリスナーの配列。このイベントは、Web SDK を介したイベントの送信をトリガする顧客インタラクションをリスンします。 |
| locale | string | ISO 639 Alpha-2 言語コードと ISO 3166 Alpha-2 国コードで表される現在のページのロケール。例: en_US、de_DE |
| name | string | 必須。ページ設定を識別する一意の名前。 |
| onActionEvent | (event:ActionEvent) => ActionEvent | ActionEvent オブジェクトが Web SDK に渡されるときに実行されるコールバック。このコールでは、送信前にイベントのプロパティを挿入または変更するためのフックが提供されます。 |
サイトマップメソッド
| 項目名 | 型 | 説明 |
|---|---|---|
| global | GlobalPageConfig | 必須。global 設定は、対象の Web ページに適用される PageConfig または DefaultPageConfig にマージされます。対象の Web ページに一致する設定がない場合、global 設定は適用されません。 |
| pageTypes | PageConfig[] | 必須。指定された、対象の Web ページの条件に一致するページでデータ収集ルールを実行するかどうかを指定するページ設定の配列。複数のページ設定が 1 つのページに一致する可能性があります。これらの設定は GlobalPageConfig (提供されている場合) と共にまとめてマージされます。 |
| pageTypeDefault | DefaultPageConfig | デフォルトページ設定は、登録された PageConfig に一致するものが対象の Web ページで見つからない場合に有効化されます。 |
HTML ドキュメントからの正規リンクの抽出
HTML ドキュメントから正規リンクを抽出するリゾルバを作成します。Transform は、解決された値を新しい値に変換する省略可能な関数です。
HTML ドキュメントの Location オブジェクトからの Href 値の抽出
HTML ドキュメントの Location オブジェクトから href 値を抽出するリゾルバを作成します。Transform は、解決された値を新しい値に変換する省略可能な関数です。
最初の要素からのコンテンツ属性の抽出
HTML ドキュメント内で対象の itemprop 属性値に一致する最初の要素から content 属性を抽出するリゾルバを作成します。
引数:
- itemProp - 照合する itemprop 属性の値
- transform - 解決された値を新しい値に変換する省略可能な関数
JSON Linked Data の抽出
HTML ドキュメント内で application/ld+json の type 属性を持つ最初の <script> 要素から JSON Linked Data (JSON-LD) を抽出するリゾルバを作成します。
引数:
- path - 取得するプロパティのパス
- transform - 解決された値を新しい値に変換する省略可能な関数
最初のメタ要素からのコンテンツ属性の抽出
HTML ドキュメント内で特定の name 属性に一致する最初の <meta> 要素から content 属性を抽出するリゾルバを作成します。
引数:
- name - 照合する name 属性の値
- transform - 解決された値を新しい値に変換する省略可能な関数
最初の要素からのテキストの抽出
HTML ドキュメント内で特定の CSS セレクタに一致する最初の要素からテキストを抽出するリゾルバを作成します。
引数:
- selector - 照合する対象の CSS セレクタ
- transform - 解決された値を新しい値に変換する省略可能な関数
最初の要素からのテキストの抽出
HTML ドキュメント内で特定の CSS セレクタに一致する各要素からテキストを抽出するリゾルバを作成します。
引数:
- selector - 照合する対象の CSS セレクタ
- transform - 解決された値を新しい値に変換する省略可能な関数
最初の要素からの対象属性の値の抽出
HTML ドキュメント内で特定の CSS セレクタに一致する最初の要素から対象属性の値を抽出するリゾルバを作成します。
引数:
- selector - 照合する対象の CSS セレクタ
- attribute - 値の取得元である対象属性。
- transform - 解決された値を新しい値に変換する省略可能な関数
対象属性の値の抽出
HTML ドキュメント内���特定の CSS セレクタに一致する各要素から対象属性の値を抽出するリゾルバを作成します。
引数:
- selector - 照合する対象の CSS セレクタ
- attribute - 値の取得元である対象属性。
- transform - 解決された値を新しい値に変換する省略可能な関数
オブジェクトの値の抽出
window オブジェクトに付加されているオブジェクト (通常はグローバル変数) の値を抽出するリゾルバを作成します。
引数:
- path - window オブジェクト内のオブジェクトへのパスを表す文字列。ドット表記を使用します。
- transform - 解決された値を新しい値に変換する省略可能な関数