Introducción a la API Real-time Customer Profile

Mediante los extremos de la API del perfil del cliente en tiempo real, puede realizar operaciones CRUD básicas con los datos del perfil, como la configuración de atributos calculados, el acceso a entidades, la exportación de datos del perfil y la eliminación de conjuntos de datos o lotes innecesarios.

El uso de la guía para desarrolladores requiere comprender bien los distintos servicios de Adobe Experience Platform involucrados en el trabajo con datos Profile. Antes de comenzar a trabajar con la API Real-time Customer Profile , revise la documentación de los siguientes servicios:

  • Real-time Customer Profile: Proporciona un perfil de cliente unificado en tiempo real basado en datos agregados de varias fuentes.
  • Adobe Experience Platform Identity Service: Obtenga una mejor visión de su cliente y de su comportamiento al unir identidades entre dispositivos y sistemas.
  • Adobe Experience Platform Segmentation Service: Permite generar segmentos de audiencia a partir de datos del perfil del cliente en tiempo real.
  • Experience Data Model (XDM): El marco estandarizado mediante el cual Platform organiza los datos de experiencia del cliente.
  • Sandboxes: Experience Platform proporciona entornos limitados virtuales que dividen una sola Platform instancia en entornos virtuales independientes para ayudar a desarrollar y desarrollar aplicaciones de experiencia digital.

Las secciones siguientes proporcionan información adicional que debe conocer para realizar llamadas correctamente a Profile extremos de API.

Leer llamadas de API de ejemplo

La documentación de la API Real-time Customer Profile proporciona ejemplos de llamadas de API para demostrar cómo dar formato adecuado a las solicitudes. Estas incluyen rutas de acceso, encabezados necesarios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de API. Para obtener información sobre las convenciones utilizadas en la documentación para las llamadas de API de ejemplo, consulte la sección sobre cómo leer llamadas de API de ejemplo en la guía de solución de problemas Experience Platform.

Encabezados requeridos

La documentación de la API también requiere que haya completado el tutorial de autenticación para realizar correctamente llamadas a Platform extremos. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en Experience Platform llamadas a la API, como se muestra a continuación:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

Todos los recursos de Experience Platform están aislados en entornos limitados virtuales específicos. Las solicitudes para las API Platform requieren un encabezado que especifique el nombre del simulador para pruebas en el que se realizará la operación:

  • x-sandbox-name: {SANDBOX_NAME}

Para obtener más información sobre los entornos limitados en Platform, consulte la documentación general del entorno limitado.

Todas las solicitudes con una carga útil en el cuerpo de la solicitud (como llamadas de POST, PUT y PATCH) deben incluir un encabezado Content-Type. Los valores aceptados específicos de cada llamada se proporcionan en los parámetros de llamada .

Pasos siguientes

Para empezar a realizar llamadas mediante la API Real-time Customer Profile, seleccione una de las guías de punto final disponibles.

En esta página