DocumentaçãoExperience PlatformGuia de destinos

Criar um modelo de público-alvo

Last update: Tue Oct 31 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Admin
  • User
IMPORTANT
Ponto de acesso da API: platform.adobe.io/data/core/activation/authoring/audience-templates

Para alguns destinos criados usando o Destination SDK, é necessário criar uma configuração de metadados de público-alvo para criar, atualizar ou excluir programaticamente metadados de público-alvo no destino. Esta página mostra como usar a variável /authoring/audience-templates Endpoint da API para criar a configuração.

Para obter uma descrição detalhada dos recursos que você pode configurar por meio desse endpoint, consulte gerenciamento de metadados de público.

IMPORTANT
Todos os nomes e valores de parâmetros compatíveis com o Destination SDK são diferencia maiúsculas de minúsculas. Para evitar erros de diferenciação entre maiúsculas e minúsculas, use os nomes e valores dos parâmetros exatamente como mostrado na documentação.

Introdução às operações de API do modelo de público-alvo get-started

Antes de continuar, reveja o guia de introdução para obter informações importantes que você precisa saber para fazer chamadas com êxito para a API, incluindo como obter a permissão de criação de destino e os cabeçalhos necessários.

Criar um modelo de público-alvo create

Você pode criar um novo modelo de público-alvo fazendo um POST solicitação à /authoring/audience-templates terminal.

Formato da API

POST /authoring/audience-templates
Solicitação

A solicitação a seguir cria um novo modelo de público-alvo, configurado pelos parâmetros fornecidos na carga. A carga abaixo inclui todos os parâmetros aceitos pelo /authoring/audience-templates terminal. Observe que não é necessário adicionar todos os parâmetros na chamada e que o modelo é personalizável, de acordo com os requisitos da API.

code language-shell 
curl -X POST https://platform.adobe.io/data/core/activation/authoring/audience-templates \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
   "metadataTemplate":{
      "name":"string",
      "create":{
         "url":"string",
         "httpMethod":"string",
         "headers":[
            {
               "header":"string",
               "value":"string"
            }
         ],
         "requestBody":{

         },
         "responseFields":[
            {
               "name":"string",
               "value":"string"
            }
         ],
         "responseErrorFields":[
            {
               "name":"string",
               "value":"string"
            }
         ]
      },
      "update":{
         "url":"string",
         "httpMethod":"string",
         "headers":[
            {
               "header":"string",
               "value":"string"
            }
         ],
         "requestBody":{

         },
         "responseFields":[
            {
               "name":"string",
               "value":"string"
            }
         ],
         "responseErrorFields":[
            {
               "name":"string",
               "value":"string"
            }
         ]
      },
      "delete":{
         "url":"string",
         "httpMethod":"string",
         "headers":[
            {
               "header":"string",
               "value":"string"
            }
         ],
         "requestBody":{

         },
         "responseFields":[
            {
               "name":"string",
               "value":"string"
            }
         ],
         "responseErrorFields":[
            {
               "name":"string",
               "value":"string"
            }
         ]
      },
      "validate":{
         "url":"string",
         "httpMethod":"string",
         "headers":[
            {
               "header":"string",
               "value":"string"
            }
         ],
         "requestBody":{

         },
         "responseFields":[
            {
               "name":"string",
               "value":"string"
            }
         ],
         "responseErrorFields":[
            {
               "name":"string",
               "value":"string"
            }
         ]
      },
      "notify":{
         "url":"string",
         "httpMethod":"string",
         "headers":[
            {
               "header":"string",
               "value":"string"
            }
         ],
         "requestBody":{

         },
         "responseFields":[
            {
               "name":"string",
               "value":"string"
            }
         ],
         "responseErrorFields":[
            {
               "name":"string",
               "value":"string"
            }
         ]
      }
   },
   "validations":[
      {
         "field":"string",
         "regex":"string"
      }
   ]
}'
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
Propriedade Tipo Descrição
name String O nome do modelo de metadados de público-alvo para o seu destino. Esse nome aparecerá em qualquer mensagem de erro específica do parceiro na interface do usuário do Experience Platform, seguida pela mensagem de erro analisada em metadataTemplate.create.errorSchemaMap.
url String O URL e o endpoint da API, usados para criar, atualizar, excluir ou validar públicos-alvo na sua plataforma. Dois exemplos de setor são: https://adsapi.snapchat.com/v1/adaccounts/{{customerData.accountId}}/segments e https://api.linkedin.com/v2/dmpSegments/{{segment.alias}}.
httpMethod String O método usado no endpoint para criar, atualizar, excluir ou validar de forma programática o público-alvo no destino. Por exemplo: POST, PUT, DELETE
headers.header String Especifica os cabeçalhos HTTP que devem ser adicionados à chamada para a API. Por exemplo, "Content-Type"
headers.value String Especifica o valor de cabeçalhos HTTP que devem ser adicionados à chamada para a API. Por exemplo, "application/x-www-form-urlencoded"
requestBody String Especifica o conteúdo do corpo da mensagem que deve ser enviado para a API. Os parâmetros que devem ser adicionados ao requestBody objetos dependem de quais campos sua API aceita. Para obter um exemplo, consulte as primeiro exemplo de modelo no documento Funcionalidade de metadados de público-alvo.
responseFields.name String Especifique quaisquer campos de resposta que sua API retorne quando chamada. Para obter um exemplo, consulte as exemplos de modelo no documento Funcionalidade de metadados de público-alvo.
responseFields.value String Especifique o valor de quaisquer campos de resposta que sua API retorna quando chamada.
responseErrorFields.name String Especifique quaisquer campos de resposta que sua API retorne quando chamada. Para obter um exemplo, consulte as exemplos de modelo no documento Funcionalidade de metadados de público-alvo.
responseErrorFields.value String Analisa todas as mensagens de erro retornadas nas respostas de chamada da API do seu destino. Essas mensagens de erro serão exibidas para os usuários na interface do usuário do Experience Platform.
validations.field String Indica se as validações devem ser executadas para qualquer campo antes que as chamadas de API sejam feitas ao destino. Por exemplo, você pode usar {{validations.accountId}} para validar a ID da conta do usuário.
validations.regex String Indica como o campo deve ser estruturado para que a validação seja aprovada.
Resposta
Uma resposta bem-sucedida retorna o status HTTP 200 com detalhes do modelo de público-alvo recém-criado.

Manipulação de erros de API

Os endpoints da API Destination SDK seguem os princípios gerais de mensagem de erro da API Experience Platform. Consulte Códigos de status da API e erros no cabeçalho da solicitação no guia de solução de problemas da Platform.

Próximas etapas

Depois de ler este documento, agora você sabe quando usar modelos de público-alvo e como configurar um modelo de público-alvo usando o /authoring/audience-templates Endpoint da API. Ler como usar o Destination SDK para configurar seu destino para entender onde essa etapa se encaixa no processo de configuração do destino.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6