ドキュメントExperience Platform宛先ガイド

宛先配信

最終更新日： 2026年9月10日

作成対象：

  • ユーザー
  • 管理

宛先に書き出されたデータの保存場所をより詳細に制御するには、Destination SDKを使用して宛先配信設定を指定します。

宛先配信セクションは、書き出されたデータの移動先や、データが到達する場所で使用される認証ルールを示します。

このコンポーネントがDestination SDKで作成された統合にどこで適合するかを理解するには、設定オプション ​ ドキュメントの図を参照するか、次の宛先設定の概要ページを参照してください。

/authoring/destinations エンドポイントを介して宛先配信設定を設定できます。 このページに表示されるコンポーネントを設定できる、詳細な API 呼び出しの例については、以下の API リファレンスページを参照してください。

この記事では、宛先に使用できる、サポートされるすべての宛先配信オプションについて説明します。

IMPORTANT
Destination SDKでサポートされているすべてのパラメーター名と値は​大文字と小文字が区別されます。 大文字と小文字の区別エラーを回避するには、ドキュメントに示すように、パラメーター名と値を正確に使用します。

サポートされる統合タイプ supported-integration-types

このページで説明する機能をサポートする統合のタイプについて詳しくは、次の表を参照してください。

統合タイプ
機能のサポート
リアルタイム（ストリーミング）統合
○
ファイルベースの（バッチ）統合
○

サポートされるパラメーター supported-parameters

宛先配信設定を設定する際に、以下の表で説明されているパラメーターを使用して、書き出されたデータが送信される場所を定義できます。

パラメーター
タイプ
説明
authenticationRule
文字列

Experience Platform が宛先に接続する方法を示します。 サポートされている値：

  • CUSTOMER_AUTHENTICATION: Experience Platform人の顧客が顧客認証 ドキュメントに記載されている認証方法のいずれかを使用してシステムにログインする場合は、このオプションを使用します。
  • PLATFORM_AUTHENTICATION：アドビと宛先との間にグローバル認証システムがあり、Experience Platform の顧客が宛先への接続に認証資格情報を提供する必要がない場合は、このオプションを使用します。 この場合、credentials API設定を使用して資格情報オブジェクトを作成し、authenticationId パラメーターを資格情報オブジェクト ID値に設定する必要があります。
  • NONE：宛先プラットフォームにデータを送信するために認証が必要ない場合は、このオプションを使用します。
authenticationId
文字列
認証に使用する資格情報オブジェクトの構成IDのinstanceId。 このパラメーターは、特定の資格情報設定を指定する必要がある場合にのみ必要です。
destinationServerId
文字列
データの書き出し先にする宛先サーバーの instanceId。
deliveryMatchers.type
文字列
  • ファイルベースの宛先用に宛先配信を設定する場合は、常に、これを SOURCE に設定します。
  • ストリーミング宛先用に宛先配信を設定する場合は、deliveryMatchers セクションは必須ではありません。
deliveryMatchers.value
文字列
  • ファイルベースの宛先用に宛先配信を設定する場合は、常に、これを batch に設定します。
  • ストリーミング宛先用に宛先配信を設定する場合は、deliveryMatchers セクションは必須ではありません。

ストリーミング宛先用の宛先配信設定 destination-delivery-streaming

以下の例に、宛先配信設定がどのようにストリーミング宛先用に設定される必要があるかを示します。 deliveryMatchers セクションは、ストリーミング宛先に必須ではないことに注意してください。

{
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}
style
shade-box

ファイルベースの宛先用の宛先配信設定 destination-delivery-file-based

以下の例に、宛先配信設定がどのようにファイルベースの宛先用に設定される必要があるかを示します。 deliveryMatchers セクションは、ファイルベースの宛先に必須であることに注意してください。

{
   "destinationDelivery":[
      {
         "deliveryMatchers":[
            {
               "type":"SOURCE",
               "value":[
                  "batch"
               ]
            }
         ],
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}
style
shade-box

プラットフォーム認証設定 platform-authentication

PLATFORM_AUTHENTICATIONを使用する場合は、宛先設定を資格情報設定にリンクするためにauthenticationId パラメーターを指定する必要があります。

  1. 宛先設定でdestinationDelivery.authenticationRuleを"PLATFORM_AUTHENTICATION"に設定します。
  2. 資格情報オブジェクトを作成。
  3. authenticationId パラメーターを資格情報オブジェクトのinstanceId値に設定します。

プラットフォーム認証による設定例

次の例は、PLATFORM_AUTHENTICATIONを使用する宛先配信設定を示しています。

{
   "destinationDelivery":[
      {
         "authenticationRule":"PLATFORM_AUTHENTICATION",
         "authenticationId":"<string-here>",
         "destinationServerId":"<string-here>"
      }
   ]
}
style
shade-box

次の手順 next-steps

次に、その他の宛先コンポーネントを設定します。 詳しくは、次の記事を参照してください。

recommendation-more-help
experience-platform-help-destinations