Commerceのデータ取り込みに対する時系列イベントスキーマの更新
Data Connection 拡張機能を使用するための オンボーディング手順の 1 つは、データストリームワークスペースにアクセスし、Adobe Commerceに固有の データストリームを作成することです。 そのデータストリームを作成する際は、取り込む予定のデータを記述したスキーマも選択する必要があります。 このスキーマには、コマース固有のフィールドグループを含める必要があります。
この記事では、Adobe Commerce イベントで提供される次の時系列データを正常に収集するために、スキーマに含める必要があるフィールドグループについて説明します。
詳しくは、 時系列データを参照してください。
詳しくは、 スキーマ構成の基本を参照してください。
時系列の行動およびバックオフィスイベントデータを使用したスキーマの更新
この節では、既存のスキーマを更新する方法や、行動およびバックオフィスイベントデータを含むスキーマを作成する方法について説明します。
-
スキーマがまだない場合は、Experience Event に設定されたクラスを持つ create スキーマを使用します。
-
次のCommerce固有のフィールドグループを 追加します(または、既存のスキーマを編集して、これらのフィールドグループを追加します)。
- サイト検索
- Web ページを訪問
- ユーザーログインプロセス
- 参照キー
- 個人の連絡先の詳細
- チャネルの詳細
- Commerceの詳細
- Adobe Analytics ExperienceEvent Commerce(Adobe Analyticsにデータを送信する場合)
note note NOTE Commerce固有のフィールドグループを Primary identity
のように設定しないでください。 これにより、フィールドが必須として特定され、Experience Platformはすべてのイベントでそのフィールドを使用することを想定します。 このフィールドが存在しない場合、データ取り込みは失敗します。Commerce 行動および バックオフィスイベントから収集された時系列データがスキーマに表されるように、スキーマにCommerce固有のフィールドグループが含まれるようになりました。
-
プロファイルのスキーマ 🔗 有効 。
スキーマがプロファイルで有効になっている場合、このスキーマから作成されたデータセットは、異なるソースのデータを結合して各顧客の全体像を構築するReal-Time CDPに関与します。
-
作成または更新したスキーマに基づいて データセットを作成します。
データセットは、データのコレクションのためのストレージおよび管理用の構成体で、通常は、スキーマ(列)とフィールド(行)を含むテーブルです。 データセットには、保存するデータの様々な側面を記述したメタデータも含まれます。
-
データストリームを作成し、Commerce固有のフィールドグループと対応するデータセットを含むスキーマを選択します。
データストリームは、収集したデータをデータセットに転送します。 データは、選択したスキーマに基づいてデータセット内で表されます。
行動データやバックオフィスデータ用に設定されたスキーマ、データセット、データストリームを使用すると、データを収集してExperience Platformに送信するようにCommerce インスタンスを 設定できます。
買い物客のプロファイル情報を含めるには、 時系列プロファイルイベントデータを参照してください。
カスタム属性の追加
カスタム属性は、カスタムのバックオフィスイベントデータをCommerce インスタンスからExperience Platformに渡す場合に使用できます。
カスタム属性は、次の 2 つのレベルでサポートされます。
- 注文レベル
- 注文品目レベル
-
Commerce アプリケーションに追加のモジュールを追加して有効にします。 次の 例を参照してください。
追加のカスタム属性を公開するには、サンプルコードを変更する必要があります。 実装は、これらの属性が保存される場所と、属性の抽出に必要なロジックによって異なります。
-
既存の XDM スキーマを拡張する。 注文および注文品目レベルのカスタム属性を作成するには、次の ガイドを参照してください。 テナント ID フィールドは動的に生成されますが、フィールド構造は提供された例に類似している必要があります。
note important IMPORTANT XDM カスタム属性は、Commerce から送信された属性と一致する必要があります。 -
XDM スキーマに関連付けられたデータストリームが、「 データ収集」タブで指定されたデータストリームと同じであることを確認します。
-
データ収集 タブの Save をクリックして、指定したカスタム属性を取得します。
時系列プロファイルイベントデータ
時系列プロファイルイベントデータは、次のイベントから生成されます。
顧客のプロファイルイベントデータをスキーマに取り込む場合は、既存のCommerce Experience Platformを更新し、設定済みの同じデータストリームを使用するか、プロファイル固有のデータストリームとスキーマを作成できます。 この決定は、会社のデータガバナンスに基づいています。 次の 2 つの節では、どちらの場合についても説明します。
既存のデータストリームを使用して、時系列プロファイルイベントデータをExperience Platformに送信する
時系列 サーバーサイドのプロファイルイベントデータを既存のCommerce データストリームに追加する場合は、スキーマに Demographic Details
フィールドグループを追加します。 スキーマには、次のCommerce固有のフィールドグループが含まれるようになりました。
- サイト検索
- Web ページを訪問
- ユーザーログインプロセス
- 参照キー
- 個人の連絡先の詳細
- チャネルの詳細
- Commerceの詳細
- Adobe Analytics ExperienceEvent Commerce(Adobe Analyticsにデータを送信する場合)
- 新規:人口統計の詳細
既存のCommerce スキーマに Demographic Details
フィールドグループを追加すると、この時系列プロファイルデータには、Commerce スキーマに既に関連付けられているデータセットとデータストリームが使用されます。
時系列プロファイルイベントデータを別のデータストリームでExperience Platformに送信する
サーバーサイドのプロファイルイベントデータを新しいプロファイル固有のデータストリームおよびスキーマに追加する場合は、次の手順を実行します。
-
作成スキーマを作成し、クラスを エクスペリエンスイベント に設定します。
-
追加次のプロファイル固有のフィールドグループ:
- 人口統計の詳細
- 個人の連絡先の詳細
- チャネルの詳細
- Commerceの詳細
-
プロファイルのスキーマ 🔗 有効 。
スキーマがプロファイルで有効になっている場合、このスキーマから作成されたデータセットは、異なるソースのデータを結合して各顧客の全体像を構築するReal-Time CDPに関与します。
-
作成したスキーマに基づいて データセットを作成します。
データセットは、データのコレクションのためのストレージおよび管理用の構成体で、通常は、スキーマ(列)とフィールド(行)を含むテーブルです。 データセットには、保存するデータの様々な側面を記述したメタデータも含まれます。
-
データストリームを作成し、Commerce固有のフィールドグループと対応するデータセットを含む XDM スキーマを選択します。
データストリームは、収集したデータをデータセットに転送します。 データは、選択したスキーマに基づいてデータセット内で表されます。
顧客プロファイルデータ用に設定されたスキーマ、データセット、データストリームを使用すると、データを収集してExperience Platformに送信するようにCommerce インスタンスを 設定できます。
プロファイルレコードデータのスキーマ、データセット、データストリームを作成するには、 プロファイルレコードデータのExperience Platformへの送信を参照してください。