Introducción a la Real-Time Customer Profile API getting-started
Con los extremos de la API del perfil del cliente en tiempo real, puede realizar operaciones básicas de CRUD con datos de perfil, como configurar atributos calculados, acceder a entidades, exportar datos de perfil y eliminar conjuntos de datos o lotes innecesarios.
El uso de la guía para desarrolladores requiere una comprensión práctica de los distintos servicios de Adobe Experience Platform implicados en trabajar con Profile datos. Antes de comenzar a trabajar con Real-Time Customer Profile API, consulte la documentación de los siguientes servicios:
- Real-Time Customer Profile: Proporciona un perfil de cliente unificado en tiempo real en función de los datos agregados de varias fuentes.
- Adobe Experience Platform Identity Service: obtenga una mejor vista de su cliente y de su comportamiento al unir identidades entre dispositivos y sistemas.
- Adobe Experience Platform Segmentation Service: Permite crear audiencias a partir de los 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 zonas protegidas virtuales que dividen una sola Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.
Las secciones siguientes proporcionan información adicional que deberá conocer para poder realizar llamadas correctamente a Profile Extremos de API.
Lectura de llamadas de API de muestra
El Real-Time Customer Profile La documentación de la API proporciona ejemplos de llamadas a la API para demostrar cómo dar formato a las solicitudes correctamente. Estas incluyen rutas, encabezados obligatorios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de la API. Para obtener información sobre las convenciones utilizadas en la documentación de las llamadas de API de ejemplo, consulte la sección sobre cómo leer llamadas de API de ejemplo en el Experience Platform guía de solución de problemas.
Encabezados obligatorios
La documentación de la API también requiere que haya completado la tutorial de autenticación para realizar llamadas correctamente a Platform puntos finales. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en Experience Platform Llamadas de API, como se muestra a continuación:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Todos los recursos de Experience Platform están aisladas para zonas protegidas virtuales específicas. Solicitudes a Platform Las API requieren un encabezado que especifique el nombre de la zona protegida en la que se realizará la operación:
x-sandbox-name: {SANDBOX_NAME}
Para obtener más información sobre las zonas protegidas en Platform, consulte la documentación general de zona protegida.
Todas las solicitudes con una carga útil en el cuerpo de la solicitud (como llamadas de POST, PUT y PATCH) deben incluir un Content-Type encabezado. Los valores aceptados específicos de cada llamada se proporcionan en los parámetros de llamada.
Pasos siguientes
Para empezar a realizar llamadas utilizando Real-Time Customer Profile API, seleccione una de las guías de extremos disponibles.