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}
NOTA
Para obtener más información sobre las zonas protegidas en Experience Platform, consulte la documentación de información general sobre las zonas protegidas.

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.

NOTA
La evaluación programada se puede habilitar para las zonas protegidas con un máximo de cinco (5) políticas de combinación para XDM Individual Profile. Si su organización tiene más de cinco políticas de combinación para XDM Individual Profile en un solo entorno de zona protegida, no podrá utilizar la evaluación programada.

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