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

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

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

重要

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

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

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

前提条件

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

重要

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

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

この 同意および環境設定の詳細 フィールドグループは、スキーマに標準化された同意フィールドを提供します。 現在、このフィールドグループは、 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"
  }
}
メモ

のサブプロパティの構造と意味について詳しくは、 consents詳しくは、 同意および環境設定の詳細 フィールドグループ.

必須フィールドグループを Profile スキーマ

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

  • 同意および環境設定の詳細
  • IdentityMap (Platform Web または Mobile 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 および Mobile SDK は、consent-change コマンドのカスタムフィールドをサポートしていません。 現在、カスタム同意フィールドをプロファイルに取り込む方法は、 バッチ取得 または ソース接続.

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

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

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

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

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

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

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

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

このスキーマのデータセットを作成していない場合は、 データセットの作成.

このページ