この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

サイトマップ

Salesforce Interactions SDK サイトマップでは、ページナビゲーション中にデータを抽出することができます。また、複数のページでデータキャプチャロジックを共有したり、データキャプチャロジックを Web ページプレゼンテーションロジックから切り離したりできます。

サイトマップは、Web SDK の初期化直後に設定することができます。一般的なパターンを次に示します。

サイトマップの各セクションで次を定義できます。

複数の 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	FieldType `(event: ActionEvent) => ActionEvent` 説明 `ActionEvent` オブジェクトが Web SDK に渡されるときに実行されるコールバック。このコールでは、送信前にイベントのプロパティを挿入または変更するためのフックが提供されます。

DefaultPageConfig

デフォルトページ設定は、登録された PageConfig に一致するものが対象の Web ページで見つからない場合に有効化されます。

項目名	説明
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 があるとします。

正規 href の値を抽出するには、次のコードを使用できます。

HTML ドキュメントの Location オブジェクトからの href 値の抽出

HTML ドキュメントの Location オブジェクトから href 値を抽出するリゾルバーを作成します。Transform は、解決された値を新しい値に変換する省略可能な関数です。

たとえば、次の URL に HTML ドキュメントがあるとします。

href を抽出するには、次のコードを使用できます。

最初の要素からのコンテンツ属性の抽出

HTML ドキュメント内で対象の itemprop 属性値に一致する最初の要素から content 属性を抽出するリゾルバーを作成します。

引数:

itemProp — 照合する itemprop 属性の値
transform — 解決された値を新しい値に変換する省略可能な関数

たとえば、次のような HTML があるとします。

JSON Linked Data の抽出

HTML ドキュメント内で application/ld+json の type 属性を持つ最初の <script> 要素から JSON Linked Data (JSON-LD) を抽出するリゾルバーを作成します。

引数:

path — 取得するプロパティのパス
transform — 解決された値を新しい値に変換する省略可能な関数

たとえば、次のような HTML があるとします。

最初のメタ要素からのコンテンツ属性の抽出

HTML ドキュメント内で特定の name 属性に一致する最初の <meta> 要素から content 属性を抽出するリゾルバーを作成します。

引数:

name — 照合する name 属性の値
transform — 解決された値を新しい値に変換する省略可能な関数

たとえば、次のような HTML があるとします。

最初の要素からのテキストの抽出

HTML ドキュメント内で特定の CSS セレクターに一致する最初の要素からテキストを抽出するリゾルバーを作成します。

引数:

selector — 照合する対象の CSS セレクター
transform — 解決された値を新しい値に変換する省略可能な関数

たとえば、次のような HTML があるとします。

各 <h1> 要素のテキストを抽出するには、次のコードを使用できます。

最初の要素からのテキストの抽出

HTML ドキュメント内で特定の CSS セレクターに一致する各要素からテキストを抽出するリゾルバーを作成します。

引数:

selector — 照合する対象の CSS セレクター
transform — 解決された値を新しい値に変換する省略可能な関数

たとえば、次のような HTML があるとします。

各 <h1> 要素のテキストを抽出するには、次のコードを使用できます。

最初の要素からの対象属性の値の抽出

HTML ドキュメント内で特定の CSS セレクターに一致する最初の要素から対象属性の値を抽出するリゾルバーを作成します。

引数:

selector — 照合する対象の CSS セレクター
attribute — 値の取得元である対象属性
transform — 解決された値を新しい値に変換する省略可能な関数

たとえば、次のような HTML があるとします。

data-id 属性の値を抽出するには、次のコードを使用できます。

対象属性の値の抽出

HTML ドキュメント内で特定の CSS セレクターに一致する各要素から対象属性の値を抽出するリゾルバーを作成します。

引数:

selector — 照合する対象の CSS セレクター
attribute — 値の取得元である対象属性
transform — 解決された値を新しい値に変換する省略可能な関数

たとえば、次のような HTML があるとします。

各 data-id 属性の値を抽出するには、次のコードを使用できます。

オブジェクトの値の抽出

window オブジェクトに付加されているオブジェクト (通常はグローバル変数) の値を抽出するリゾルバーを作成します。

引数:

path — window オブジェクト内のオブジェクトへのパスを表す文字列。ドット表記を使用します。
transform — 解決された値を新しい値に変換する省略可能な関数

たとえば、次のような window オブジェクトがあるとします。

shop グローバルオブジェクトからデータを抽出するには、次のコードを使用できます。

Data Cloud リファレンスガイド

サイトマップ

GlobalPageConfig

DefaultPageConfig

PageConfig

サイトマップメソッド