Configuração de metadados de público

Ao exportar dados do Experience Platform para o seu destino, talvez seja necessário que metadados de público-alvo específicos, como nomes de público-alvo ou IDs de público-alvo, sejam compartilhados entre o Experience Platform e o seu destino.

O Destination SDK oferece ferramentas que você pode usar para criar, atualizar ou excluir públicos-alvo de forma programática na plataforma de destino.

Para entender onde esse componente se encaixa em uma integração criada com o Destination SDK, consulte o diagrama na documentação de opções de configuração ou consulte o guia sobre como usar o Destination SDK para configurar um destino de streaming.

Você pode configurar o modelo de metadados de público por meio do ponto de extremidade /authoring/audience-templates. Depois de criar a configuração de metadados de público, você pode usar o terminal /authoring/destinations para configurar a seção audienceMetadataConfig. Esta seção informa ao destino quais metadados de público-alvo ele deve mapear para o modelo de público-alvo.

Consulte as seguintes páginas de referência de API para obter exemplos detalhados de chamadas de API, onde é possível configurar os componentes mostrados nesta página.

IMPORTANT
Todos os nomes e valores de parâmetros suportados pelo Destination SDK fazem distinção entre maiúsculas e 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.

Tipos de integração compatíveis supported-integration-types

Consulte a tabela abaixo para obter detalhes sobre quais tipos de integrações suportam a funcionalidade descrita nesta página.

Tipo de integração
Suporte à funcionalidade
Integrações em tempo real (streaming)
Sim
Integrações baseadas em arquivo (lote)
Sim

Parâmetros compatíveis supported-parameters

Ao criar a configuração de metadados de público-alvo, você pode usar os parâmetros descritos na tabela abaixo para definir as configurações de mapeamento de público-alvo.

  "audienceMetadataConfig":{
   "mapExperiencePlatformSegmentName":false,
   "mapExperiencePlatformSegmentId":false,
   "mapUserInput":false,
   "audienceTemplateId":"YOUR_AUDIENCE_TEMPLATE_ID"
}
Parâmetro
Tipo
Descrição
mapExperiencePlatformSegmentName
Booleano
Indica se o valor ID de Mapeamento no fluxo de trabalho de ativação de destino deve ser o nome de público-alvo Experience Platform.
mapExperiencePlatformSegmentId
Booleano
Indica se o valor ID de Mapeamento no fluxo de trabalho de ativação de destino deve ser a ID de público-alvo Experience Platform.
mapUserInput
Booleano
Habilita ou desabilita a entrada do usuário para o valor ID de Mapeamento no fluxo de trabalho de ativação de destino. Se definido como true, audienceTemplateId não pode estar presente.
audienceTemplateId
String
O instanceId do modelo de metadados de público-alvo usado para o seu destino.

Próximas etapas next-steps

Depois de ler este artigo, você deve entender melhor como configurar os metadados de público-alvo para o seu destino.

Para saber mais sobre os outros componentes de destino, consulte os seguintes artigos:

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