Destination SDK の設定オプション
Adobe Experience Platformの宛先サービスは、宛先機能を構築する複数のコンポーネントに対して設定エンドポイントを使用します。
これらのコンポーネントを組み合わせることで、Experience Platform は、宛先プラットフォームに接続したり、カスタムメッセージを送信したり、カスタムファイルを書き出したり、デジタルエコシステム全体にわたってプロファイルデータをアクティブ化したりできます。
以下の図に、独自の宛先を作成するために Destination SDK を通じて設定できるコンポーネントの概要を示します。これらのコンポーネントについては、後述します。
サーバー設定 server-configuration
宛先サーバー設定は、サーバー仕様に関する情報と宛先にペイロードを配信するためにアドビが使用するテンプレートを結びつけます。
例えば、これは、Experience Platformが接続する必要があるAPI エンドポイントと、Experience Platformが行うAPI呼び出しのヘッダーとフォーマットを指定する場所です。
ファイルベースの宛先の場合、この設定には、宛先でサポートされるファイル形式および圧縮形式も含まれます。宛先サーバーエンドポイントを介して、以下に記載されている機能を設定できます。
- サーバー仕様：データが送信されるストレージの場所や HTTP エンドポイントに関する情報を含む、設定テンプレート。
- テンプレート仕様：このテンプレートでは、エンドポイントに対する HTTP API リクエストの構造化方法（XDM スキーマとプラットフォームがサポートする形式との間のプロファイル属性フィールドの変換方法など）を定義できます。この情報をメッセージ形式ドキュメントと共に使用します。
- メッセージ形式：この節では、サポートされるテンプレート言語、メッセージ形式、プラットフォームとの統合を設定するためにアドビが必要とする情報に関する詳細情報を扱います。この情報をテンプレート仕様ドキュメントと共に使用します。
- ファイル仕様：バッチ宛先用のファイル形式および圧縮オプションを含む、設定テンプレート。
宛先設定 destination-configuration
この設定エンドポイントには、宛先に関する基本および詳細情報が含まれます。例えば、宛先がサポートできるID タイプ、書き出されたファイルの目的の形式（ファイルベースの宛先の場合）、宛先カードの様々なUI属性をAdobe Experience Platform ユーザーインターフェイスで指定する場所です。
各宛先設定コンポーネントについて詳しくは、以下のドキュメントを参照してください。宛先エンドポイントを介して、以下に記載されている機能を設定できます。
- 顧客認証設定：宛先に接続するために Experience Platform が使用する必要がある認証メカニズムを選択します。この設定は、Experience Platform ユーザーインターフェイスの新しい宛先を設定ページを生成します。このページでは、ユーザーが持っている宛先のアカウントに Experience Platform を接続します。
- OAuth2認証: Destination SDKでサポートされているすべてのOAuth2認証フローについて説明し、宛先にOAuth2認証を設定する手順を確認します。
- 顧客データフィールド：Experience Platform UI で入力フィールドを作成する方法を説明します。これにより、ユーザーは、宛先への接続およびデータの書き出し方法に関連する様々な情報を指定できます。
- UI 属性：Destination SDK で作成された宛先に対する UI 属性（ドキュメントリンク、宛先カードカテゴリ、宛先接続タイプおよび頻度など）の設定方法を説明します。
- スキーマ設定：ユーザーがプロファイル属性と ID をマッピングする、宛先のターゲットスキーマの定義方法を説明します。
- ID 名前空間設定：宛先でサポートされる ID の設定方法を説明します。 この設定により、Experience Platform ユーザーインターフェイスのマッピング手順でターゲット ID が設定され、ユーザーが XDM スキーマから宛先のスキーマに ID および属性をマッピングします。
- 宛先配信：書き出されたデータの正確な移動先や、データが到達する場所で使用される認証ルールの設定方法を説明します。
- オーディエンスメタデータ設定：オーディエンスメタデータ（オーディエンス名や ID）を Experience Platform と宛先の間でどのように共有すべきかを説明します。
- 集計ポリシー：集計ポリシーを設定して、宛先に対する HTTP リクエストがどのようにグループ化およびバッチ化されるかを説明します。
- バッチ設定：Experience Platform ユーザーインターフェイスで宛先に接続する際にユーザーが使用できる様々なファイル名および書き出しスケジュールを設定します。
- プロファイル選定履歴：Destination SDK で作成された宛先でサポートされるプロファイル選定履歴について説明します。
オーディエンスメタデータ設定 audience-metadata-configuration
このコンポーネントを使用して、宛先でオーディエンスをプログラムで作成、更新、または削除する方法を設定します。 ファイルベースの宛先の場合は、ファイルが宛先に正常に配信されるたびに通知を設定するために使用します。 オーディエンステンプレートエンドポイントを介して、この機能を設定できます。
次の手順 next-steps
これで、Destination SDKが提供する機能の概要と、特定の設定について詳しく説明するページが表示されました。 次に、Destination SDK を使用してストリーミングやファイルベースの宛先を設定するためのすべての手順が含まれるガイドを参照してください。