Show Menu
TEMAS×

Recuperación de metadatos del segmento

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, al compartir esta información con sus clientes (o trabajar con ellos mismos), 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 prácticos a disposición de sus clientes con 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 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 sistema que ha creado y mantenido con este fin. Estos procesos funcionan, pero a menudo son engorrosos, requieren mucho tiempo y pueden requerir 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 del cliente a largo plazo. Como alternativa, puede usar el Audience Manager para obtener automáticamente los metadatos del segmento API .

Método automatizado

Audience Manager proporciona un conjunto de API de REST que le permiten recuperar metadatos de segmentos automáticamente. Con API, puede crear trabajos que recuperen metadatos de segmentos 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.

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 lugar para empezar si no has trabajado con el Audience Manager antes 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 de correo electrónico a Audience Manager Customer Care at 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: Es para un usuario restringido que tiene 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 de servidor a servidor.

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

Después de completar los pasos anteriores, puede utilizar un GET método para recuperar los metadatos del segmento. Para obtener una solicitud de muestra y una respuesta, consulte Asignaciones de destino de retorno . Esta llamada devuelve datos de segmentos formateados como pares de clave-valor en un JSON objeto. Algunos de los atributos de segmento importantes devueltos en la respuesta se enumeran en la siguiente tabla.
Parámetro Descripción
destinationMappingId
ID del segmento de Audience Manager .
elementName
El nombre del segmento.
elementDescription
Texto que describe brevemente el segmento.
elementStatus
Estado actual de la asignación de segmentos. Las opciones de estado que se devuelve incluyen:
  • activo
  • inactivo
  • eliminado