宛先配信
宛先に書き出されたデータが到達する場所をより正確に制御するために、Destination SDK では、宛先配信設定を指定できます。
宛先配信セクションは、書き出されたデータの移動先や、データが到達する場所で使用される認証ルールを示します。
このコンポーネントが Destination SDK で作成される統合のどこに適合するかを把握するには、設定オプションドキュメントの図を参照するか、以下の宛先設定の概要ページを参照してください。
/authoring/destinations
エンドポイントを介して宛先配信設定を設定できます。このページに表示されるコンポーネントを設定できる、詳細な API 呼び出しの例については、以下の API リファレンスページを参照してください。
この記事では、宛先に使用できる、サポートされるすべての宛先配信オプションについて説明します。
サポートされる統合タイプ supported-integration-types
このページで説明される機能をサポートする統合のタイプについて詳しくは、以下の表を参照してください。
サポートされるパラメーター supported-parameters
宛先配信設定を設定する際に、以下の表で説明されているパラメーターを使用して、書き出されたデータが送信される場所を定義できます。
authenticationRule
Platform が宛先に接続する方法を示します。サポートされている値:
CUSTOMER_AUTHENTICATION
:Platform の顧客がこちらで説明しているいずれかの認証方法でお使いのシステムにログインする場合は、このオプションを使用します。PLATFORM_AUTHENTICATION
:アドビと宛先との間にグローバル認証システムがあり、Platform の顧客が宛先への接続に認証資格情報を提供する必要がない場合は、このオプションを使用します。この場合、資格情報 API 設定を使用して、資格情報オブジェクトを作成する必要があります。NONE
:宛先プラットフォームにデータを送信するために認証が必要ない場合は、このオプションを使用します。
deliveryMatchers.type
- ファイルベースの宛先用に宛先配信を設定する場合は、常に、これを
SOURCE
に設定します。 - ストリーミング宛先用に宛先配信を設定する場合は、
deliveryMatchers
セクションは必須ではありません。
deliveryMatchers.value
- ファイルベースの宛先用に宛先配信を設定する場合は、常に、これを
batch
に設定します。 - ストリーミング宛先用に宛先配信を設定する場合は、
deliveryMatchers
セクションは必須ではありません。
ストリーミング宛先用の宛先配信設定 destination-delivery-streaming
以下の例に、宛先配信設定がどのようにストリーミング宛先用に設定される必要があるかを示します。deliveryMatchers
セクションは、ストリーミング宛先に必須ではないことに注意してください。
{
"destinationDelivery":[
{
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"{{destinationServerId}}"
}
]
}
ファイルベースの宛先用の宛先配信設定 destination-delivery-file-based
以下の例に、宛先配信設定がどのようにファイルベースの宛先用に設定される必要があるかを示します。deliveryMatchers
セクションは、ファイルベースの宛先に必須であることに注意してください。
{
"destinationDelivery":[
{
"deliveryMatchers":[
{
"type":"SOURCE",
"value":[
"batch"
]
}
],
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"{{destinationServerId}}"
}
]
}
次の手順 next-steps
この記事を読むことで、ストリーミングとファイルベースの両方の宛先に対して、宛先がデータを書き出す場所を設定する方法について、理解を深めることができました。
その他の宛先コンポーネントについて詳しくは、以下の記事を参照してください。