オーディエンスメタデータ設定

Experience Platformから宛先にデータを書き出す場合、オーディエンス名やオーディエンス IDなどの特定のオーディエンスメタデータをExperience Platformと宛先の間で共有する必要がある場合があります。

Destination SDKには、宛先プラットフォームでオーディエンスをプログラムで作成、更新、または削除するために使用できるツールが用意されています。

このコンポーネントがDestination SDKで作成された統合にどこで適合するかを理解するには、configuration options ドキュメントの図を参照するか、Destination SDKを使用してストリーミング宛先を設定する方法に関するガイドを参照してください。

/authoring/audience-templates エンドポイントを介してオーディエンスメタデータテンプレートを設定できます。 オーディエンスメタデータ設定を作成した後、/authoring/destinations エンドポイントを使用して、segmentMappingConfigおよびaudienceMetadataConfig セクションを設定できます。 このセクションは、オーディエンステンプレートにマッピングする必要があるオーディエンスメタデータを宛先に指示します。

このページに表示されるコンポーネントを設定できる、詳細な API 呼び出しの例については、以下の API リファレンスページを参照してください。

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

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

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

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

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

オーディエンスメタデータ設定を作成する際に、 以下の表で説明されているパラメーターを使用して、オーディエンスマッピング設定を設定できます。

"segmentMappingConfig": {
   "mapExperiencePlatformSegmentName":false,
   "mapExperiencePlatformSegmentId":false,
   "mapUserInput":false,
 },
"audienceMetadataConfig":{
   "audienceTemplateId":"YOUR_AUDIENCE_TEMPLATE_ID"
}
パラメーター
タイプ
説明
mapExperiencePlatformSegmentName
ブール
宛先アクティベーションワークフローの​ マッピング ID値がExperience Platform オーディエンス名である必要があるかどうかを示します。
mapExperiencePlatformSegmentId
ブール
宛先アクティベーションワークフローの​ マッピング ID値がExperience Platform オーディエンス IDであるかどうかを示します。
mapUserInput
ブール
ユーザーが宛先アクティベーションワークフローで​ マッピング ID値の入力を提供できるかどうかを制御します。 true に設定すると、audienceTemplateId は存在できません。
audienceTemplateId
文字列
宛先に使用されるオーディエンスメタデータテンプレートinstanceId

次の手順 next-steps

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

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