[ベータ版]{class="badge informative"}

Didomi

AVAILABILITY
Didomi ソースはベータ版です。ベータラベル付きソースの使用について詳しくは、ソースの概要の 利用条件を参照してください。

Didomi は、組織が web サイト、アプリ、内部ツールをまたいで個人データに関するユーザーの選択を収集、管理、適用するのに役立つ、同意および環境設定管理プラットフォームです。

Adobe Experience Platformは、ソースコネクタのシステムを介して、クラウドストレージ、データベース、Didomi のようなアプリケーションなど、様々な外部システムからのデータ取り込みをサポートしています。 ソースを使用して外部システムを認証し、Experience Platformへのデータフローを管理し、顧客データの一貫性のある構造化された取り込みを確保します。

Didomi ソースを使用すると、ユーザーの同意および環境設定に関するリアルタイムのデータを Didomi の同意および環境設定管理プラットフォームからExperience Platformにストリーミングできます。 Didomi ソースを通じて、Experience Platformで同意データを一元化して処理できるので、顧客プロファイルとダウンストリームワークフローを準拠させ、最新の状態に保つことができます。

「Didomi」データ処理アーキテクチャ

前提条件

Didomi アカウントをExperience Platformに正常に接続するには、以下に説明する前提条件の手順を実行してください。

IP アドレスの許可リスト

ソースをExperience Platformに接続する前に、地域固有の IP アドレスを許可リストに追加する必要があります。 詳しくは、Experience Platformへの接続に対する IP アドレスの許可リストに加える に関するガイドを参照してください。

Experience Platformに対する権限の設定

アカウントをExperience Platformに接続するには、アカウントで ソースの表示 および ソースの管理 Didomi 権限の両方が有効になっている必要があります。 必要な権限を取得するには、製品管理者にお問い合わせください。 詳しくは、 アクセス制御 UI ガイドを参照してください。

Adobe API 資格情報の収集

Didomi をExperience Platformに安全に接続するには、Adobe API 資格情報を使用して認証する必要があります。 これらの資格情報は、Webhook の設定とデータ取り込みの設定に不可欠です。

Experience Platform API を正常に呼び出す方法については、Experience Platform API の概要に関するガイドを参照してください。

Experience Platform スキーマの作成

TIP
既存の XDM スキーマがある場合は、この手順をスキップできます。

エクスペリエンスデータモデル(XDM)スキーマ は、Didomi ーザーからExperience Platformに送信するデータの構造(ユーザー ID、同意目的など)を定義します。

スキーマを作成するには、Experience Platform UI の左側のナビゲーションで「​ スキーマ ​」を選択し、「スキーマを作成」を選択します。 次に、スキーマタイプとして 標準 を選択し、次に 手動 を選択して、フィールドを手動で作成します。 スキーマの基本クラスを選択し、スキーマの名前を指定します。

作成したら、必須フィールドを追加してスキーマを更新します。 少なくとも 1 つのフィールドが、プライマリ ID 値についてExperience Platformに通知する ID フィールドであることを確認してください。 最後に、データを正常に保存するために、「​ プロファイル ​」トグルを有効になっていることを確認します。

create-schema

詳しくは、UI でのスキーマの作成に関するガイドを参照してください。

データセットの作成

TIP
既存のデータセットが既にある場合は、この手順をスキップできます。

Experience Platformの データセット は、定義したスキーマに基づいて受信データを保存するために使用されます。

データセットを作成するには、Experience Platform UI の左側のナビゲーションで ​ データセット ​ を選択してから、「データセットを作成」を選択します。 次に、「スキーマからデータセットを作成」を選択し、新しいデータセットに関連付けるスキーマを選択します。

データセットを作成

Didomi コンソールで HTTP Webhook を設定します

Webhooks を使用すると、ユーザーが同意環境設定で操作する際に、Didomi platform でトリガーされるイベントを登録できます。 関連するイベントが発生すると(ユーザーが同意の付与や取り消しを行った場合など)、Didomi は、設定された webhook エンドポイントに JSON ペイロードを含むリアルタイム HTTP POST リクエストを送信します。

didomi-console

Experience Platformとの互換性を確保するには、Webhook が次の要件を満たしている必要があります。

フィールド
説明
クライアントシークレット
Adobe API 資格情報に関連付けられた秘密鍵。
d8f3b2e1-4c9a-4a7f-9b2e-8f1c3d2a1b6e
API キー
Adobe サービスへのリクエストの認証に使用される公開 API キー。
付与タイプ
アプリケーションが認証サーバーからアクセストークンを取得する方法。 この値を client_credentials に設定します。
client_credentials
範囲
認証範囲は、アプリケーションが API プロバイダーにリクエストする特定の権限またはアクセスレベルを定義します。
openid,AdobeID,read_organizations,additional_info.projectedProductContext,session
認証ヘッダー
Adobe トークンリクエストに必要な追加ヘッダー。
{"Content-type": "application/x-www-form-urlencoded"}
トークン URL
Adobe トークンエンドポイント。
https://ims-na1.adobelogin.com/ims/token/v3
エンドポイント URL
最終的なAdobe コネクタ URL (セットアップの最後に提供されます)。
https://dcs.adobedc.net/collection/your-adobe-endpoint-id

次に、webhook ークフローに次のオプションを設定します。

フィールド
説明
リクエストヘッダー
webhook のカスタムヘッダー。 必ず x-adobe-flow-id を含めてください。 この値は、 データフローが作成された後に取得できます。
{"Content-Type": "application/json", "Cache-Control": "no-cache", "x-adobe-flow-id": "{DATAFLOW_ID}"}
Flatten
webhook データがフラットなオブジェクトとして送信されるので、このプロパティをオンにする必要があります。
有効
イベントタイプ
Didomi をトリガーする event.* イベントのグループ (user.* または webhook)を選択します。 event.* を使用して同意または環境設定の変更を追跡し、user.* を使用してユーザープロファイルの更新を追跡します。 この選択項目は、互換性のあるイベントのみをAdobeに送信するために必要です。 Adobeはデータフローごとに 1 つのスキーマのみをサポートするので、両方のイベントタイプを選択すると、取り込みエラーが発生する可能性があります。

サポートされているイベントタイプのリストを以下に示します。

  • Event.created
  • Event.updated
  • Event.deleted
  • User.created
  • User.updated
  • User.deleted

サンプルペイロードファイルをダウンロードします。 download-the-sample-payload-file

選択したイベントグループに応じて、適切な サンプルペイロードファイル を Didomi Console から直接ダウンロードします。 このファイルは、データの構造を表し、Adobeのスキーマおよびマッピング手順で使用されます。

イベントグループ
ダウンロードするサンプルファイル
フィルターオプション
event.*
event.created のサンプルをダウンロードします
event.* イベントにのみフィルター
user.*
user.created のサンプルをダウンロードします
user.* イベントにのみフィルター

Didomi アカウントのExperience Platformへの接続

ソース接続を作成し、 からExperience Platformに同意データと環境設定データを取り込む方法については、 DidomiExperience Platformへの接続 Didomi に関するガイドを参照してください。

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089