[ベータ版]{class="badge informative"}
Didomi
Didomiは、組織がweb サイト、アプリ、社内ツールをまたいで、個人データに関するユーザーの選択を収集、管理、適用するのに役立つ同意および環境設定の管理プラットフォームです。
Adobe Experience Platformでは、ソースコネクタを使用して、クラウドストレージ、データベース、Didomiなどのアプリケーションなど、幅広い外部システムからデータを取り込むことができます。 ソースを使用して外部システムを認証し、Experience Platformへのデータフローを管理します。これにより、顧客データの一貫性のある構造化された取り込みが可能になります。
Didomi ソースを使用して、Didomiの同意と環境設定の管理プラットフォームからリアルタイムのユーザー同意と環境設定データをExperience Platformにストリーミングします。 Didomi ソースを使用すると、Experience Platformの同意データを一元化して処理できるため、顧客プロファイルとダウンストリームのワークフローをコンプライアンスに準拠させ、最新の状態に保つことができます。
前提条件
Didomi アカウントをExperience Platformに正常に接続するには、次の前提条件の手順を実行します。
IP アドレスの許可リスト
ソースをExperience Platformに接続する前に、リージョン固有のIP アドレスをードに追加する必要があります。 詳しくは、Experience PlatformへのIP アドレスの許可リストに加えるに関するガイドを参照してください。
Experience Platformの権限の設定
View Sources アカウントをExperience Platformに接続するには、アカウントに対して Manage Sources とDidomiの両方の権限を有効にする必要があります。 必要な権限を取得するには、製品の管理者にお問い合わせください。 詳しくは、 アクセス制御UI ガイド を参照してください。
Adobe API資格情報の収集
DidomiをExperience Platformに安全に接続するには、Adobe API資格情報を使用して認証する必要があります。 これらの資格情報は、Webhookの設定とデータ取り込みの設定に不可欠です。
Experience Platform APIを正常に呼び出す方法について詳しくは、Experience Platform APIの概要に関するガイドを参照してください。
Experience Platform スキーマの作成
Experience Data Model （XDM）スキーマは、DidomiからExperience Platformに送信するデータの構造（ユーザーID、同意目的など）を定義します。
スキーマを作成するには、Experience Platform UIの左側のナビゲーションで「Schemas」を選択し、「Create schema」を選択します。 次に、スキーマタイプとして「Standard」を選択し、Manual」を選択してフィールドを手動で作成します。 スキーマの基本クラスを選択し、スキーマの名前を指定します。
作成したら、必須フィールドのいずれかを追加してスキーマを更新します。 1つ以上のフィールドが、プライマリ ID値についてExperience Platformに通知するIdentity フィールドであることを確認してください。 最後に、データを正常に保存するために、Profile トグルを有効にします。
詳しくは、UIでのスキーマの作成に関するガイドを参照してください。
データセットの作成
Experience Platformの データセット は、定義したスキーマに基づいて受信データを保存するために使用されます。
データセットを作成するには、Experience Platform UIの左側のナビゲーションで「Datasets」を選択し、「Create dataset」を選択します。 次に、Create dataset from schemaを選択し、新しいデータセットに関連付けるスキーマを選択します。
Didomi コンソールでのHTTP Webhookの設定
Webhooksを使用すると、ユーザーが同意設定を操作したときにDidomi プラットフォームでトリガーされるイベントを購読できます。 関連するイベントが発生した場合（例えば、ユーザーが同意を与えたり取り消したりした場合）、Didomiは、JSON ペイロードを含むリアルタイムのHTTP POST リクエストを、設定されたwebhook エンドポイントに送信します。
Experience Platformとの互換性を確保するには、Webhookが次の要件を満たしている必要があります。
d8f3b2e1-4c9a-4a7f-9b2e-8f1c3d2a1b6eclient_credentialsに設定します。client_credentialsopenid,AdobeID,read_organizations,additional_info.projectedProductContext,session{"Content-type": "application/x-www-form-urlencoded"}https://ims-na1.adobelogin.com/ims/token/v3https://dcs.adobedc.net/collection/your-adobe-endpoint-id次に、次のオプションをwebhookに設定します。
x-adobe-flow-idが含まれていることを確認してください。 この値は、 データフローの作成後に取得できます。{"Content-Type": "application/json", "Cache-Control": "no-cache", "x-adobe-flow-id": "{DATAFLOW_ID}"}event.* イベント （user.*またはwebhook）の特定のグループを選択します。 event.*を使用して同意または環境設定の変更を追跡し、user.*を使用してユーザープロファイルの更新を追跡します。 この選択は、互換性のあるイベントのみがAdobeに送信されるようにするために必要です。 Adobeでは、データフローごとに1つのスキーマしかサポートされていないため、両方のイベントタイプを選択すると、取り込みエラーが発生する可能性があります。サポートされるイベントタイプのリストは次のとおりです。
Event.createdEvent.updatedEvent.deletedUser.createdUser.updatedUser.deleted
サンプルペイロードファイルのダウンロード download-the-sample-payload-file
選択したイベントグループに基づいて、適切な サンプルペイロードファイル をDidomi コンソールから直接ダウンロードします。 このファイルはデータの構造を表し、Adobeのスキーマとマッピングステップで使用されます。
event.*event.createdのサンプルをダウンロードevent.*件のイベントのみをフィルタリングuser.*user.createdのサンプルをダウンロードuser.*件のイベントのみをフィルタリングDidomi アカウントをExperience Platformに接続する
ソース接続を作成し、からExperience Platformに同意と環境設定データを取り込む方法については、 Didomi Experience Platformへの接続Didomiに関するガイドをご覧ください。