スキーマとデータセットの設定

データをAdobe Experience Platformに取り込むには、まず収集するデータを定義する必要があります。 ダウンストリームの機能で認識し、処理するには、Adobe Experience Platform に取り込まれるすべてのデータが、標準的な非正規化された構造に準拠する必要があります。エクスペリエンスデータモデル(XDM)は、スキーマの形式で構造を提供する標準フレームワークです。

スキーマを定義したら、1 つ以上のデータセットを使用して、データの収集を保存および管理します。データセットは、スキーマ(列)とフィールド(行)を含んだデータのコレクション(通常はテーブル)のストレージおよび管理用の構成体です。

Adobe Experience Platform に取り込まれるすべてのデータは、データセットとして保持する前に、事前定義済みのスキーマに準拠している必要があります。

スキーマの設定

コンソールでゲームをプレイしているプロファイルからの最小限のデータ(識別、スコア、進行状況、その他の情報など)を追跡します。
まず、このデータをモデル化するスキーマを定義する必要があります。

スキーマを設定するには:

  1. Adobe Experience Platform UI の左パネルの「データ管理」で、「スキーマ」を選択します。

  2. スキーマを作成 を選択します。
    .

  3. スキーマ作成ウィザードの「クラスを選択」手順で、次の操作を行います。

    1. エクスペリエンスイベント を選択します。

      スキーマ

      INFO
      エクスペリエンスイベントスキーマは、プロファイルの 動作 をモデル化するために使用します(シーン名、買い物かごに追加するプッシュボタンなど)。 個々のプロファイルスキーマは、プロファイル​_属性_(名前、メール、性別など)のモデル化に使用されます。
    2. 次へ」を選択します。

  4. ​ スキーマを作成 ​ ウィザードの ​ 名前とレビューの手順 ​ で、次の操作を行います。

    1. スキーマの スキーマ表示名 と(オプション) 説明 を入力します。

      スキーマに名前を付ける

    2. 完了」を選択します。

  5. 「スキーマ例の構造」タブで、次の操作を行います。

    1. 「フィールドグループ」で「+ 追加」を選択します。

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

      フィールドグループは、スキーマを簡単に拡張できる、再利用可能なオブジェクトと属性のコレクションです。

    2. ​ フィールドグループを追加 ​ ダイアログで、リストから 点滅 フィールドグループを選択します。 このフィールドグループは、コンソールで Blinding Light という架空のゲームをプレイするユーザーの進行状況を追跡するために作成されます。

      明滅フィールドグループ

      「プレビュー」ボタンを選択すると、このフィールドグループに属するフィールド(scores > afterMatch など)のプレビューを表示できます。

      点滅するライトフィールドグループのプレビュー

      戻る」を選択してプレビューを閉じます。

    3. フィールドグループを追加」を選択します。

  6. スキーマ名の横にある「+」を選択します。

    スキーマ追加フィールドボタンの例

  7. 「​ フィールドプロパティ ​」パネルで、​ フィールド名 ​ に identification と入力し、表示名 ​ に ID と入力し、​ タイプ ​ で オブジェクト を選択し、​ フィールドグループ ​ で ExperienceEvent Core v2.1 を選択します。

    NOTE
    そのフィールドグループが使用できない場合は、ID フィールドを含む別のフィールドグループを探します。 または 新しいフィールドグループを作成して 新しい ID フィールドを追加ecidcrmId など、必要なその他)をフィールドグループに追加し、その新しいフィールドグループを選択します。

    ID オブジェクト

    ID オブジェクトは、スキーマに ID 機能を追加します。 この場合、ゲーム機にログインする際に使用するExperience CloudID とメールアドレスを使用して、ゲームをプレイしているプロファイルを特定します。 人物の識別情報を追跡するために使用できる属性は他にも多数あります。

    適用」を選択して、このオブジェクトをスキーマに追加します。

  8. 先ほど追加した ID オブジェクトで「ecid」フィールドをクリックし、右パネルの ID 名前空間リストから IDプライマリ ID および ECID を選択します。

    ECID を ID として指定

    Experience Cloud ID を、Adobe Experience Platform Identity Service が同じ ECID を持つプロファイルの動作を組み合わせる(ステッチする)ために使用するプライマリ ID として指定します。

    適用」を選択します。ecid 属性にフィンガープリントアイコンが表示されます。

  9. 先ほど追加した ID オブジェクトで「メール」フィールドをクリックし、フィールドプロパティパネルのID 名前空間リストから ID と​ メール ​を選択します。

    メールを ID として指定

    メールアドレスを、Adobe Experience Platform Identity Service がプロファイルの動作を組み合わせる(ステッチする)ために使用するもう一つの ID として指定します。

    適用」を選択します。メール属性にフィンガープリントアイコンが表示されます。

    保存」を選択します。

  10. スキーマの名前を表示しているスキーマのルート要素を選択してから、プロファイル ​スイッチをクリックします。

    プロファイルのスキーマを有効にするよう求められます。有効にすると、このスキーマに基づくデータセットにデータが取り込まれたときに、そのデータをリアルタイム顧客プロファイルと結合します。

    詳しくは、リアルタイム顧客プロファイルで使用するスキーマを有効にするを参照してください。

    IMPORTANT
    プロファイルで有効にしたスキーマを保存すると、そのスキーマはプロファイルで無効にできなくなります。

    プロファイルでスキーマを有効にする

  11. 保存」を選択してスキーマを保存します。

ゲームから取得できるデータをモデル化する、最小限のスキーマを作成しました。 このスキーマを使用することで、Experience Cloud ID とメールアドレスを使用してプロファイルを識別できます。プロファイルのスキーマを有効にすることで、コンソールゲームから取り込んだデータをリアルタイム顧客プロファイルへと確実に追加できます。

行動データの横にある、コンソールからプロファイル属性データ(コンソールにログインしたプロファイルの詳細など)を取得することもできます。

プロファイルデータを取得するには、次を実行します。

  • XDM Individual Profile クラスに基づいてスキーマを作成します。

  • Profile Core v2 フィールドグループをスキーマに追加します。

  • Profile Core v2 フィールドグループに基づいて ID オブジェクトを追加します。

  • Experience Cloud ID をプライマリ識別子、メールを識別子として定義します。

  • プロファイルでスキーマを有効にする

フィールドグループと個々のフィールドをスキーマに追加、またはスキーマから削除する方法について詳しくは、UI でのスキーマの作成と編集を参照してください。

データセットの設定

スキーマを使用して、データモデルを定義しました。次に、データセットを使用して、そのデータを保存および管理する構成を定義する必要があります。

データセットを設定するには:

  1. Adobe Experience Platform UI の左パネルの「データ管理」で、「データセット」を選択します。

  2. データセットを作成」を選択します。

    データセットの作成

  3. スキーマからデータセットを作成」をクリックします。

    スキーマからのデータセットの作成

  4. 作成したスキーマを選択し、「次へ」を選択します。

  5. データセットに名前を付け、(オプション)説明を入力します。

    名前データセット

  6. 完了」を選択します。

  7. プロファイル」スイッチを選択します。

    プロファイルのデータセットを有効にするよう求められます。有効にすると、データセットは、取り込んだデータを使用してリアルタイム顧客プロファイルを強化します。

    IMPORTANT
    プロファイルのデータセットを有効にできるのは、データセットが準拠するスキーマがプロファイルに対しても有効になっている場合のみです。

    プロファイルでスキーマを有効にする

データセットの表示、プレビュー、作成、削除の方法について詳しくは、データセット UI ガイドを参照してください。リアルタイム顧客プロファイルのデータセットを有効にする方法について説明します。

データストリームの設定

データストリームは、Adobe Experience Platform Web SDK、Mobile SDK およびAdobe Experience Platform Edge Networkサーバー API を実装する際のサーバーサイド設定を表します。 Adobe Experience Platform SDK およびEdge Networkサーバー API を使用してデータを収集する場合、データはAdobe Experience Platform Edge Networkに送信されます。 データの転送先となるサービスを決定するデータストリームです。

設定では、ゲームから収集したデータをAdobe Experience Platformのデータセットに送信する必要があります。

データストリームを設定するには:

  1. Adobe Experience Platform UI の左パネルで、「データ収集」から「データストリーム」を選択します。

  2. 新しいデータストリーム ​を選択します。

  3. データストリームに名前を付けて説明します。イベントスキーマリストからスキーマを選択します。

    新規データストリーム

  4. 保存」を選択します。

  5. サービスを追加」を選択します。

  6. サービスを追加画面で、次の操作を行います。

    1. サービスリストから​ Adobe Experience Platform を選択します。

    2. 有効」が選択されていることを確認します。

    3. イベントデータセットリストからお使いのデータセットを選択します。

      Datastream AEP サービス

    4. その他の設定はそのままにし、「保存」を選択してデータストリームを保存します。

これで、ゲームから収集したデータをAdobe Experience Platformのデータセットに転送するように、データストリームが設定されました。

データストリームの設定方法と機密データの処理方法について詳しくは、データストリームの概要を参照してください。