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, quando você compartilha essas informações com seus clientes (ou trabalha com eles), um nome e uma descrição reais fornecem uma experiência melhor para os clientes em relatórios, painéis ou outras interfaces de usuário (UI). Os parceiros de dados podem disponibilizar esses nomes amigáveis aos seus clientes com os métodos manuais ou automatizados 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 uma UI que você criou e manteve para essa finalidade. Esses processos funcionam, mas geralmente são complicados, demorados e podem exigir trabalho manual de entrada de dados. Esses métodos geralmente são usados para ajudar a colocar uma integração em funcionamento rapidamente, mas não fornecem a melhor experiência do cliente a longo prazo. Como alternativa, você pode usar a variável Audience Manager API para obter metadados de segmento automaticamente.

Método automatizado

Audience Manager fornece um conjunto de REST APIs que permitem recuperar metadados de segmento automaticamente. Com o API, você pode criar processos que recuperam metadados de segmento em intervalos programados ou automaticamente, sempre que processar Audience Manager e encontrar uma nova ID de segmento. Consulte as etapas abaixo para obter mais informações.

Etapa 1: Revise as APIs de Audience Manager

A variável Introdução às REST APIs A seção 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 trabalhou 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 API chamadas. Você pode obter uma ID de cliente e um segredo do especialista em integração durante o processo de configuração da integração. Você também pode enviar uma solicitação por email para Audience Manager Customer Care em amsupport@adobe.com.

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

Solicite o seguinte de cada cliente integrado:

Nome do usuário: destinado a 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: é a ID (um número inteiro) associada ao destino criado para a integração específica de servidor para servidor.

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

Após concluir as etapas anteriores, você pode usar um GET para recuperar metadados de segmento. Para obter uma solicitação e uma resposta de exemplo, consulte Mapeamentos de destino de retorno. Essa chamada retorna dados de segmento formatados como pares de valores chave em uma JSON objeto. Alguns dos atributos de segmento importantes retornados na resposta do estão listados na tabela a seguir.

Parâmetro	Descrição
`destinationMappingId`	A variável Audience Manager ID do segmento.
`elementName`	O nome do segmento.
`elementDescription`	Um texto que descreve brevemente o segmento.
`elementStatus`	O status atual do mapeamento de segmento. As opções de status retornadas incluem: `active` `inactive` `deleted`