スキーマのモデルデータ

最終更新日: 2023-09-25
  • トピック:
  • Schemas
    このトピックの詳細を表示
  • 作成対象:
  • Beginner
    Intermediate
    Developer

このレッスンでは、Luma のデータをスキーマにモデル化します。 これは、チュートリアルで最も長いレッスンの 1 つなので、水のグラスを取得し、バックルアップ!

標準化と相互運用性は、Adobe Experience Platform の背後にある重要な概念です。エクスペリエンスデータモデル (XDM) は、顧客体験データを標準化し、顧客体験管理のスキーマを定義する取り組みです。

XDM は、デジタルエクスペリエンスを強化するために設計され、公式に文書化された仕様です。Platform サービスとの通信に使用するあらゆるアプリケーションに共通の構造と定義を提供します。XDM 標準に準拠することで、すべての顧客体験データを共通の表現に組み込み、より迅速かつ統合的な方法でインサイトを得ることができます。顧客のアクションから貴重なインサイトを得たり、セグメントを使用して顧客のオーディエンスを定義したり、パーソナライゼーションを目的として顧客属性を表すことができます。

XDM は、Experience Platform が提供する Adobe Experience Cloud が、適切なタイミングに、適切なチャネル経由で、適切な相手へと適切なメッセージを届けることを可能にする、基本的なフレームワークです。Experience Platform の基礎となる XDM システム​は、エクスペリエンスデータモデルスキーマを Platform サービスで操作できるようにします。

データアーキテクト は、このチュートリアル以外でスキーマを作成する必要がありますが、 データエンジニア は、データアーキテクトが作成したスキーマと密接に連携します。

演習を始める前に、次の短いビデオを見て、スキーマとエクスペリエンスデータモデル (XDM) の詳細を確認してください。

ヒント

Experience Platformでのデータモデリングについて詳しく見るには、このコースを受講することをお勧めします。 XDM を使用した顧客体験データのモデル化(Experience League時に無料で利用可能 )

必要な権限

Adobe Analytics の 権限の設定 レッスンでは、このレッスンを完了するために必要なすべてのアクセス制御を設定します。

UI を使用したロイヤルティスキーマの作成

この演習では、Luma のロイヤルティデータのスキーマを作成します。

  1. Platform ユーザーインターフェイスに移動し、サンドボックスが選択されていることを確認します。
  2. に移動します。 スキーマ 左のナビゲーションで
  3. を選択します。 スキーマを作成 右上のボタン
  4. ドロップダウンメニューで、「 」を選択します。 XDM 個人プロファイル​個々の顧客の属性(ポイント、ステータスなど)をモデリングするので、
    OOTB フィールドグループを持つスキーマ

標準フィールドグループを追加

次に、スキーマにフィールドグループを追加するよう求めるプロンプトが表示されます。 すべてのフィールドは、グループを使用してスキーマに追加する必要があります。 Adobeが提供する業界標準のフィールドグループの大きなセットから選択するか、独自のフィールドグループを作成できます。 Experience Platformで独自のデータのモデリングを開始する際は、Adobeが提供する業界標準のフィールドグループに慣れておくとよいでしょう。 可能な限り、顧客 AI、Attribution AI、Adobe Analyticsなどのダウンストリームサービスを強化する場合があるので、これらを使用することをお勧めします。

独自のデータを使用する場合、大きな手順は、Platform で取り込むデータと、そのモデル化方法を決定することです。 この大きなトピックについては、コースで詳しく説明します。 XDM を使用した顧客体験データのモデル化. このチュートリアルでは、事前に決定されたスキーマの実装について、ガイドします。

フィールドグループを追加するには:

  1. Adobe Analytics の フィールドグループの追加 モーダルの場合は、次のフィールドグループを選択します。

    1. 人口統計の詳細 名前や誕生日などの基本的な顧客データの場合
    2. 個人の連絡先の詳細 電子メールアドレスや電話番号などの基本的な連絡先の詳細
  2. 行の右側にあるアイコンを選択して、フィールドグループに寄稿されたフィールドをプレビューできます。
    標準フィールドグループの選択

  3. 次を確認します。 業界 > 小売 」ボックスを使用して、業界固有のフィールドグループを表示します。

  4. 選択 忠誠度 「ロイヤルティプログラム」フィールドを追加します。

  5. フィールドグループを追加」を選択して、3 つのフィールドグループをすべてスキーマに追加します。
    ロイヤルティスキーマへの標準フィールドグループの追加

ここで、スキーマの現在の状態を調べます。 フィールドグループに、個人、連絡先の詳細、ロイヤルティプログラムのステータスに関連する標準フィールドが追加されています。 これら 2 つのフィールドグループは、自社のデータのスキーマを作成する際に役立つ場合があります。 特定のフィールドグループ行を選択するか、フィールドグループ名の横にあるボックスをオンにして、ビジュアライゼーションの変化を確認します。

スキーマを保存するには:

  1. スキーマの一番上のノードを選択します。
  2. 入力 Luma Loyalty Schema として 表示名.
  3. 保存」を選択します。
    スキーマに名前を付けて保存する
メモ

収集していないデータポイントのフィールドをフィールドグループが追加しても問題ありません。 例えば、「faxPhone」は、Luma がデータを収集しないフィールドの場合があります。 いいよ。 スキーマでフィールドが定義されているので、そのデータを意味するわけではありません 必須 後で取り込みます。

カスタムフィールドグループを追加する

次に、カスタムフィールドグループを作成します。

ロイヤルティフィールドグループには loyaltyID フィールドに含まれる Luma では、スキーマ間の一貫性を確保するために、すべてのシステム識別子を 1 つのグループで管理する必要があります。

フィールドグループは、スキーマワークフローで作成する必要があります。 フィールドグループを作成するには:

  1. 選択 追加 の下に スキーマフィールドグループ 見出し
    新しいフィールドグループを追加
  2. 選択 新しいフィールドグループを作成
  3. 用途 Luma Identity profile field group として 表示名
  4. 用途 system identifiers for XDM Individual Profile class として 説明
  5. 選択 フィールドグループを追加
    新しいフィールドグループを追加

新しい空のフィールドグループがスキーマに追加されます。 The + ボタンを使用して、階層内の任意の場所に新しいフィールドを追加できます。 ここでは、ルートレベルにフィールドを追加します。

  1. スキーマ名の横にある「+」を選択します。これにより、テナント ID 名前空間の下に新しいフィールドが追加され、カスタムフィールドと標準フィールドの競合を管理できます。

  2. Adobe Analytics の フィールドのプロパティ サイドバーは、新しいフィールドの詳細を追加します。

    1. フィールド名: systemIdentifier
    2. 表示名: System Identifier
    3. タイプ: オブジェクト
    4. 選択 適用

    新しいフィールドグループを追加

次に、 systemIdentifier オブジェクト:

  1. 最初のフィールド
    1. フィールド名: loyaltyId
    2. 表示名: Loyalty Id
    3. タイプ: 文字列
  2. 2 番目のフィールド
    1. フィールド名: crmId
    2. 表示名: CRM Id
    3. タイプ: 文字列

新しいフィールドグループは次のようになります。 を選択します。 保存 ボタンをクリックしてスキーマを保存しますが、次の演習ではスキーマを開いたままにします。
ロイヤルティフィールドグループが完了しました

データタイプの作成

新しいフィールドグループなど Luma Identity profile field groupを他のスキーマで再利用して、複数のシステムに標準データ定義を適用できます。 ただし、再利用できるのは クラスを共有するスキーマ内​の場合は、XDM Individual Profile クラス。

データタイプは、スキーマで再利用できる別の複数フィールド構成体です 複数のクラスにわたる. 新しいを変換しましょう systemIdentifier オブジェクトを次のデータ型に変換します。

を使用 Luma Loyalty Schema 開いたまま、 systemIdentifier オブジェクトと選択 新しいデータ型に変換

ロイヤルティフィールドグループ完了

次の場合、 キャンセル スキーマ外で、 データタイプ 「 」タブに移動すると、新しく作成したデータタイプが表示されます。 このデータタイプは、レッスンの後半で使用します。

ロイヤルティフィールドグループ完了

API を使用して CRM スキーマを作成

次に、API を使用してスキーマを作成します。

ヒント

API の演習をスキップする場合は、ユーザーインターフェイスメソッドを使用して、次のスキーマを作成できます。

  1. 以下を使用します。 XDM 個人プロファイル クラス
  2. 名前を付ける Luma CRM Schema
  3. 「人口統計の詳細」、「個人の連絡先の詳細」および「Luma ID プロファイル」フィールドグループの各フィールドグループを使用します。

まず、空のスキーマを作成します。

  1. オープン Postman

  2. アクセストークンがない場合は、リクエストを開きます。 OAuth: Request Access Token を選択し、 送信 をクリックして、新しいアクセストークンをリクエストします。

  3. 環境変数を開き、 CONTAINER_ID から global から tenant. 次を使用する必要があります。 tenant スキーマの作成など、Platform 内の独自のカスタム要素を操作する場合。

  4. 保存」を選択します
    CONTAINER_ID をテナントに変更します

  5. リクエストを開く Schema Registry API > Schemas > Create a new custom schema.

  6. を開きます。 本文 「 」タブに移動し、次のコードを貼り付けて「 」を選択します。 送信 を呼び出します。 この呼び出しは、同じ XDM Individual Profile 基本クラス:

    {
      "type": "object",
      "title": "Luma CRM Schema",
      "description": "Schema for CRM data of Luma Retail ",
      "allOf": [{
        "$ref": "https://ns.adobe.com/xdm/context/profile"
      }]
    }
    
    メモ

    名前空間は、このコードおよび後続のコードサンプルを参照します ( 例: https://ns.adobe.com/xdm/context/profile) は、リスト API 呼び出しを使用して CONTAINER_ID を受け入れ、ヘッダーの設定を正しい値に設定します。 また、ユーザーインターフェイスから簡単にアクセスできるものもあります。

  7. 以下を受け取る必要があります。 201 Created 応答

  8. コピー meta:altId 応答本文から。 後で別の演習で使用します。
    CRM スキーマの作成

  9. 新しいスキーマは、ユーザーインターフェイスに表示されますが、フィールドグループは表示されません
    CRM スキーマの作成

メモ

The meta:altId または、スキーマ id は、API リクエストを作成して取得することもできます Schema Registry API > Schemas > Retrieve a list of schemas within the specified container.CONTAINER_ID に設定 tenant および accept ヘッダー application/vnd.adobe.xdm+json.

ヒント

この呼び出しに関する一般的な問題と、おそらく次の修正点が当てはまります。

  • 認証トークンがありません: OAuth:アクセストークンをリクエスト 新しいトークンを生成するリクエスト
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/:を更新します。 CONTAINER_ID 次の環境変数: global から tenant
  • 403: PALM Access Denied. POST access is denied for this resource from access control:ユーザーでのユーザー権限のAdmin Console

標準フィールドグループを追加

次に、フィールドグループをスキーマに追加します。

  1. In Postman、リクエストを開きます。 Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  2. Adobe Analytics の パラメーター 」タブをクリックし、 meta:altId 以前の応答の値を SCHEMA_ID

  3. 「本文」タブを開き、次のコードを貼り付けて、「 」を選択します。 送信 を呼び出します。 この呼び出しにより、標準フィールドグループが Luma CRM Schema:

    [{
        "op": "add",
        "path": "/allOf/-",
        "value": {
          "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details"
        }
      },
      {
        "op": "add",
        "path": "/allOf/-",
        "value": {
          "$ref": "https://ns.adobe.com/xdm/context/profile-person-details"
        }
      }
    ]
    
  4. 応答に 200 OK ステータスが返され、フィールドグループが UI のスキーマの一部として表示されます

    追加された標準フィールドグループ

カスタムフィールドグループを追加

次に、 Luma Identity profile field group をスキーマに追加します。 まず、リスト API を使用して、新しいフィールドグループの ID を見つける必要があります。

  1. リクエストを開く Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.

  2. を選択します。 送信 ボタンをクリックして、アカウント内のすべてのカスタムフィールドグループのリストを取得します。

  3. を取得 $id の値 Luma Identity profile field group (実際の値は、このスクリーンショットの値とは異なります)
    フィールドグループのリストの取得

  4. リクエストを開く Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. 再び

  5. The パラメーター タブには、 $id

  6. を開きます。 本文 タブに貼り付け、次のコードを貼り付けます。 $ref 値を $id あなた自身の Luma Identity profile field group:

    [{
      "op": "add",
      "path": "/allOf/-",
      "value": {
        "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
      }
    }]
    
  7. 選択 送信
    ID フィールドグループの追加

API 応答とインターフェイスの両方を確認して、フィールドグループがスキーマに追加されたことを確認します。

オフライン購入イベントスキーマを作成

次に、 XDM ExperienceEvent Luma のオフライン購入データ用のクラス。 これで、スキーマエディターのユーザーインターフェイスに慣れたので、手順に記載されているスクリーンショットの数を減らします。

  1. を使用したスキーマの作成 XDM ExperienceEvent クラス
  2. 標準フィールドグループを追加 コマースの詳細 を使用して、共通の注文の詳細を取り込みます。 少しの間、内部のオブジェクトを探索します。
  3. Luma Identity profile field group を検索します。使用できません。 フィールドグループは 1 つのクラスに関連付けられています。このスキーマに別のクラスを使用するので、使用できません。 ID フィールドを含む XDM ExperienceEvent クラス用に新しいフィールドグループを追加する必要があります。 私たちのデータタイプは、本当に簡単になります!
  4. を選択します。 新しいフィールドグループを作成 ラジオボタン
  5. 次を入力します。 表示名 as Luma Identity ExperienceEvent field group をクリックし、 フィールドグループを追加 ボタン
  6. 次を確認します。 + ボタンは、 構造 セクションで新しいフィールドを追加できます。
  7. In 構造 セクション、選択 + スキーマの最上位
  8. フィールド名,と入力します。 systemIdentifier
  9. 表示名,と入力します。 System Identifier
  10. タイプ​を選択します。 システム識別子 (前に作成したカスタムデータタイプ)
  11. を選択します。 適用 ボタン
  12. スキーマに名前を付ける Luma Offline Purchase Events Schema
  13. を選択します。 保存 ボタン

データタイプによってすべてのフィールドがどのように追加されたかを確認します。

フィールドグループにデータタイプを追加する

また、 XDM ExperienceEvent の下に クラス このクラスが提供するフィールドの一部を見出して検査します。 XDM ExperienceEvent クラスを使用する場合、 _id フィールドと timestamp フィールドが必要です。これらのフィールドは、このスキーマを使用する際に取り込むすべてのレコードに対して設定する必要があります。

エクスペリエンスイベントベースの構造

ウェブイベントスキーマの作成

次に、Luma の Web サイトデータ用に、もう 1 つのスキーマを作成します。 この時点で、スキーマの作成に関するエキスパートになる必要があります。 これらのプロパティを使用して、次のスキーマを作成します。

プロパティ
クラス XDM ExperienceEvent
フィールドグループ AEP Web SDK ExperienceEvent Mixin
フィールドグループ 消費者エクスペリエンスイベント
スキーマ名 Luma Web イベントスキーマ

を選択します。 消費者エクスペリエンスイベント フィールドグループを使用します。 このフィールドグループには、同じ場所にある commerce オブジェクトと productListItems オブジェクトが含まれます。 コマースの詳細. 実際 消費者エクスペリエンスイベント は、別々に使用できるその他の標準フィールドグループの組み合わせです。 AEP Web SDK ExperienceEvent Mixin フィールドグループには、他のフィールドグループも含まれます ( 消費者エクスペリエンスイベント. 幸いにも、それらはシームレスに組み合わされます。

なお、 Luma Identity ExperienceEvent field group をこのスキーマに追加します。 これは、Web SDK の ID 収集方法が異なるからです。 次を選択した場合、 XDM ExperienceEvent クラス 構成 スキーマエディターの「 」セクションに、デフォルトで追加されるフィールドの 1 つが、「 」と呼ばれます。 IdentityMap. IdentityMap は、様々なAdobeアプリケーションで Platform にリンクするために使用されます。 ストリーミング取得のレッスンでは、identityMap を使用して ID が Platform に送信される方法を確認します。

商品カタログスキーマを作成

を使用する コマースの詳細 および 消費者エクスペリエンスイベント フィールドグループに基づいて、Luma は標準の productListItems データ型を使用して製品関連イベントの詳細をレポートします。 ただし、Platform に送信する追加の製品詳細フィールドもあります。 Luma では、POS(販売時点管理)システムと e コマースシステムでこれらのフィールドをすべて取り込む代わりに、これらのフィールドを製品カタログシステムから直接取り込むことをお勧めします。 「スキーマ関係」を使用すると、分類や検索の目的で、2 つのスキーマ間の関係を定義できます。 Luma は、関係を使用して製品の詳細を分類します。 ここでプロセスを開始し、次のレッスンの最後に完了します。

メモ

既存の Analytics または Target のお客様の場合、スキーマの関係でエンティティを分類することは、SAINTの分類や、Recommendations用の製品カタログのアップロードと似ています

まず、カスタムクラスを使用して Luma の製品カタログのスキーマを作成する必要があります。

  1. を選択します。 スキーマを作成 ボタンをクリックし、 参照 オプションをドロップダウンから選択
    新しいスキーマを作成
  2. を選択します。 新しいクラスを作成 ラジオボタン
  3. 名前を付ける Luma Product Catalog Class
  4. を残します。 動作 as レコード
  5. を選択します。 クラスを割り当て ボタン
    新しいクラスを作成
  6. 新規作成 フィールドグループ 呼び出し Luma Product Catalog field group を次のフィールドに置き換えます。
    1. productName:製品名: String
    2. productCategory:製品カテゴリ: String
    3. productColor:製品の色:文字列
    4. productSku:製品 SKU: String |必須
    5. productSize: Product Size: String
    6. productPrice:製品価格:倍額
  7. スキーマに名前を付けます。 Luma Product Catalog Schema (クラス名を更新しないで、正しいフィールドを必ず更新してください)。
  8. ​スキーマの保存

新しいスキーマは次のようになります。 以下の点に注意してください。 productSku フィールドが 必須フィールド セクション:
製品スキーマ

次の手順では、2 つの ExperienceEvent スキーマと Luma Product Catalog Schemaただし、その前に、次のレッスンで実行する必要がある追加の手順がいくつかあります。

その他のリソース

これで、次にスキーマを使用できます id をマップ!

このページ