オーディエンステンプレートの作成
platform.adobe.io/data/core/activation/authoring/audience-templates
Destination SDK を使用して作成した一部の宛先では、オーディエンスメタデータ設定を作成して、宛先のオーディエンスメタデータをプログラムで作成、更新または削除する必要があります。このページでは、/authoring/audience-templates
API エンドポイントを使用した設定の作成方法を示します。
このエンドポイントを通じて設定できる機能について詳しくは、オーディエンスメタデータ管理を参照してください。
オーディエンステンプレート API 操作の概要 get-started
続行する前に、「はじめる前に」を参照し、API の呼び出しを正常に行うために必要となる重要な情報(必要な宛先オーサリング権限および必要なヘッダーの取得方法など)を確認してください。
オーディエンステンプレートの作成 create
/authoring/audience-templates
エンドポイントに POST
リクエストを行うことで、新しいオーディエンステンプレートを作成できます。
API 形式
POST /authoring/audience-templates
以下のリクエストは、ペイロードで提供されるパラメーター設定に基づいて、新しいオーディエンステンプレートを作成します。以下のペイロードには、/authoring/audience-templates
エンドポイントで使用可能なすべてのパラメーターが含まれます。呼び出しにすべてのパラメーターを追加する必要はなく、テンプレートは API 要件に応じてカスタマイズできることに注意してください。
code language-shell |
---|
|
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 layout-auto | ||
---|---|---|
プロパティ | タイプ | 説明 |
name |
文字列 | 宛先のオーディエンスメタデータテンプレートの名前。この名前は、Experience Platformユーザーインターフェイスのパートナー固有のエラーメッセージに表示されます。 |
url |
文字列 | API の URL とエンドポイント。プラットフォームでオーディエンスやデータフローを作成、更新、削除、検証するために使用します。 https://adsapi.snapchat.com/v1/adaccounts/{{customerData.accountId}}/segments および https://api.linkedin.com/v2/dmpSegments/{{segment.alias}} は 2 つの業界の例です。 |
httpMethod |
文字列 | 宛先のオーディエンスをプログラムで作成、更新、削除、検証するためにエンドポイントで使用されるメソッド。例:POST 、PUT 、DELETE |
headers.header |
文字列 | API への呼び出しに追加する HTTP ヘッダーを指定します。例:"Content-Type" |
headers.value |
文字列 | API への呼び出しに追加する HTTP ヘッダーの値を指定します。例:"application/x-www-form-urlencoded" |
requestBody |
文字列 | API に送信するメッセージ本文のコンテンツを指定します。requestBody オブジェクトに追加する必要があるパラメーターは、API が受け入れるフィールドに応じて異なります。メッセージ本文に含めることができるものを学ぶには、 サポートされるマクロのドキュメントを参照してください。 |
responseFields.name |
文字列 | 呼び出し時に API が返す応答フィールドを指定します。例については、オーディエンスメタデータ機能ドキュメントのテンプレートの例を参照してください。 |
responseFields.value |
文字列 | 呼び出し時に API が返す応答フィールドの値を指定します。 |
responseErrorFields.name |
文字列 | 呼び出し時に API が返す応答フィールドを指定します。例については、オーディエンスメタデータ機能ドキュメントのテンプレートの例を参照してください。 |
responseErrorFields.value |
文字列 | API 呼び出しに対する宛先からの応答で返されたエラーメッセージを解析します。これらのエラーメッセージは、Adobe Experience Platform のユーザーインターフェイスでユーザーに表示されます。 |
validations.field |
文字列 | 宛先に対する API 呼び出しが実行される前に、いずれかのフィールドに対して検証を実行する必要があるかどうかを示します。例えば、ユーザーのアカウント ID の検証に {{validations.accountId}} を使用できます。 |
validations.regex |
文字列 | 検証に合格するために、フィールドをどのように構成するべきかを示します。 |
API エラー処理
Destination SDK API エンドポイントは、一般的な Experience Platform API エラーメッセージの原則に従います。Platform トラブルシューティングガイドの API ステータスコードおよびリクエストヘッダーエラーを参照してください。
次の手順
このドキュメントでは、オーディエンステンプレートを使用するタイミングと、/authoring/audience-templates
API エンドポイントを使用してオーディエンステンプレートを設定する方法について確認しました。この手順が宛先設定プロセスのどこに当てはまるかを把握するには、Destination SDK を使用した宛先の設定方法を参照してください。