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

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

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

重要

このガイドの例では、顧客の同意の値を表す標準化されたフィールドのセットを使用します。この値は、同意と環境設定の詳細 スキーマフィールドグループ で定義されます。 これらのフィールドの構造は、多くの一般的な同意収集の使用例を対象とする、効率的なデータモデルを提供することを目的としています。

ただし、独自のデータモデルに従って同意を表す独自のフィールドグループを定義することもできます。 次のオプションに基づいて、ビジネスニーズに合った同意データモデルの承認を得るには、法務チームに問い合わせてください。

  • 標準化された同意フィールドグループ
  • 組織で作成されたカスタムの同意フィールドグループ
  • 標準化された同意フィールドグループと、カスタムの同意フィールドグループによって提供される追加フィールドの組み合わせ

前提条件

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

重要

このチュートリアルでは、顧客属性情報の取得に使用する Platform の Profile スキーマを理解していることを前提としています。 同意データの収集方法に関係なく、このスキーマはリアルタイム顧客プロファイル 🔗 に対して有効にする必要があります。 さらに、スキーマのプライマリ ID を、電子メールアドレスなどの興味/関心に基づく広告での使用を禁止する、直接識別可能なフィールドにすることはできません。 どのフィールドが制限されているかが不明な場合は、弁護士に相談してください。

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

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

フィールドグループには、1 つのオブジェクトタイプフィールド 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"
  }
}
メモ

consents 内のサブプロパティの構造と意味について詳しくは、同意と環境設定の詳細 フィールドグループ の概要を参照してください。

Profile スキーマに必要なフィールドグループを追加する

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

  • 同意と環境設定の詳細
  • IdentityMap (Platform Web またはモバイル SDK を使用して同意シグナルを送信する場合に必要)

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

ヒント

ワークスペースの検索およびフィルタリング機能を使用すると、スキーマを見つけやすくなります。 詳しくは、XDM リソース のガイドを参照してください。

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

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

次に、リストから IdentityMap フィールドグループを探し、選択します。 両方のフィールドグループが右側のレールに表示されたら、「フィールドグループを追加」を選択します。

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

重要

新しいスキーマを作成する場合、またはプロファイルに対して有効になっていない既存のスキーマを編集する場合は、保存する前に プロファイル のスキーマを有効にする必要があります。

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

同意スキーマに基づくデータセットの作成

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

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

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

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

データセットの設定​手順が表示されます。「完了」を選択する前に、データセットの一意でわかりやすい名前と説明を指定します。

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

右側のレールで、「プロファイル」切り替えを選択します。

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

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

次の手順

このチュートリアルに従って、Profile が有効なスキーマに同意フィールドを追加しました。このデータセットは、Platform Web SDK または直接 XDM 取得を使用して同意データを取得するために使用されます。

同意処理の概要 に戻り、同意データを処理するためのExperience Platformの設定を続行できます。

付録

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

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

重要

Platform Web およびモバイル SDK は、同意変更コマンドのカスタムフィールドをサポートしていません。 現在、カスタム同意フィールドをプロファイルに取り込む唯一の方法は、 バッチ取り込み または ソース接続 を通じてです。

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

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

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

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

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

終了したら、「適用」を選択します。

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

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

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

このページ