Recuperación de metadatos del segmento

Última actualización: 20 de julio de 2024
  • Temas:

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

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

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: Revisión de 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:

  • Nombre de usuario: para un usuario restringido que tenga permisos de solo lectura para el destino asociado a una integración específica.
  • Contraseña: la contraseña de usuario.
  • ID de destino: es el ID (un entero) asociado al destino creado para la integración específica servidor-a-servidor.

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.

ParámetroDescripción
destinationMappingIdEl identificador de segmento Audience Manager.
elementNameEl nombre del segmento.
elementDescriptionTexto que describe brevemente el segmento.
elementStatus

Estado actual de la asignación de segmentos. Las opciones de estado devueltas incluyen:

  • active
  • inactive
  • deleted
Página anterior
Página siguiente

Audience Manager