このレッスンでは、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 の 権限の設定 レッスンでは、このレッスンを完了するために必要なすべてのアクセス制御を設定します。
この演習では、Luma のロイヤルティデータのスキーマを作成します。
次に、スキーマにフィールドグループを追加するよう求めるプロンプトが表示されます。 すべてのフィールドは、グループを使用してスキーマに追加する必要があります。 Adobeが提供する業界標準のフィールドグループの大きなセットから選択するか、独自のフィールドグループを作成できます。 Experience Platformで独自のデータのモデリングを開始する際は、Adobeが提供する業界標準のフィールドグループに慣れておくとよいでしょう。 可能な限り、顧客 AI、Attribution AI、Adobe Analyticsなどのダウンストリームサービスを強化する場合があるので、これらを使用することをお勧めします。
独自のデータを使用する場合、大きな手順は、Platform で取り込むデータと、そのモデル化方法を決定することです。 この大きなトピックについては、コースで詳しく説明します。 XDM を使用した顧客体験データのモデル化. このチュートリアルでは、事前に決定されたスキーマの実装について、ガイドします。
フィールドグループを追加するには:
Adobe Analytics の フィールドグループの追加 モーダルの場合は、次のフィールドグループを選択します。
行の右側にあるアイコンを選択して、フィールドグループに寄稿されたフィールドをプレビューできます。
次を確認します。 業界 > 小売 」ボックスを使用して、業界固有のフィールドグループを表示します。
選択 忠誠度 「ロイヤルティプログラム」フィールドを追加します。
「フィールドグループを追加」を選択して、3 つのフィールドグループをすべてスキーマに追加します。
ここで、スキーマの現在の状態を調べます。 フィールドグループに、個人、連絡先の詳細、ロイヤルティプログラムのステータスに関連する標準フィールドが追加されています。 これら 2 つのフィールドグループは、自社のデータのスキーマを作成する際に役立つ場合があります。 特定のフィールドグループ行を選択するか、フィールドグループ名の横にあるボックスをオンにして、ビジュアライゼーションの変化を確認します。
スキーマを保存するには:
Luma Loyalty Schema
として 表示名.収集していないデータポイントのフィールドをフィールドグループが追加しても問題ありません。 例えば、「faxPhone」は、Luma がデータを収集しないフィールドの場合があります。 いいよ。 スキーマでフィールドが定義されているので、そのデータを意味するわけではありません 必須 後で取り込みます。
次に、カスタムフィールドグループを作成します。
ロイヤルティフィールドグループには loyaltyID
フィールドに含まれる Luma では、スキーマ間の一貫性を確保するために、すべてのシステム識別子を 1 つのグループで管理する必要があります。
フィールドグループは、スキーマワークフローで作成する必要があります。 フィールドグループを作成するには:
Luma Identity profile field group
として 表示名system identifiers for XDM Individual Profile class
として 説明新しい空のフィールドグループがスキーマに追加されます。 The + ボタンを使用して、階層内の任意の場所に新しいフィールドを追加できます。 ここでは、ルートレベルにフィールドを追加します。
スキーマ名の横にある「+」を選択します。これにより、テナント ID 名前空間の下に新しいフィールドが追加され、カスタムフィールドと標準フィールドの競合を管理できます。
Adobe Analytics の フィールドのプロパティ サイドバーは、新しいフィールドの詳細を追加します。
systemIdentifier
System Identifier
次に、 systemIdentifier
オブジェクト:
loyaltyId
Loyalty Id
crmId
CRM Id
新しいフィールドグループは次のようになります。 を選択します。 保存 ボタンをクリックしてスキーマを保存しますが、次の演習ではスキーマを開いたままにします。
新しいフィールドグループなど Luma Identity profile field group
を他のスキーマで再利用して、複数のシステムに標準データ定義を適用できます。 ただし、再利用できるのは クラスを共有するスキーマ内の場合は、XDM Individual Profile クラス。
データタイプは、スキーマで再利用できる別の複数フィールド構成体です 複数のクラスにわたる. 新しいを変換しましょう systemIdentifier
オブジェクトを次のデータ型に変換します。
を使用 Luma Loyalty Schema
開いたまま、 systemIdentifier
オブジェクトと選択 新しいデータ型に変換
次の場合、 キャンセル スキーマ外で、 データタイプ 「 」タブに移動すると、新しく作成したデータタイプが表示されます。 このデータタイプは、レッスンの後半で使用します。
次に、API を使用してスキーマを作成します。
API の演習をスキップする場合は、ユーザーインターフェイスメソッドを使用して、次のスキーマを作成できます。
Luma CRM Schema
まず、空のスキーマを作成します。
オープン Postman
アクセストークンがない場合は、リクエストを開きます。 OAuth: Request Access Token を選択し、 送信 をクリックして、新しいアクセストークンをリクエストします。
環境変数を開き、 CONTAINER_ID から global
から tenant
. 次を使用する必要があります。 tenant
スキーマの作成など、Platform 内の独自のカスタム要素を操作する場合。
「保存」を選択します
リクエストを開く Schema Registry API > Schemas > Create a new custom schema.
を開きます。 本文 「 」タブに移動し、次のコードを貼り付けて「 」を選択します。 送信 を呼び出します。 この呼び出しは、同じ 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 を受け入れ、ヘッダーの設定を正しい値に設定します。 また、ユーザーインターフェイスから簡単にアクセスできるものもあります。
以下を受け取る必要があります。 201 Created
応答
コピー meta:altId
応答本文から。 後で別の演習で使用します。
新しいスキーマは、ユーザーインターフェイスに表示されますが、フィールドグループは表示されません
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
.
この呼び出しに関する一般的な問題と、おそらく次の修正点が当てはまります。
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次に、フィールドグループをスキーマに追加します。
In Postman、リクエストを開きます。 Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.
Adobe Analytics の パラメーター 」タブをクリックし、 meta:altId
以前の応答の値を SCHEMA_ID
「本文」タブを開き、次のコードを貼り付けて、「 」を選択します。 送信 を呼び出します。 この呼び出しにより、標準フィールドグループが 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"
}
}
]
応答に 200 OK ステータスが返され、フィールドグループが UI のスキーマの一部として表示されます
次に、 Luma Identity profile field group
をスキーマに追加します。 まず、リスト API を使用して、新しいフィールドグループの ID を見つける必要があります。
リクエストを開く Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.
を選択します。 送信 ボタンをクリックして、アカウント内のすべてのカスタムフィールドグループのリストを取得します。
を取得 $id
の値 Luma Identity profile field group
(実際の値は、このスクリーンショットの値とは異なります)
リクエストを開く Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. 再び
The パラメーター タブには、 $id
の
を開きます。 本文 タブに貼り付け、次のコードを貼り付けます。 $ref
値を $id
あなた自身の Luma Identity profile field group
:
[{
"op": "add",
"path": "/allOf/-",
"value": {
"$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
}
}]
選択 送信
API 応答とインターフェイスの両方を確認して、フィールドグループがスキーマに追加されたことを確認します。
次に、 XDM ExperienceEvent Luma のオフライン購入データ用のクラス。 これで、スキーマエディターのユーザーインターフェイスに慣れたので、手順に記載されているスクリーンショットの数を減らします。
Luma Identity profile field group
を検索します。使用できません。 フィールドグループは 1 つのクラスに関連付けられています。このスキーマに別のクラスを使用するので、使用できません。 ID フィールドを含む XDM ExperienceEvent クラス用に新しいフィールドグループを追加する必要があります。 私たちのデータタイプは、本当に簡単になります!Luma Identity ExperienceEvent field group
をクリックし、 フィールドグループを追加 ボタンsystemIdentifier
System Identifier
Luma Offline Purchase Events Schema
データタイプによってすべてのフィールドがどのように追加されたかを確認します。
また、 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 の製品カタログのスキーマを作成する必要があります。
Luma Product Catalog Class
Luma Product Catalog field group
を次のフィールドに置き換えます。
Luma Product Catalog Schema
(クラス名を更新しないで、正しいフィールドを必ず更新してください)。新しいスキーマは次のようになります。 以下の点に注意してください。 productSku
フィールドが 必須フィールド セクション:
次の手順では、2 つの ExperienceEvent スキーマと Luma Product Catalog Schema
ただし、その前に、次のレッスンで実行する必要がある追加の手順がいくつかあります。
これで、次にスキーマを使用できます id をマップ!