同意データと基本設定データを取り込むためのデータセットの設定
Adobe Experience Platformが顧客の同意/環境設定データを処理するには、そのデータを、同意および他の権限に関連するフィールドを含むスキーマのデータセットに送信する必要があります。 特に、このデータセットは、 XDM Individual Profile クラスに含まれ、での使用が有効になっています。 Real-Time Customer Profile.
このドキュメントでは、Experience Platformで同意データを処理するようにデータセットを設定する手順を説明します。 Platform で同意/環境設定データを処理するための完全なワークフローの概要については、 同意処理の概要.
- 標準化された同意フィールドグループ
- 組織で作成されたカスタム同意フィールドグループ
- 標準化された同意フィールドグループと、カスタム同意フィールドグループによって提供される追加フィールドの組み合わせ
前提条件
このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
- エクスペリエンスデータモデル(XDM):Experience Platform が顧客エクスペリエンスデータを整理する際に使用する標準化されたフレームワーク。
- スキーマ構成の基本:XDM スキーマの基本的な構成要素について説明します。
- リアルタイム顧客プロファイル:異なるソースの顧客データを完全な統合ビューに統合し、顧客インタラクションごとに実用的なタイムスタンプ付きの説明を提供します。
同意および環境設定の詳細 フィールドグループ構造 structure
The 同意および環境設定の詳細 フィールドグループは、スキーマに標準化された同意フィールドを提供します。 現在、このフィールドグループは、 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 スキーマ add-field-group
Adobe標準を使用して同意データを収集するには、次の 2 つのフィールドグループを含むプロファイル対応のスキーマが必要です。
- 同意および環境設定の詳細
- IdentityMap (Platform Web または Mobile SDK を使用して同意シグナルを送信する場合に必要)
Platform UI で、「 」を選択します。 スキーマ 左側のナビゲーションで、 参照 タブをクリックして、既存のスキーマのリストを表示します。 ここから、 Profile同意フィールドを追加する有効なスキーマです。 この節のスクリーンショットは、 スキーマ作成チュートリアル を例として示します。
The Schema Editor が表示され、キャンバスにスキーマの構造が表示されます。 キャンバスの左側で、を選択します。 追加 の下に フィールドグループ 」セクションに入力します。
The フィールドグループを追加 ダイアログが表示されます。 ここからを選択します。 同意および環境設定の詳細 を選択します。 オプションで、検索バーを使用して結果を絞り込み、フィールドグループを見つけやすくすることができます。
次に、 IdentityMap フィールドグループを選択し、同様に選択します。 両方のフィールドグループが右側のパネルに表示されたら、「 」を選択します。 フィールドグループを追加.
キャンバスが再び表示され、 consents
および identityMap
フィールドがスキーマ構造に追加されました。 標準フィールドグループで取り込まれない追加の同意および環境設定フィールドが必要な場合は、「付録」の「 スキーマへのカスタム同意フィールドと環境設定フィールドの追加. それ以外の場合は、「 保存 を使用して、スキーマの変更を完了します。
編集したスキーマが プロファイルデータセット Platform Web SDK データストリームで指定した場合、そのデータセットに新しい同意フィールドが含まれるようになります。 これで、 同意処理ガイド :同意データを処理するExperience Platformの設定プロセスを続行します。 このスキーマのデータセットをまだ作成していない場合は、次の節の手順に従います。
同意スキーマに基づくデータセットの作成 dataset
同意フィールドを含むスキーマを作成したら、顧客の同意データを最終的に取り込むデータセットを作成する必要があります。 このデータセットを有効にする必要があります Real-Time Customer Profile.
最初に、「 」を選択します。 データセット 左側のナビゲーションで、「 データセットを作成 をクリックします。
次のページで、 スキーマからデータセットを作成.
The スキーマからデータセットを作成 ワークフローが表示され、 スキーマを選択 手順 提供されたリストで、以前に作成した同意スキーマの 1 つを探します。 オプションで、検索バーを使用して結果を絞り込み、スキーマを見つけやすくすることができます。 目的のスキーマの横にあるラジオボタンを選択し、「 」を選択します。 次へ をクリックして続行します。
データセットの設定 手順が表示されます。選択する前に、データセットの一意で、簡単に識別できる名前と説明を指定します 完了.
新しく作成されたデータセットの詳細ページが表示されます。 データセットが時系列スキーマに基づいている場合、プロセスは完了です。 データセットがレコードスキーマに基づいている場合、プロセスの最後の手順は、で使用するデータセットを有効にすることです Real-Time Customer Profile.
右側のレールで、 プロファイル 切り替え
最後に、 有効にする 確認ポップオーバーで、次のスキーマを有効にします。 Profile.
これでデータセットが保存され、での使用が有効になりました。 Profile. Platform Web SDK を使用して同意データをプロファイルに送信する場合は、このデータセットを プロファイルデータセット を設定する際に datastream.
次の手順
このチュートリアルに従うことで、に同意フィールドを追加しました。 Profile — 有効なスキーマ。このスキーマのデータセットは、Platform Web SDK または直接 XDM 取り込みを使用して同意データを取り込むために使用されます。
これで、 同意処理の概要 :同意データを処理するExperience Platformの設定を続行します。
付録
次の節では、顧客の同意と環境設定データを取り込むデータセットの作成に関する追加情報を示します。
スキーマへのカスタムの同意フィールドと環境設定フィールドの追加 custom-consent
標準で表される以外の同意シグナルを追加で取得する必要がある場合 同意および環境設定の詳細 フィールドグループ内で、カスタム XDM コンポーネントを使用して、特定のビジネスニーズに合わせて同意スキーマを拡張できます。 この節では、これらのシグナルをプロファイルに取り込むための同意スキーマのカスタマイズ方法の基本原則について説明します。
次を使用することを強くお勧めします: 同意および環境設定の詳細 フィールドグループを同意データの構造のベースラインとして追加することで、構造全体を一から作成するのではなく、必要に応じてフィールドを追加することができます。
標準フィールドグループの構造にカスタムフィールドを追加するには、まずカスタムフィールドグループを作成する必要があります。 追加後 同意および環境設定の詳細 スキーマに対するフィールドグループで、 プラス (+) アイコン フィールドグループ 」セクションで、 新しいフィールドグループを作成. フィールドグループの名前と説明(オプション)を入力し、「 」を選択します。 フィールドグループを追加.
The Schema Editor 左側のパネルで新しいカスタムフィールドグループを選択して再び表示されます。 キャンバスに、カスタムフィールドをスキーマ構造に追加できるコントロールが表示されます。 新しい同意または環境設定フィールドを追加するには、 プラス (+) 横のアイコン consents
オブジェクト。
新しいフィールドが consents
オブジェクト。 標準の XDM オブジェクトにカスタムフィールドを追加するので、新しいフィールドはテナント ID に名前空間化されたオブジェクトの下に作成されます。
の下の右側のレールで フィールドのプロパティ」で、フィールドの名前と説明を入力します。 フィールドの タイプ の場合は、カスタムの同意または環境設定フィールドに適した標準データタイプを使用する必要があります。
完了したら、「適用」を選択します。
同意または環境設定フィールドがスキーマ構造に追加されます。 なお、 パス 右側のレールに表示される _tenantId
名前空間。 データ操作でこのフィールドへのパスを参照する際には必ず、この名前空間を含める必要があります。
必要な同意フィールドと環境設定フィールドの追加を続行するには、上記の手順に従います。 終了したら、「 」を選択します。 保存 をクリックして変更を確定します。
このスキーマのデータセットを作成していない場合は、「 データセットの作成.