Recuperação de metadados do segmento retrieving-segment-metadata

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 manual-method

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 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 o Audience Manager API para obter metadados de segmento automaticamente.

Método automatizado automated-method

Audience Manager fornece um conjunto de APIs REST que permitem recuperar metadados de segmento automaticamente. Com o API, você pode criar trabalhos que recuperam metadados de segmento em intervalos agendados ou automaticamente, sempre que processar dados do 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 seção Introdução às REST APIs contém informações sobre requisitos gerais, autenticação, métodos disponíveis, etc. Este é um bom local para começar se você ainda não trabalhou com o Audience Manager API.

Etapa 2: solicitar credenciais de acesso do OAuth2

Você precisa de uma ID de cliente e um segredo para fazer chamadas de API. 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 de 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:

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 uma solicitação e resposta de exemplo, consulte Mapeamentos de Destino de Retorno. Esta chamada retorna dados de segmento formatados como pares de valores chave em um objeto JSON. Alguns dos atributos de segmento importantes retornados na resposta do estão listados na tabela a seguir.