Encabezados obligatorios
Este tutorial también requiere que haya completado el tutorial de autenticación para realizar correctamente llamadas a las API de Experience Platform. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados obligatorios en todas las llamadas de API de Experience Platform, como se muestra a continuación:
- Autorización: Portador
{ACCESS_TOKEN}
- x-api-key:
{API_KEY}
- x-gw-ims-org-id:
{ORG_ID}
Todos los recursos de Experience Platform están aislados en zonas protegidas virtuales específicas. Las solicitudes a las API Experience Platform requieren un encabezado que especifique el nombre de la zona protegida en la que se realizará la operación:
- x-sandbox-name:
{SANDBOX_NAME}
Todas las solicitudes de POST, PUT y PATCH requieren un encabezado adicional:
- Content-Type: application/json
Evaluación de una definición de segmento
Una vez que haya desarrollado, probado y guardado la definición del segmento, puede evaluarla mediante la evaluación programada o la evaluación bajo demanda.
La evaluación programada (también conocida como "segmentación programada") le permite crear una programación recurrente para ejecutar un trabajo de exportación a una hora específica, mientras que la evaluación bajo demanda implica la creación de un trabajo de segmento para generar la audiencia inmediatamente. A continuación se describen los pasos de cada uno.
Si todavía no ha completado el tutorial crear una definición de segmento con la API de segmentación o ha creado una definición de segmento con Generador de segmentos, hágalo antes de continuar con este tutorial.
Evaluación programada
Mediante la evaluación programada, su organización puede crear una programación recurrente para ejecutar automáticamente los trabajos de exportación.
Creación de una programación
Al realizar una petición POST al extremo /config/schedules
, puede crear una programación e incluir la hora específica en que se debe activar la programación.
Encontrará información más detallada sobre el uso de este extremo en la guía de extremo de programaciones
Habilitar una programación
De manera predeterminada, una programación está inactiva cuando se crea a menos que la propiedad state
se establezca en active
en el cuerpo de la solicitud de creación (POST). Puede habilitar una programación (establecer state
en active
) realizando una petición PATCH al extremo /config/schedules
e incluyendo el ID de la programación en la ruta.
Encontrará información más detallada sobre el uso de este extremo en la guía de extremo de programaciones
Actualizar la hora de programación
El tiempo de programación se puede actualizar realizando una petición PATCH al extremo /config/schedules
e incluyendo el ID de la programación en la ruta.
Encontrará información más detallada sobre el uso de este extremo en la guía de extremo de programaciones
Evaluación a la carta
La evaluación bajo demanda le permite crear un trabajo de segmentación para generar una audiencia siempre que lo necesite. A diferencia de la evaluación programada, esto solo ocurrirá cuando se solicite y no sea recurrente.
Creación de un trabajo de segmentación
Un trabajo de segmentación es un proceso asincrónico que crea un segmento de audiencia bajo demanda. Hace referencia a una definición de segmento, así como a cualquier política de combinación que controle cómo Real-Time Customer Profile combina atributos superpuestos en los fragmentos de perfil. Cuando un trabajo de segmentación se completa correctamente, puede recopilar información diversa acerca de la definición del segmento, como los errores que se hayan podido producir durante el procesamiento y el tamaño final de la audiencia. Se debe ejecutar un trabajo de segmento cada vez que desee actualizar la audiencia a la que se clasifica actualmente la definición del segmento.
Puede crear un nuevo trabajo de segmento realizando una petición POST al extremo /segment/jobs
en la API Real-Time Customer Profile.
Encontrará información más detallada sobre el uso de este extremo en la guía de extremo de trabajos de segmentación
Búsqueda del estado del trabajo del segmento
Puede utilizar id
para un trabajo de segmento específico con el fin de realizar una solicitud de búsqueda (GET) y ver el estado actual del trabajo.
Encontrará información más detallada sobre el uso de este extremo en la guía de extremo de trabajos de segmentación