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

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 の名前空間が含まれています。 データ操作でこのフィールドへのパスを参照する場合は、常にこの名前空間を含める必要があります。

上記の手順に従って、必要な同意および環境設定フィールドの追加を続行します。 終了したら、「保存 を選択して変更を確定します。

このスキーマ用のデータセットをまだ作成していない場合は、​ データセットの作成 ​ の節に進んでください。