このレッスンでは、ルミナンスデータをスキーマにモデル化します。 このチュートリアルでは、このような一番長いレッスンの中の1つです。水域を buckle、海に戻ることができます。
標準化と相互運用性は、Adobe Experience Platform の背後にある重要な概念です。エクスペリエンスデータモデル (XDM) は、カスタマーエクスペリエンスデータを標準化し、カスタマーエクスペリエンス管理のためのスキーマを定義することを目的としています。
XDM は、デジタルエクスペリエンスを強化するために設計され、公式に文書化された仕様です。Platform サービスとの通信に使用するあらゆるアプリケーションに共通の構造と定義を提供します。XDM 標準に準拠することで、すべての顧客体験データを共通の表現に組み込み、より迅速かつ統合的な方法でインサイトを得ることができます。顧客の行動から貴重なインサイトを得たり、セグメントを使用して顧客のオーディエンスを定義したり、パーソナライゼーションを目的として顧客属性を表すことができます。
XDM は、Experience Platform が提供する Adobe Experience Cloud が、適切なタイミングに、適切なチャネル経由で、適切な相手へと適切なメッセージを届けることを可能にする、基本的なフレームワークです。Experience Platform の基礎となる XDM システムは、エクスペリエンスデータモデルスキーマを Platform サービスで操作できるようにします。
データアーキテクトは、 このチュートリアルの外でスキーマを作成する必要がありますが、データ エンジニア は、データアーキテクトによって作成されたスキーマと緊密に連携します。
練習を開始する前に、この短いビデオで、スキーマと経験データモデル (XDM) について詳しく知ることができます。
エクスペリエンスプラットフォームのデータモデリングについて詳しくは、「XDM を使用して お客様がデータを処理する」コースを受講することをお勧めします 。
「権限の設定」のレッスンでは、 🔗 このレッスンを完了するために必要なすべてのアクセス制御を設定します。
この練習では、ルミナンスのロイヤルティデータに対するスキーマを作成します。
次に、フィールドグループをスキーマに追加するかどうかを確認するメッセージが表示されます。 すべてのフィールドは、グループを使用してスキーマに追加する必要があります。 アドビから提供されている大規模なフィールドグループの中から選択することも、独自のフィールドグループを作成することもできます。 エクスペリエンスプラットフォームで独自のデータをシミュレーションするときは、アドビから提供されている業界標準のフィールドグループについて理解しておくことをお勧めします。 可能な限り、それらを使用して、カスタマー AI、属性 AI、Adobe アナリティクスなどの下流のサービスをパワーにする場合には、この方法を使用することをお勧めします。
独自のデータを操作する際には、どのデータをプラットフォームに取り込んで、どのようにモデル化するかを決定する必要があります。 この大きなトピックについては、「 XDM を使用してカスタマーエクスペリエンスデータをモデル化する」コースで詳しく説明されてい ます。 このチュートリアルでは、事前に定義されたスキーマの実装についてのみ紹介します。
フィールドグループを追加するには:
「フィールドグループを追加」フィールドで、 次のフィールドグループを選択します。
行の右側にあるアイコンを選択して、フィールドグループに追加されたフィールドをプレビューできます。
業種 に固有のフィールドグループを表示するには、業界の > Retail box を確認してください。
「ロイヤルティ」を選択 すると、ロイヤルティプログラムのフィールドが追加されます。
すべてのフィールドグループをスキーマに追加するには、「フィールドグループを追加」を選択します。
スキーマの現在の状態を確認するために、少し時間がかかります。 このフィールドグループには、人名、連絡先情報、ロイヤルティプログラムの状態に関連する標準フィールドが追加されています。 これらの2つのフィールドグループを使用すると、社内のデータについてスキーマを作成することができます。 特定のフィールドグループ行を選択するか、または「フィールドグループ名」の横にあるチェックボックスをオンにして、ビジュアル化の変更を確認してください。
スキーマを保存するには:
Luma Loyalty Schema
表示名として「」を入力し ます。データポイントにフィールドが追加されていない場合は、このフィールドグループを使用してください。 例えば、「Fax 電話」は、ルミナンスがデータを収集しないフィールドである可能性があります。 いいです。 フィールドがスキーマに定義されているので、そのフィールドのデータを後で ingested 必要があるというわけではありません ** 。
では、カスタムフィールドグループを作成してみましょう。
「ロイヤルティ」フィールドグループにはフィールドが含まれてい loyaltyID
ますが、ルミナンスはすべてのシステム識別子を1つのグループで管理することで、スキーマ間の一貫性を確保することができます。
スキーマワークフローではフィールドグループを作成する必要があります。 フィールドグループを作成するには、次のようにします。
スキーマフィールドグループ見出しの下の「追加」を選択します。
「 新規フィールドグループを作成」を選択します。
Luma Identity profile field group
表示名として使用する
system identifiers for XDM Individual Profile class
説明として使用
「フィールドグループの追加」を選択します。
新しく作成した空のフィールドグループをスキーマに追加します。 + ボタンを使用すると、 階層内の任意の場所に新しいフィールドを追加することができます。 次の例では、ルートレベルにフィールドを追加します。
スキーマの名前の横にある「+」をクリックします。これにより、テナント id 名前空間の下に新しいフィールドが追加され、カスタムフィールドと標準フィールド間の競合が管理されます。
フィールドプロパティサイドバーで、 新規フィールドの詳細情報を追加します。
systemIdentifier
System Identifier
次に、オブジェクトの下にフィールドを2つ追加し systemIdentifier
ます。
loyaltyId
Loyalty Id
crmId
CRM Id
新しいフィールドグループは次のようになります。 「保存」ボタンをクリックすると、スキーマが保存され ますが、次の手順ではスキーマは開いたままにしておきます。
新機能のようなフィールドグループは Luma Identity profile field group
他のスキーマで再利用できるので、複数のシステム間で標準的なデータ定義を適用することができます。 ただし、クラスを共有するスキーマでしか再利用することはできません __ 。この場合は、XDM の各プロファイルクラスが使用されます。
データ型は、複数のクラスにわたってスキーマで再利用できる、マルチフィールドコンストラクトの1つです __ 。 ここ systemIdentifier
では、新しいオブジェクトをデータ型に変換してみましょう。
静止画を開いた状態で、 Luma Loyalty Schema
オブジェクトを選択して「 systemIdentifier
新規データ型に変換」を選択します。
スキーマを キャンセル して 「データ型」タブに移動すると 、新しく作成したデータ型が表示されます。 このデータ型は、この後のレッスンで使用します。
ここでは、API を使用してスキーマを作成します。
この API の練習を省略する場合は、ユーザーインターフェイスのメソッドを使用して次のスキーマを作成できます。
Luma CRM Schema
最初に、空のスキーマを作成します。
オープン Postman
ここでは、24時間以内に要求されていない場合、認証トークンの有効期限が切れている可能性があります。 要求を開き、 Adobe I/O Access Token Generation > Local Signing (Non-production use-only) > IMS: JWT Generate + Auth via User Token 「送信」を選択して 新しい JWT およびアクセストークンを要求します。
環境変数を開き、CONTAINER_ID の値 をからに変更し global
tenant
ます。 tenant
スキーマの作成など、プラットフォームで独自のカスタムエレメントを操作する場合は、必ず使用してください。
「保存」を選択します。
要求を開きます。 Schema Registry API > Schemas > Create a new custom schema.
「Body」タブを開き、次のコードをペーストして、「送信」を選択して API 呼び出しを行います。この呼び出しによって、同じ基本クラスを使用して新しいスキーマが作成され 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"
}]
}
この2つ目以降のコードサンプルでは、名前空間の参照が、 https://ns.adobe.com/xdm/context/profile
CONTAINER_ID and accept ヘッダーが正しい値に設定された list API 呼び出しを使用して取得できます。 一部のユーザーインターフェイスでも簡単にアクセスできるようになっています。
応答を取得する必要があります 201 Created
meta:altId
応答本文からコピーします。このファイルは、後で別の練習で使用します。
新しいスキーマは、ユーザーインターフェイスには表示されますが、フィールドグループは表示されません。
また、スキーマ id は、CONTAINER_ID が設定されている meta:altId
API 要求 Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. 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 でユーザーのアクセス許可を確認してください。次に、フィールドグループをスキーマに追加します。
で Postman 依頼を開きます。 Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.
「パラメーター」タブで、 meta:altId
以前の応答の値をSCHEMA_ID
「Body」タブを開き、次のコードをペーストして、「送信」を選択して API 呼び出しを行います。 この呼び出しによって、次のように標準のフィールドグループが追加され 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"
}
}
]
応答については、「OK」と「200」状態が表示されます。また、フィールドグループが、スキーマの一部として UI に表示されている必要があります。
では、ここで、 Luma Identity profile field group
スキーマに追加してみましょう。 最初に、list 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.
「 Params 」タブに、スキーマが残っている必要があります。 $id
「Body」タブを開き、 次のコードをペーストして、 $ref
値を独自の値に置き換え $id
Luma Identity profile field group
ます。
[{
"op": "add",
"path": "/allOf/-",
"value": {
"$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
}
}]
「送信」を選択します。
API 応答とインターフェイスで、そのフィールドグループがスキーマに追加されていることを確認してください。
次に、 ルミナンスのオフライン購入データに使用する XDM ExperienceEvent クラスに基づいてスキーマを作成してみましょう。 スキーマエディターのユーザーインターフェイスについて理解しているので、次の操作を実行すると、スクリーンショットの数が少なくなります。
Luma Identity profile field group
を検索。これは利用できません。 フィールドグループはクラスに関連付けられていますが、このスキーマには別のクラスを使用しているので使用できないことに注意してください。 Id フィールドを含む XDM ExperienceEvent クラスの新しいフィールドグループを追加する必要があります。 データ型を使用すると、非常に簡単に作成できます。Luma Identity ExperienceEvent field group
、「 フィールドグループを追加 」ボタンをクリックします。systemIdentifier
System Identifier
Luma Offline Purchase Events Schema
データ型によってすべてのフィールドが追加されていることに注意してください。
また、「 クラス」見出しの下の「XDM ExperienceEvent」を選択し、 このクラスによって提供されるいくつかのフィールドを調べます。 XDM ExperienceEvent クラスを使用する場合は、次のフィールドに入力する必要があります。このようなフィールドは、このスキーマを使用したときに取り込むすべてのレコードに設定されている必要があります。 _id
ここでは、ルミナンスの web サイトのデータについて、さらに1つのスキーマを作成します。 この時点で、スキーマを作成するためのエキスパートになる必要があります。 これらのプロパティを使用して、次のスキーマを作成します。
プロパティ | 値 |
---|---|
クラス | XDM ExperienceEvent |
フィールドグループ | AEP Web SDK ExperienceEvent Mixin |
フィールドグループ | コンシューマーエクスペリエンスイベント |
スキーマ名 | ルミナンス Web Events スキーマ |
「 コンシューマーエクスペリエンス」イベント フィールドグループを選択します。 このフィールドグループには、商業に関する詳細情報が含まれていた commerce および productListItems オブジェクトが含まれてい ます。 実際の コンシューマーエクスペリエンスイベント は、他のいくつかの標準フィールドグループの組み合わせであり、個別に使用することもできます。 AEP Web SDK ExperienceEvent Mixin フィールドグループにも、コンシューマーエクスペリエンスイベントの一部のフィールドグループが含まれてい ます。 さいわいにも、これらの機能はシームレスに統合されています。
このスキーマにが追加されていないことに注意 Luma Identity ExperienceEvent field group
してください。 これは、Web SDK には、id の収集方法が異なるからです。 スキーマエディターの「コンポジション」セクションで XDM ExperienceEvent クラスを選択した場合は、 デフォルトで追加されるフィールドの1つが、「ユーザーマップ」と呼ばれることに注意して ください。IdentityMap は、様々な Adobe アプリケーションで、プラットフォームにリンクするために使用されています。 「ストリーミング取り込み」レッスンで、id が Platform に送信される方法を説明しています。
「 コマース詳細 」および「コンシューマエクスペリエンス」イベントフィールドグループを使用すると 、ルミナンスは、標準の productListItems データ型を使用して製品に関するイベントの詳細を報告します。 また、プラットフォームに送信する製品詳細フィールドも追加されています。 Pos システムおよび電子商取引システムでこれらのすべてのフィールドを取得するのではなく、ルミナンスは、それらのフィールドを商品カタログシステムから直接取り込みます。 "スキーマリレーションシップ" を使用すると、2つのスキーマ間のリレーションシップを定義できます。これを使用すると、分類とルックアップを行うことができます。 ルミナンスは、その製品についての分類に関係が使用されます。 ここでは、プロセスを開始して、次のレッスンの最後に完成させます。
既存の分析またはターゲットとして使用している場合は、エンティティをスキーマリレーションシップで分類することは、聖なるという点に似ています。製品カタログを推奨します。
まず、カスタムクラスを使用して、ルミナンス製品カタログのスキーマを作成する必要があります。
Luma Product Catalog Class
Luma Product Catalog field group
次のフィールドを使用して、新しいフィールドグループを作成します。
Luma Product Catalog Schema
(正確なフィールドを更新し、クラス名は更新しないようにしてください)。このような新しいスキーマは、次のようになります。 productSku
フィールドが 「必須フィールド」セクションにどのように表示されるかに注意して ください。
次の手順では、2つの ExperienceEvent スキーマとの関係を定義し Luma Product Catalog Schema
ます。ただし、そのためには、次のレッスンに追加する必要があります。
これで、スキーマを使用して id をマップできるようになりました 🔗 。