Create an audience template
platform.adobe.io/data/core/activation/authoring/audience-templates
For some destinations created using Destination SDK, you need to create an audience metadata configuration to programmatically create, update, or delete audience metadata in the destination. This page shows you how to use the /authoring/audience-templates
API endpoint to create the configuration.
For a detailed description of the capabilities that you can configure through this endpoint, see audience metadata management.
Getting started with audience template API operations get-started
Before continuing, please review the getting started guide for important information that you need to know in order to successfully make calls to the API, including how to obtain the required destination authoring permission and required headers.
Create an audience template create
You can create a new audience template by making a POST
request to the /authoring/audience-templates
endpoint.
API format
POST /authoring/audience-templates
The following request creates a new audience template, configured by the parameters provided in the payload. The payload below includes all parameters accepted by the /authoring/audience-templates
endpoint. Note that you do not have to add all parameters on the call and that the template is customizable, according to your API requirements.
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 | ||
---|---|---|
Property | Type | Description |
name |
String | The name of the audience metadata template for your destination. This name will appear in any partner-specific error message in the Experience Platform user interface, followed by the error message parsed from metadataTemplate.create.errorSchemaMap . |
url |
String | The URL and endpoint of your API, which is used for creating, updating, deleting, or validating audiences in your platform. Two industry examples are: https://adsapi.snapchat.com/v1/adaccounts/{{customerData.accountId}}/segments and https://api.linkedin.com/v2/dmpSegments/{{segment.alias}} . |
httpMethod |
String | The method used on your endpoint to programmatically create, update, delete, or validate the audience in your destination. For example: POST , PUT , DELETE |
headers.header |
String | Specifies any HTTP headers that should be added to the call to your API. For example, "Content-Type" |
headers.value |
String | Specifies the value of HTTP headers that should be added to the call to your API. For example, "application/x-www-form-urlencoded" |
requestBody |
String | Specifies the content of the message body that should be sent to your API. The parameters that should be added to the requestBody object depend on which fields your API accepts. For an example, refer to the first template example in the Audience metadata functionality document. |
responseFields.name |
String | Specify any response fields that your API returns when called. For an example, refer to the template examples in the Audience metadata functionality document. |
responseFields.value |
String | Specify the value of any response fields that your API returns when called. |
responseErrorFields.name |
String | Specify any response fields that your API returns when called. For an example, refer to the template examples in the Audience metadata functionality document. |
responseErrorFields.value |
String | Parses any error messages returned on API call responses from your destination. These error messages will be surfaced to users in the Experience Platform user interface. |
validations.field |
String | Indicates if validations should be run for any fields before API calls are made to your destination. For example, you can use {{validations.accountId}} to validate the user’s account ID. |
validations.regex |
String | Indicates how the field should be structured in order for the validation to pass. |
API error handling
Destination SDK API endpoints follow the general Experience Platform API error message principles. Refer to API status codes and request header errors in the Platform troubleshooting guide.
Next steps
After reading this document, you now know when to use audience templates and how to configure an audience template using the /authoring/audience-templates
API endpoint. Read how to use Destination SDK to configure your destination to understand where this step fits into the process of configuring your destination.