Show Menu
TÓPICOS×

Recuperando 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 melhor experiência 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 para 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 e-mails ou de clientes que adicionam esses dados por meio de um arquivo 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. Esses métodos são usados com frequência 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 o Audience Manager API para obter os metadados do segmento automaticamente.

Método automatizado

Audience Manager fornece um conjunto de APIs REST APIs REST que permite recuperar metadados de segmento automaticamente. Com o API, é possível criar trabalhos que recuperam metadados de segmentos em intervalos programados ou automaticamente, sempre que você processa Audience Manager dados e encontra 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 trabalhou com o Audience Manager API antes.

Etapa 2: Solicitar credenciais de acesso 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 de seu 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 o amsupport@adobe.com.

Etapa 3: Coletar 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 servidor a servidor específica.

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

Após concluir as etapas anteriores, você pode usar um GET método para recuperar os metadados do segmento. Para obter uma amostra de solicitação e resposta, consulte Mapeamentos de destino de retorno. Essa chamada retorna dados de segmento formatados como pares de valores chave em um JSON objeto. Alguns dos atributos de segmento importantes retornados na resposta estão listados na tabela a seguir.
Parâmetro Descrição
targetMappingId
A ID de segmento do Audience Manager .
elementName
O nome do segmento.
elementDescription
Algum texto que descreve brevemente o segmento.
elementStatus
O status atual do mapeamento de segmentos. As opções de status retornadas incluem:
  • ative
  • inativo
  • excluído