この構成を使用すると、宛先名、カテゴリ、説明など、ストリーミング先に関する重要な情報を指定できます。 また、この構成での設定は、Experience Platform ユーザーが宛先に対して認証する方法、Experience Platform ユーザーインターフェイスに表示される方法、宛先に書き出すことができる ID も決定します。
宛先サーバーが動作するために必須である他の構成(宛先サーバーとオーディエンスメタデータ)も、この構成に接続されます。この 2 つの構成を参照する方法については、下記の節をお読みください。
このドキュメントで説明する機能は、/authoring/destinations
API エンドポイントを用いて構成することができます。エンドポイントで実行できる操作の完全なリストには、宛先 API エンドポイントの操作をお読みください。
これは架空のストリーミング先である Moviestar の構成例です。同社には世界の 4 か所にエンドポイントがあります。 宛先は、モバイル宛先カテゴリに属しています。
{
"name":"Moviestar",
"description":"Moviestar is a fictional destination, used for this example.",
"status":"TEST",
"customerAuthenticationConfigurations":[
{
"authType":"BEARER"
}
],
"customerDataFields":[
{
"name":"endpointRegion",
"type":"string",
"title":"Select Endpoint",
"description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
"isRequired":true,
"enum":[
"US",
"EU",
"APAC",
"NZ"
]
},
{
"name":"customerID",
"type":"string",
"title":"Moviestar Customer ID",
"description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
"isRequired":true,
"pattern":"^[A-Za-z]+$"
}
],
"uiAttributes":{
"documentationLink":"http://www.adobe.com/go/destinations-moviestar-en",
"category":"mobile",
"connectionType":"Server-to-server",
"frequency":"Streaming"
},
"identityNamespaces":{
"external_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"Email":{
}
}
},
"another_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true
}
},
"schemaConfig":{
"profileRequired":false,
"segmentRequired":true,
"identityRequired":true
},
"destinationDelivery":[
{
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
}
],
"segmentMappingConfig":{
"mapExperiencePlatformSegmentName":false,
"mapExperiencePlatformSegmentId":false,
"mapUserInput":false,
"audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
},
"aggregation":{
"aggregationType":"CONFIGURABLE_AGGREGATION",
"configurableAggregation":{
"splitUserById":true,
"maxBatchAgeInSecs":2400,
"maxNumEventsInBatch":5000,
"aggregationKey":{
"includeSegmentId":true,
"includeSegmentStatus":true,
"includeIdentity":true,
"oneIdentityPerGroup":false,
"groups":[
{
"namespaces":[
"IDFA",
"GAID"
]
},
{
"namespaces":[
"EMAIL"
]
}
]
}
}
},
"backfillHistoricalProfileData":true
}
パラメーター | タイプ | 説明 |
---|---|---|
name |
文字列 | Experience Platform カタログ内の宛先のタイトルを示します。 |
description |
文字列 | Experience Platform 宛先カタログで、宛先カードの説明を提供します。4 ~ 5 文以下を目指します。 |
status |
文字列 | 宛先カードのライフサイクルステータスを示します。 指定できる値は、TEST 、PUBLISHED 、DELETED です。最初に宛先を設定するときは、TEST を使用します。 |
宛先の構成内のこのセクションは、Experience Platform ユーザーインターフェイスの新しい宛先の構成ページを生成し、顧客が宛先で持っているアカウントに Experience Platform を接続します。authType
フィールドで指定した認証オプションに応じて、次のようにユーザー用の Experience Platform ページが生成されます。
ベアラー認証タイプを設定する場合、ユーザーは接続先から取得したベアラートークンを入力する必要があります。
ユーザーが「宛先に接続」を選択すると、以下の Twitter カスタムオーディエンスの宛先の例のように、宛先への OAuth 2 認証フローがトリガーされます。宛先エンドポイントへの OAuth 2 認証の設定について詳しくは、専用の Destination SDK OAuth 2 認証ページをお読みください。
パラメーター | タイプ | 説明 |
---|---|---|
customerAuthenticationConfigurations |
文字列 | Experience Platform の顧客をサーバーで認証するために使用される構成を示します。 使用可能な値については、下記の authType を参照してください。 |
authType |
文字列 | ストリーミング先として使用可能な値は、以下のとおりです。
|
Experience Platform UI で宛先に接続する際に、このセクションを使用して、宛先に固有のカスタムフィールドに入力するようユーザーに求めます。次に示すように、設定は認証フローに反映されます。
顧客入力にアクセスし、テンプレートで顧客データフィールドから顧客入力を使用できます。 マクロを使用する {{customerData.name}}
. 例えば、ユーザーに対し、 userId
を使用すると、マクロを使用してテンプレートにアクセスできます {{customerData.userId}}
. の API エンドポイントの URL で顧客データフィールドがどのように使用されているかの例を表示します 宛先サーバーの設定.
パラメーター | タイプ | 説明 |
---|---|---|
name |
文字列 | 導入するカスタムフィールドの名前を記入します。 |
type |
文字列 | 導入するカスタムフィールドのタイプを示します。 使用できる値は string 、object 、integer です。 |
title |
文字列 | Experience Platform のユーザーインターフェースで顧客に表示される、フィールドの名前を示します。 |
description |
文字列 | カスタムフィールドの説明を入力します。 |
isRequired |
ブール値 | このフィールドが宛先設定ワークフローで必須かどうかを示します。 |
enum |
文字列 | カスタムフィールドをドロップダウンメニューとしてレンダリングし、ユーザーが使用できるオプションを一覧表示します。 |
pattern |
文字列 | 必要に応じて、カスタムフィールドのパターンを適用します。正規表現を使用して、パターンを適用します。 例えば、顧客 ID に数字やアンダースコアが含まれない場合は、このフィールドに「^[A-Za-z]+$ 」と入力します。 |
この節では、Adobe Experience Platform ユーザーインターフェイスで宛先に対してアドビが使用する、上記の設定の UI 要素について説明します。次を参照してください。
パラメーター | タイプ | 説明 |
---|---|---|
documentationLink |
文字列 | 宛先用の宛先のカタログにあるドキュメントページを参照します。http://www.adobe.com/go/destinations-YOURDESTINATION-en を使用します。ここでは、YOURDESTINATION は宛先の名前です。Moviestar という宛先の場合、http://www.adobe.com/go/destinations-moviestar-en を使用します。。このリンクは、Adobeが宛先をライブに設定し、ドキュメントが公開された後にのみ機能します。 |
category |
文字列 | Adobe Experience Platform で宛先に割り当てられたカテゴリを参照します。 詳しくは、宛先のカテゴリをお読みください。次のいずれかの値を使用します:adobeSolutions, advertising, analytics, cdp, cloudStorage, crm, customerSuccess, database, dmp, ecommerce, email, emailMarketing, enrichment, livechat, marketingAutomation, mobile, personalization, protocols, social, streaming, subscriptions, surveys, tagManagers, voc, warehouses, payments 現在、宛先ごとに 1 つのカテゴリのみを選択できます。 |
connectionType |
文字列 | Server-to-server は現在利用可能な唯一のオプションです。 |
frequency |
文字列 | 宛先でサポートされているデータ書き出しのタイプを指します。 サポートされている値。
|
schemaConfig
のパラメーターを使用して、宛先のアクティベーションのワークフローのマッピングステップを有効にします。以下に説明するパラメーターを使用することで、Experience Platform ユーザーがプロファイル属性や ID を宛先側の目的のスキーマにマッピングできるかどうかを判断できます。
パラメーター | タイプ | 説明 |
---|---|---|
profileFields |
配列 | 上記の構成例では示されていません。 定義済みの profileFields を追加する場合、Experience Platform ユーザーは、Platform 属性を宛先側の事前定義済み属性にマッピングするオプションがあります。 |
profileRequired |
ブール値 | 上記の設定例に示すように、ユーザーが Experience Platform から宛先側のカスタム属性にプロファイル属性をマッピングできる場合、true を使用します。 |
segmentRequired |
ブール値 | 常に segmentRequired:true を使用します。 |
identityRequired |
ブール値 | ユーザーが、Experience Platform から希望のスキーマに ID 名前空間をマッピングできるようにする場合、true を使用します。 |
このセクションのパラメーターは、宛先がどの ID を受け入れるかを決定します。また、この構成は、Experience Platform ユーザーインターフェースのマッピングステップで、ユーザーが XDM スキーマから宛先のスキーマに ID や属性をマッピングする際のターゲット ID や属性にも入力されます。
どの Platform ID の顧客が宛先に書き出すことができるかを示す必要があります。例として、Experience Cloud ID、ハッシュ化されたメール、デバイス ID(IDFA、GAID)などがあります。これらの値は、Platform ID 名前空間であり、宛先から顧客が ID 名前空間にマッピングできます。また、宛先でサポートされている ID に顧客がカスタム名前空間をマッピングできるかどうかを指定することもできます。
ID 名前空間は、Platform と宛先が 1 対 1 で対応している必要はありません。
例えば、顧客は Platform IDFA 名前空間を宛先からの IDFA 名前空間にマッピングすることができ、また顧客は同じ Platform IDFA 名前空間を宛先の Customer ID 名前空間にマッピングすることもできます。
詳しくは、ID 名前空間の概要を参照してください。
パラメーター | タイプ | 説明 |
---|---|---|
acceptsAttributes |
ブール値 | 宛先が標準のプロファイル属性を受け入れるかどうかを示します。 通常、これらの属性はパートナーのドキュメントで強調表示されています。 |
acceptsCustomNamespaces |
ブール値 | 顧客が宛先でカスタム名前空間を設定できるかどうかを示します。 |
transformation |
文字列 | サンプル設定には表示されません。例えば、Platform の顧客が属性としてプレーンなメールアドレスを持っており、プラットフォームがハッシュ化されたメールのみを受け取る場合に使用します。 このオブジェクトでは、適用する必要のある変換(例えば、メールを小文字に変換してからハッシュ化する)を実施できます。 例については、requiredTransformation を参照してください(宛先設定 API リファレンス内)。 |
acceptedGlobalNamespaces |
- | プラットフォームが標準 ID 名前空間(例えば IDFA)を使用して、Platform ユーザーがこれらの ID 名前空間のみを選択するように制限できます。 |
パラメーター | タイプ | 説明 |
---|---|---|
authenticationRule |
文字列 | Platform の顧客が宛先に接続する方法を示します。使用できる値は CUSTOMER_AUTHENTICATION 、PLATFORM_AUTHENTICATION 、NONE 、です。
|
destinationServerId |
文字列 | instanceId :この宛先に使用される宛先サーバー構成。 |
宛先設定の当該セクションは、セグメント名や ID などのセグメントメタデータを Experience Platform と宛先間で共有する方法に関する内容です。
また、audienceTemplateId
を通じて、このセクションはこの構成とオーディエンスメタデータの構成を結びつけています。
上記の構成で示されたパラメーターは、宛先エンドポイント API リファレンスに記載されています。
このセクションでは、Experience Platform がデータを書き出す際に使用する集計ポリシーを設定できます。
集計ポリシーは、書き出されたプロファイルがデータの書き出しでどのように結合されるかを決定します。 利用可能なオプションは次のとおりです。
テンプレートの使用に関する節と集計の主な例を読んで、選択した集約ポリシーに基づいてメッセージ変換テンプレートに集約ポリシーを含める方法を理解します。
API エンドポイントが 1 回の API 呼び出しで受け入れるプロファイルが 100 個未満の場合、このオプションを使用します。
このオプションでは、リクエストあたりのプロファイル数が少ないほうが好まれ、多くのデータで少ない数のリクエストを受けるよりも、少ないデータで多くのリクエストを受けることを希望する宛先に最適です。
maxUsersPerRequest
パラメータを使用して、宛先がリクエストで受け取ることができるプロファイルの最大数を指定します。
このオプションは、同じ呼び出しに何千ものプロファイルを含む、大きなバッチを取りたい場合に最適です。また、このオプションを使用すると、複雑な集計ルールに基づいて、書き出されたプロファイルを集計できます。
このオプションを使用すると、次のことが可能です。
宛先に設定可能な集計オプションを使用する場合は、2 つのパラメーターに使用できる最小値と最大値に注意してください maxBatchAgeInSecs
(1,800 以上 3,600 以下) maxNumEventsInBatch
(最小 1,000、最大 10,000)。
集計パラメータの詳細な説明は、Destinations API エンドポイントの操作のリファレンスページで各パラメータの説明を参照してください。
宛先の設定にある backfillHistoricalProfileData
パラメーターを使用すると、履歴プロファイルの選定を宛先に書き出す必要があるかどうかを決定することができます。
パラメーター | タイプ | 説明 |
---|---|---|
backfillHistoricalProfileData |
ブール値 | 宛先に対してセグメントをアクティブ化する際に、履歴プロファイルデータを書き出すかどうかを制御します。
|
宛先設定の一部は、宛先サーバーまたはオーディエンスメタデータの構成で構成する必要があります。ここで説明する宛先の構成は、以下のように他の 2 つの構成を参照することで、これらの設定をすべて接続するものです。
destinationServerId
を使用して、宛先サーバーと宛先に設定されたテンプレート構成を参照します。audienceMetadataId
を使用して、宛先に設定されたオーディエンスメタデータの構成を参照します。