Recuperação de metadados do segmento

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.

Método manual

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.

Método automatizado

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.

Etapa 1: Revise as APIs do Audience Manager

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.

Etapa 2: Solicitar credenciais de acesso do OAuth2

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.

Etapa 3: Colete informações específicas do cliente de cada cliente integrado

Solicite o seguinte de cada cliente integrado:

Nome de usuário: Isso é para um usuário restrito que tem permissões somente leitura para o destino associado a uma integração específica.
Senha: A senha do usuário.
ID de destino: Essa é a ID (um número inteiro) associada ao destino criado para a integração de servidor para servidor específica.

Etapa 4: Recuperar metadados de segmento com uma chamada de API

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
`destinationMappingId`	A ID do segmento Audience Manager.
`elementName`	O nome do segmento.
`elementDescription`	Algum texto que descreve brevemente o segmento.
`elementStatus`	O status atual do mapeamento de segmento. As opções de status retornadas incluem: `active` `inactive` `deleted`