Quando o Audience Manager envia informações de segmento para um parceiro de dados, ele identifica esses objetos com IDs numéricas. Como parceiro de dados, ao compartilhar essas informações com seus clientes (ou trabalhar com eles próprios), um nome e uma descrição reais fornecem uma melhor experiência para clientes em relatórios, painéis ou outras interfaces de usuário (UI). Os parceiros de dados podem disponibilizar esses nomes amigáveis para seus clientes com os métodos manual ou automatizado descritos nesta seção.
Como parceiro de dados, você provavelmente está acostumado a obter metadados de público-alvo de seus clientes por meio de processos manuais. Isso pode incluir arquivos anexados a emails ou de clientes que adicionam esses dados por meio de um UI que você criou e manteve para essa finalidade. Esses processos funcionam, mas geralmente são complicados, demorados e podem exigir o trabalho manual de entrada de dados. Geralmente, esses métodos são usados para ajudar a ativar e executar uma integração rapidamente, mas não fornecem a melhor experiência do cliente a longo prazo. Como alternativa, você pode usar Audience Manager API para obter metadados de segmento automaticamente.
Audience Manager O fornece um conjunto de REST APIs que permitem recuperar metadados de segmento automaticamente. Com o API, você pode criar tarefas que recuperam metadados de segmentos em intervalos agendados ou automaticamente, sempre que processar Audience Manager dados e encontrar uma nova ID de segmento. Consulte as etapas abaixo para obter mais informações.
A seção Introdução às APIs REST contém informações sobre requisitos gerais, autenticação, métodos disponíveis etc. Este é um bom lugar para começar se você não tiver trabalhado com o Audience Manager API antes.
Você precisa de uma ID de cliente e um segredo para fazer chamadas API. Você pode obter uma ID de cliente e uma senha do seu especialista de integração durante o processo de configuração da integração. Você também pode enviar uma solicitação de email para Audience Manager Customer Care em amsupport@adobe.com.
Solicite o seguinte de cada cliente integrado:
Após concluir as etapas anteriores, você pode usar um método GET
para recuperar metadados de segmento. Para obter um exemplo de solicitação e resposta, consulte Retornar mapeamentos de destino. Essa chamada retorna dados de segmento formatados como pares de valor chave em um objeto JSON . Alguns dos atributos de segmento importantes retornados na resposta são listados na tabela a seguir.
Parâmetro | Descrição |
---|---|
|
A ID do segmento Audience Manager. |
|
O nome do segmento. |
|
Algum texto que descreve brevemente o segmento. |
|
O status atual do mapeamento de segmento. As opções de status retornadas incluem:
|