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

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