Commerceのデータ取り込みに対する時系列イベントスキーマの更新

Data Connection 拡張機能を使用するための オンボーディング手順の 1 つは、データストリームワークスペースにアクセスし、Adobe Commerceに固有の データストリームを作成することです。 そのデータストリームを作成する際は、取り込む予定のデータを記述したスキーマも選択する必要があります。 このスキーマには、コマース固有のフィールドグループを含める必要があります。

この記事では、Adobe Commerce イベントで提供される次の時系列データを正常に収集するために、スキーマに含める必要があるフィールドグループについて説明します。

  • 行動- ストアフロント、プロファイル、検索、B2B イベントが含まれます。
  • バックオフィス– 注文ステータスとプロファイルイベントが含まれます。

詳しくは、 時系列データを参照してください。

詳しくは、 スキーマ構成の基本を参照してください。

時系列の行動およびバックオフィスイベントデータを使用したスキーマの更新

この節では、既存のスキーマを更新する方法や、行動およびバックオフィスイベントデータを含むスキーマを作成する方法について説明します。

NOTE
プロファイル固有のフィールドを追加する方法については、 時系列プロファイルイベントデータを参照してください。
  1. スキーマがまだない場合は、Experience Event に設定されたクラスを持つ create スキーマを使用します。

  2. 次のCommerce固有のフィールドグループを 追加します(または、既存のスキーマを編集して、これらのフィールドグループを追加します)。

    • サイト検索
    • Web ページを訪問
    • ユーザーログインプロセス
    • 参照キー
    • 個人の連絡先の詳細
    • チャネルの詳細
    • Commerceの詳細
    • Adobe Analytics ExperienceEvent Commerce(Adobe Analyticsにデータを送信する場合)
    note note
    NOTE
    Commerce固有のフィールドグループを Primary identity のように設定しないでください。 これにより、フィールドが必須として特定され、Experience Platformはすべてのイベントでそのフィールドを使用することを想定します。 このフィールドが存在しない場合、データ取り込みは失敗します。

    Commerce 行動および バックオフィスイベントから収集された時系列データがスキーマに表されるように、スキーマにCommerce固有のフィールドグループが含まれるようになりました。

  3. プロファイルのスキーマ 🔗 有効 。

    スキーマがプロファイルで有効になっている場合、このスキーマから作成されたデータセットは、異なるソースのデータを結合して各顧客の全体像を構築するReal-Time CDPに関与します。

  4. 作成または更新したスキーマに基づいて データセットを作成します。

    データセットは、データのコレクションのためのストレージおよび管理用の構成体で、通常は、スキーマ(列)とフィールド(行)を含むテーブルです。 データセットには、保存するデータの様々な側面を記述したメタデータも含まれます。

  5. データストリームを作成し、Commerce固有のフィールドグループと対応するデータセットを含むスキーマを選択します。

    データストリームは、収集したデータをデータセットに転送します。 データは、選択したスキーマに基づいてデータセット内で表されます。

行動データやバックオフィスデータ用に設定されたスキーマ、データセット、データストリームを使用すると、データを収集してExperience Platformに送信するようにCommerce インスタンスを 設定できます。

買い物客のプロファイル情報を含めるには、 時系列プロファイルイベントデータを参照してください。

カスタム属性の追加

カスタム属性は、カスタムのバックオフィスイベントデータをCommerce インスタンスからExperience Platformに渡す場合に使用できます。

カスタム属性は、次の 2 つのレベルでサポートされます。

  • 注文レベル
  • 注文品目レベル
NOTE
Adobe Commerceでは、データタイプが文字列または文字列配列のカスタム属性をサポートしています。
  1. Commerce アプリケーションに追加のモジュールを追加して有効にします。 次の を参照してください。

    追加のカスタム属性を公開するには、サンプルコードを変更する必要があります。 実装は、これらの属性が保存される場所と、属性の抽出に必要なロジックによって異なります。

  2. 既存の XDM スキーマを拡張する。 注文および注文品目レベルのカスタム属性を作成するには、次の ガイドを参照してください。 テナント ID フィールドは動的に生成されますが、フィールド構造は提供された例に類似している必要があります。

    note important
    IMPORTANT
    XDM カスタム属性は、Commerce から送信された属性と一致する必要があります。
  3. XDM スキーマに関連付けられたデータストリームが、「 データ収集」タブで指定されたデータストリームと同じであることを確認します。

  4. データ収集 タブの 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に送信する

サーバーサイドのプロファイルイベントデータを新しいプロファイル固有のデータストリームおよびスキーマに追加する場合は、次の手順を実行します。

  1. 作成スキーマを作成し、クラスを エクスペリエンスイベント に設定します。

  2. 追加次のプロファイル固有のフィールドグループ:

    • 人口統計の詳細
    • 個人の連絡先の詳細
    • チャネルの詳細
    • Commerceの詳細
  3. プロファイルのスキーマ 🔗 有効 。

    スキーマがプロファイルで有効になっている場合、このスキーマから作成されたデータセットは、異なるソースのデータを結合して各顧客の全体像を構築するReal-Time CDPに関与します。

  4. 作成したスキーマに基づいて データセットを作成します。

    データセットは、データのコレクションのためのストレージおよび管理用の構成体で、通常は、スキーマ(列)とフィールド(行)を含むテーブルです。 データセットには、保存するデータの様々な側面を記述したメタデータも含まれます。

  5. データストリームを作成し、Commerce固有のフィールドグループと対応するデータセットを含む XDM スキーマを選択します。

    データストリームは、収集したデータをデータセットに転送します。 データは、選択したスキーマに基づいてデータセット内で表されます。

顧客プロファイルデータ用に設定されたスキーマ、データセット、データストリームを使用すると、データを収集してExperience Platformに送信するようにCommerce インスタンスを 設定できます。

プロファイルレコードデータのスキーマ、データセット、データストリームを作成するには、 プロファイルレコードデータのExperience Platformへの送信を参照してください。

recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840