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

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

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

Destination SDKを使用して作成された統合で、このコンポーネントがどこに適合するかを把握するには、 設定オプション ドキュメントを参照するか、 Destination SDKを使用したストリーミング先の設定.

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

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

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

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

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

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

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

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

  "audienceMetadataConfig":{
   "mapExperiencePlatformSegmentName":false,
   "mapExperiencePlatformSegmentId":false,
   "mapUserInput":false,
   "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
7f4d1967-bf93-4dba-9789-bb6b505339d6