Recuperación de metadatos del segmento retrieving-segment-metadata

Cuando Audience Manager envía información de segmentos a un socio de datos, identifica estos objetos con ID numéricos. Como socio de datos, cuando comparte esta información con sus clientes (o trabaja con ellos), un nombre y una descripción reales proporcionan una mejor experiencia a los clientes en informes, paneles u otras interfaces de usuario (UI). Los socios de datos pueden poner estos nombres descriptivos a disposición de sus clientes mediante los métodos manuales o automatizados descritos en esta sección.

Método manual manual-method

Como socio de datos, probablemente esté acostumbrado a obtener metadatos de audiencia de sus clientes mediante procesos manuales. Esto podría incluir archivos adjuntos a correos electrónicos o de clientes que agregan esos datos a través de un(a) UI que ha creado y mantenido para este propósito. Estos procesos funcionan, pero a menudo son engorrosos y llevan mucho tiempo, y pueden requerir el trabajo manual de introducción de datos. Estos métodos se utilizan a menudo para ayudar a poner en marcha una integración rápidamente, pero no proporcionan la mejor experiencia del cliente a largo plazo. Como alternativa, puede usar Audience Manager API para obtener metadatos de segmentos automáticamente.

Método automatizado automated-method

Audience Manager proporciona un conjunto de API de REST que le permiten recuperar metadatos de segmento automáticamente. Con API, puede crear trabajos que recuperen metadatos de segmentos a intervalos programados o automáticamente, siempre que procese datos de Audience Manager y encuentre un nuevo ID de segmento. Consulte los pasos a continuación para obtener más información.

Paso 1: Revisar las API de Audience Manager

La sección Introducción a las API de REST contiene información sobre requisitos generales, autenticación, métodos disponibles, etc. Este es un buen punto de partida si no ha trabajado anteriormente con Audience Manager API.

Paso 2: Solicitar credenciales de acceso a OAuth2

Necesita un ID de cliente y un secreto para realizar API llamadas. Puede obtener un ID de cliente y un secreto de su especialista en integración durante el proceso de configuración de la integración. También puede enviar una solicitud por correo electrónico a Audience Manager Customer Care a las amsupport@adobe.com.

Paso 3: Recopilar información específica del cliente de cada cliente integrado

Solicite lo siguiente a cada cliente integrado:

Paso 4: Recuperar metadatos de segmento con una llamada de API

Después de completar los pasos anteriores, puede usar un método GET para recuperar los metadatos del segmento. Para ver una solicitud y una respuesta de ejemplo, vea Asignaciones de destino de retorno. Esta llamada devuelve datos de segmento formateados como pares clave-valor en un objeto JSON. Algunos de los atributos de segmento importantes devueltos en la respuesta se enumeran en la siguiente tabla.