Cree un segmento con la API del servicio de segmentación

Este documento proporciona un tutorial para desarrollar, probar, previsualizar y guardar una definición de segmento mediante Adobe Experience Platform Segmentation Service API.

Para obtener información sobre cómo generar segmentos mediante la interfaz de usuario, consulte la Guía del Generador de segmentos.

Primeros pasos

Este tutorial requiere una comprensión práctica de los distintos Adobe Experience Platform servicios implicados en la creación de segmentos de audiencia. Antes de comenzar este tutorial, revise la documentación de los siguientes servicios:

Real-Time Customer Profile: Proporciona un perfil de consumidor unificado y en tiempo real basado en los datos agregados de varias fuentes.
Adobe Experience Platform Segmentation Service: Permite crear 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. Para utilizar mejor la segmentación, asegúrese de que sus datos se incorporan como perfiles y eventos según el prácticas recomendadas para el modelado de datos.

Las secciones siguientes proporcionan información adicional que deberá conocer para poder realizar llamadas correctamente a Platform API.

Leer llamadas de API de muestra

Este tutorial proporciona llamadas de API de ejemplo para demostrar cómo dar formato a las solicitudes. 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 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.

Recopilar valores para los encabezados obligatorios

Para realizar llamadas a Platform API, primero debe completar el tutorial de autenticación. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en todas las Experience Platform Llamadas de API, 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 aisladas para zonas protegidas virtuales específicas. Todas las 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}

NOTA

Para obtener más información sobre las zonas protegidas en Platform, consulte la documentación general de zona protegida.

Todas las solicitudes que contienen una carga útil (POST, PUT, PATCH) requieren un encabezado adicional:

Content-Type: application/json

Desarrollar una definición de segmento

El primer paso de la segmentación es definir un segmento, representado en una construcción denominada definición de segmento. Una definición de segmento es un objeto que encapsula una consulta escrita en Profile Query Language (PQL). Este objeto también se denomina predicado PQL. Los predicados PQL definen las reglas del segmento en función de las condiciones relacionadas con cualquier registro o dato de serie temporal que proporcione a Real-Time Customer Profile. Consulte la Guía de PQL para obtener más información sobre cómo escribir consultas PQL.

Puede crear una nueva definición de segmento realizando una solicitud de POST a /segment/definitions punto final en la Segmentation API. En el siguiente ejemplo se describe cómo dar formato a una solicitud de definición, incluida la información necesaria para que un segmento se defina correctamente.

Para obtener una explicación detallada sobre cómo definir un segmento, lea la guía para desarrolladores de definición de segmentos.

Calcular y previsualizar una audiencia

A medida que desarrolle su definición de segmento, puede utilizar las herramientas de estimación y vista previa dentro de Real-Time Customer Profile para ver información de resumen que le ayude a aislar la audiencia esperada. Las estimaciones proporcionan información estadística sobre una definición de segmento, como el tamaño de audiencia proyectado y el intervalo de confianza. Las vistas previas proporcionan listas paginadas de perfiles aptos para una definición de segmento, lo que le permite comparar los resultados con lo que espera.

Al estimar y previsualizar la audiencia, puede probar y optimizar los predicados PQL hasta que produzcan un resultado deseado, donde luego se pueden utilizar en una definición de segmento actualizada.

Hay dos pasos necesarios para obtener una vista previa o una estimación del segmento:

Creación de un trabajo de vista previa
Ver estimación o previsualización uso del ID del trabajo de vista previa

Cómo se generan las estimaciones

Las muestras de datos se utilizan para evaluar segmentos y estimar el número de perfiles cualificados. Los nuevos datos se cargan en la memoria cada mañana (entre las 00:00 y las 02:00 PT, que oscila entre las 07:00 y las 09:00 UTC), y todas las consultas de segmentación se calculan con los datos de muestra de ese día. En consecuencia, cualquier nuevo campo añadido o datos adicionales recopilados se reflejarán en las estimaciones al día siguiente.

El tamaño de la muestra depende del número total de entidades del almacén de perfiles. Estos tamaños de muestra se representan en la siguiente tabla:

Entidades en el almacén de perfiles	Tamaño de muestra
Menos de 1 millón	Conjunto de datos completo
1 a 20 millones	1 millón
Más de 20 millones	5 % del total

Las estimaciones suelen durar entre 10 y 15 segundos, comenzando con una estimación aproximada y perfeccionando a medida que se leen más registros.

Creación de un trabajo de vista previa

Puede crear un nuevo trabajo de vista previa realizando una solicitud de POST al /preview punto final.

Puede encontrar instrucciones detalladas sobre la creación de un trabajo de vista previa en la guía de extremos de previsualizaciones y estimaciones.

Ver una estimación o previsualización

Los procesos de estimación y vista previa se ejecutan de forma asíncrona, ya que las distintas consultas pueden tardar distintos periodos en completarse. Una vez iniciada una consulta, puede utilizar llamadas a la API para recuperar (GET) el estado actual de la estimación o previsualización a medida que progresa.

Uso del Segmentation Service API, puede buscar el estado actual de un trabajo de vista previa por su ID. Si el estado es "RESULT_READY", puede ver los resultados. Para consultar el estado actual de un trabajo de vista previa, lea la sección sobre sección recuperación de un trabajo de vista previa en la guía de previsualizaciones y estimaciones de extremos. Para consultar el estado actual de un trabajo de estimación, lea la sección sobre recuperación de un trabajo de estimación en la guía de previsualizaciones y estimaciones de extremos.

Pasos siguientes

Una vez que haya desarrollado, probado y guardado su definición de segmento, puede crear un trabajo de segmento para crear una audiencia utilizando Segmentation Service API. Consulte el tutorial sobre evaluación y acceso a los resultados de los segmentos para ver los pasos detallados sobre cómo hacerlo.