Cuando el 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 él mismo), un nombre y una descripción reales proporcionan una mejor experiencia a los clientes en informes, tableros u otras interfaces de usuario (UI). Los socios de datos pueden poner estos nombres descriptivos a disposición de sus clientes con los métodos manuales o automatizados que se describen en esta sección.
Como socio de datos, probablemente esté acostumbrado a obtener metadatos de audiencia de sus clientes a través de procesos manuales. Esto podría incluir archivos adjuntos a correos electrónicos o de clientes que agregan esos datos a través de un UI que haya creado y mantenido con este fin. Estos procesos funcionan, pero a menudo son engorrosos, consumen tiempo y pueden requerir un trabajo manual de entrada 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 de cliente a largo plazo. Como alternativa, puede utilizar Audience Manager API para obtener metadatos de segmento automáticamente.
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 segmento a intervalos programados o automáticamente, siempre que procese Audience Manager datos y busque un nuevo ID de segmento. Consulte los pasos a continuación para obtener más información.
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 lugar para empezar si no ha trabajado con Audience Manager API antes.
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 en amsupport@adobe.com.
Solicite lo siguiente a cada cliente integrado:
Después de completar los pasos anteriores, puede utilizar un método GET
para recuperar los metadatos del segmento. Para obtener una solicitud y una respuesta de ejemplo, consulte 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.
Parámetro | Descripción |
---|---|
|
El ID de segmento del Audience Manager. |
|
El nombre del segmento. |
|
Texto que describe brevemente el segmento. |
|
Estado actual de la asignación de segmentos. Las opciones de estado que se devuelven incluyen:
|