[ベータ版]{class="badge informative"}
Didomi をExperience Platformに接続
このガイドでは、UI のソースワークスペースを使用して Didomi アカウントをAdobe Experience Platformに接続する方法について説明します。
- このドキュメントページは、Didomi チームが作成したものです。 お問い合わせや更新のリクエストについては、support@didomi.io まで直接ご連絡ください。
- 接続を生成する手順については、Didomi Adobe ソースコネクタのドキュメントを参照してください。
基本を学ぶ
このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
-
Experience Data Model (XDM) システム：Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本：スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル：スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile：複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
Didomi アカウントの設定
続行する前に、「概要 Didomi に記載されている前提条件の手順を読んで完了し、アカウントをExperience Platformに正常に接続していることを確認してください。
ソースカタログのナビゲート
Experience Platformの UI で、左側のナビゲーションから Sources を選択し、Sources ワークスペースにアクセスします。 カテゴリを選択するか、検索バーを使用してソースを検索します。
Didomi に接続するには、[データベース] カテゴリに移動し、[Didomi ソース カードを選択してから [設定] を選択します。
ソースデータスキーマの追加
次に、データを選択 インターフェイスを使用して、（前提条件の手順でダウンロードした JSON ファイルをアップロードます。
プレビューインターフェイスを使用して、ペイロードのファイル構造を表示できます。 終了したら、「次へ」を選択します。
データフローの詳細を入力
次に、データセットとデータフローに関する情報を指定する必要があります。
データセットの詳細
データセットは、スキーマ（列）とフィールド（行）で構成されるデータコレクション（通常はテーブル）を格納し管理するための構造です。Experience Platformに正常に取り込まれたデータは、データレイク内にデータセットとして保持されます。
この手順では、既存のデータセットを使用するか、新しいデータセットを作成します。
データセットがリアルタイム顧客プロファイルに対して有効になっている場合、この手順の間に プロファイルデータセット を切り替えて、プロファイル取り込み用のデータを有効にすることができます。 また、この手順を使用して、エラー診断 および 部分取り込み を有効にすることもできます。
- エラー診断: エラー診断 を選択して、データセットアクティビティとデータフローステータスを監視する際に後で参照できるエラー診断を生成するようにソースに指示します。
- 部分取り込み：部分バッチ取り込みは、設定可能な特定のしきい値まで、エラーを含んだデータを取り込む機能です。 この機能を使用すると、正確なデータをすべてExperience Platformに正常に取り込みながら、不正なデータがすべて無効な理由に関する情報と共に個別にバッチ処理されます。
データフローの詳細
データセットを設定したら、名前、説明（オプション）、アラート設定など、データフローの詳細を指定する必要があります。
Experience Platformは、ユーザーが登録できるイベントベースのアラートを作成でき、これらのオプションは、これらをトリガーにする実行中のデータフローです。 詳しくは、 アラートの概要を参照してください
- ソースデータフロー実行開始：データフロー実行が開始したときに通知を受け取るには、このアラートを選択します。
- ソースデータフロー実行成功：データフローがエラーなく終了した場合に通知を受け取るには、このアラートを選択します。
- ソースデータフロー実行の失敗：データフローの実行がエラーで終了した場合に通知を受け取るには、このアラートを選択します。
マッピング
マッピングインターフェイスを使用して、データをExperience Platformに取り込む前に、ソースデータを適切なスキーマフィールドにマッピングします。 詳しくは、UI の マッピングガイドを参照してください。
マッピングは、からExperience Platform データセットに 目的のデータ Didomi を転送するために特別に使用されます。 これらの目的は、ユーザーの同意の選択肢（分析、パーソナライゼーション、広告のためなど）を表し、この統合で許可される唯一のマッピングフィールドです。
Webhook 設定からダウンロードしたサンプル Webhook ペイロード Didomi を使用して、各 Didomi の目的をAdobe データセットの適切なフィールドにマッピングします。
終了したら、「次へ」を選択します。
レビュー
レビュー 手順が表示され、データフローを作成する前に詳細をレビューできます。 詳細は、次のカテゴリ内でグループ化されます。
- 接続：アカウント名、ソースプラットフォーム、ソース名が表示されます。
- データセットの割り当てとフィールドのマッピング：ターゲットデータセットと、そのデータセットが準拠するスキーマを表示します。
詳細が正しいことを確認したら、「終了」を選択します。
ストリーミングエンドポイント URL の取得
接続が作成されると、ソースの詳細ページが表示されます。 このページには、以前に実行したデータフロー、ID、ストリーミングエンドポイント URL など、新しく作成した接続の詳細が表示されます。
Adobeの設定を完了します。
データフローが作成されたら、ソース カタログに移動し、「データフロー」を選択します。 データフローディレクトリを使用して Didomi のデータフローを探し、データフローアクティビティ インターフェイスにアクセスします。 次に、右側のパネルの プロパティ パネルを使用して、以下の値を取得します。
- ストリーミングエンドポイント
- データフロー ID
Experience Platform UI で、次の操作を行います。
- 設定が完了したら、Webhook の初期設定で見つからなかった設定パラメーターを確認します。
- これらの値が使用可能になったら、Didomi に戻り、Webhook 設定を更新します。
Webhook 設定の更新
設定が完了したら、Didomi コンソールに戻り、ストリーミングエンドポイント URL と データフロー ID を使用して Webhook 設定を更新します。
これが完了 Didomi ると、統合を通じて同意管理および環境設定管理イベントの送信が開始され、データがAdobe データセットに保存されます。
次の手順
このチュートリアルでは、Didomi ソースからExperience Platformにバッチデータを取り込むデータフローを正常に作成しました。 その他のリソースについては、以下に概要を説明するドキュメントを参照してください。
データフローの監視
データフローを作成したら、そのデータフローを通じて取り込まれるデータを監視し、取り込み率、成功、エラーに関する情報を表示できます。 データフローのモニタリング方法について詳しくは、UI でのアカウントとデータフローのモニタリングのチュートリアルを参照してください。
データフローの更新
データフローのスケジュール、マッピング、一般情報の設定を更新するには、UI でのソースデータフローの更新に関するチュートリアルを参照してください。
データフローの削除
不要になったデータフローや誤って作成されたデータフローは、データフロー ワークスペース内にある 削除 機能で削除できます。データフローの削除方法について詳しくは、UI でのデータフローの削除のチュートリアルを参照してください。