同意データと基本設定データを取り込むためのデータセットの設定

Adobe Experience Platformで顧客の同意/環境設定データを処理するには、そのデータを、同意やその他の権限に関連するフィールドをスキーマに含むデータセットに送信する必要があります。 具体的には、このデータセットはXDM Individual Profile クラスに基づいており、Real-Time Customer Profileで使用できるように有効にする必要があります。

このドキュメントでは、Experience Platformで同意データを処理するようにデータセットを設定する手順について説明します。 Experience Platformで同意/環境設定データを処理するための完全なワークフローの概要については、同意処理の概要を参照してください。

前提条件

このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

同意と環境設定の詳細 フィールドグループ構造 structure

同意と環境設定の詳細 フィールドグループは、標準化された同意フィールドをスキーマに提供します。 現在、このフィールドグループは、XDM Individual Profile クラスに基づくスキーマとのみ互換性があります。

フィールドグループは、単一のオブジェクトタイプフィールド consentsを提供します。このサブプロパティは、標準化された同意フィールドのセットをキャプチャします。 次のJSONは、データ取り込み時にconsentsが期待するデータの種類の例です。

{
  "consents": {
    "collect": {
      "val": "y",
    },
    "share": {
      "val": "y",
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "y"
      },
      "push": {
        "val": "n",
        "reason": "Too Frequent",
        "time": "2019-01-01T15:52:25+00:00"
      }
    },
    "idSpecific": {
      "email": {
        "jdoe@example.com": {
          "marketing": {
            "email": {
              "val": "n"
            }
          }
        }
      }
    }
  },
  "metadata": {
    "time": "2019-01-01T15:52:25+00:00"
  }
}

必須フィールドグループをProfile スキーマに追加する add-field-group

Adobe標準を使用して同意データを収集するには、次の2つのフィールドグループを含むプロファイル対応スキーマが必要です。

Experience Platform UIで、左側のナビゲーションで「スキーマ」を選択し、「参照」タブを選択して、既存のスキーマのリストを表示します。 ここから、同意フィールドを追加するProfile対応スキーマの名前を選択します。 このセクションのスクリーンショットでは、​ スキーマ作成チュートリアル ​で構築された「ロイヤルティメンバー」スキーマを例として使用しています。

Schema Editorが表示され、キャンバス内のスキーマの構造が表示されます。 キャンバスの左側で、「フィールドグループ」セクションの「追加」を選択します。

フィールドグループを追加 ダイアログが表示されます。 ここから、リストから「同意と環境設定の詳細」を選択します。 オプションで、検索バーを使用して結果を絞り込み、フィールドグループを簡単に見つけることができます。

次に、リストから​IdentityMap フィールドグループを見つけて、選択します。 両方のフィールドグループが右側のパネルに表示されたら、フィールドグループを追加​を選択します。

キャンバスが再び表示され、consentsおよびidentityMap フィールドがスキーマ構造に追加されたことを示します。 標準フィールドグループによってキャプチャされない追加の同意と環境設定フィールドが必要な場合は、​ スキーマへのカスタム同意と環境設定フィールドの追加に関する付録の節を参照してください。 それ以外は、保存​を選択して、スキーマの変更を確定します。

編集したスキーマが、Experience Platform Web SDK データストリームで指定された​ プロファイルデータセット ​で使用されている場合、そのデータセットには新しい同意フィールドが含まれるようになりました。 同意処理ガイド ​に戻って、同意データを処理するExperience Platformの設定処理を続行できるようになりました。 このスキーマのデータセットを作成していない場合は、次の節の手順に従います。

同意スキーマにもとづいたデータセットの作成 dataset

同意フィールドを含むスキーマを作成したら、顧客の同意データを最終的に取り込むデータセットを作成する必要があります。 このデータセットはReal-Time Customer Profileに対して有効にする必要があります。

開始するには、左側のナビゲーションで「データセット」を選択し、右上隅の「データセットを作成」を選択します。

次のページで、スキーマからデータセットを作成​を選択します。

スキーマを選択 ステップから開始して、スキーマからデータセットを作成 ワークフローが表示されます。 提供されたリストで、以前に作成した同意スキーマの1つを見つけます。 オプションで、検索バーを使用して結果を絞り込み、スキーマを簡単に見つけることができます。 目的のスキーマの横にあるラジオボタンを選択し、次へ​を選択して続行します。

データセットの設定​手順が表示されます。 完了​を選択する前に、データセットの一意で簡単に識別できる名前と説明を入力してください。

新しく作成したデータセットの詳細ページが表示されます。 データセットが時系列スキーマに基づいている場合、プロセスは完了します。 データセットがレコードスキーマに基づいている場合、プロセスの最後の手順は、Real-Time Customer Profileで使用するデータセットを有効にすることです。

右側のパネルで、プロファイル​切り替えを選択します。

最後に、確認ポップオーバーで「有効にする」を選択して、Profileのスキーマを有効にします。

データセットが保存され、Profileでの使用が有効になりました。 Experience Platform Web SDKを使用して同意データをプロファイルに送信する場合、​ データストリーム ​を設定する際に、このデータセットを​ プロファイルデータセット ​として選択する必要があります。

次の手順

このチュートリアルでは、同意フィールドをProfile対応スキーマに追加しました。このスキーマのデータセットは、Experience Platform Web SDKまたはダイレクト XDM インジェストを使用して同意データを取り込むために使用されます。

同意処理の概要に戻って、引き続きExperience Platformを設定して同意データを処理できるようになりました。

付録

次の節では、顧客の同意と環境設定データを取り込むためのデータセットの作成に関する追加情報を示します。

カスタム同意フィールドと環境設定フィールドをスキーマに追加します custom-consent

標準の同意と環境設定の詳細 フィールドグループで表されるシグナル以外の追加の同意シグナルをキャプチャする必要がある場合は、カスタム XDM コンポーネントを使用して、特定のビジネスニーズに合わせて同意スキーマを強化できます。 このセクションでは、これらのシグナルをプロファイルに取り込むために、同意スキーマをカスタマイズする方法の基本原則の概要を説明します。

同意データの構造全体をゼロから作成しようとするのではなく、同意と環境設定の詳細 フィールドグループをベースラインとして使用し、必要に応じて追加のフィールドを追加することを強くお勧めします。

標準フィールドグループの構造にカスタムフィールドを追加するには、まずカスタムフィールドグループを作成する必要があります。 同意と環境設定の詳細 フィールドグループをスキーマに追加したら、フィールドグループ セクションの​プラス（+） アイコンを選択し、新しいフィールドグループを作成​を選択します。 フィールドグループの名前とオプションの説明を入力し、フィールドグループを追加​を選択します。

Schema Editorが再び表示され、左側のパネルで新しいカスタムフィールドグループが選択されています。 キャンバスには、カスタムフィールドをスキーマ構造に追加できるコントロールが表示されます。 新しい同意または環境設定フィールドを追加するには、consents オブジェクトの横にある​プラス（+） アイコンを選択します。

consents オブジェクト内に新しいフィールドが表示されます。 カスタムフィールドを標準XDM オブジェクトに追加するため、新しいフィールドは、テナント IDに名前空間が設定されたオブジェクトの下に作成されます。

フィールドプロパティ​の下の右側のパネルで、フィールドの名前と説明を入力します。 フィールドの​ タイプ ​を選択する場合、カスタム同意または環境設定フィールドに適切な標準データタイプを使用する必要があります。

完了したら、適用​を選択します。

同意または環境設定フィールドがスキーマ構造に追加されます。 右側のパネルに表示されている​ パス ​には、_tenantId名前空間が含まれています。 この名前空間は、データ操作でこのフィールドへのパスを参照するたびに含める必要があります。

必要な同意フィールドと環境設定フィールドを引き続き追加するには、上記の手順に従います。 完了したら、保存​を選択して変更を確認します。

このスキーマのデータセットを作成していない場合は、​ データセットの作成の節に進みます。