DocumentaciónExperience PlatformGuía del servicio de segmentación

Guía de segmentación de streaming

Last update: Thu Apr 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Usuario

La segmentación por streaming es la capacidad de evaluar audiencias en Adobe Experience Platform en tiempo casi real, al tiempo que se centra en la riqueza de datos.

Con la segmentación por streaming, la calificación de audiencia ahora se produce cuando los datos de streaming llegan a Experience Platform, lo que alivia la necesidad de programar y ejecutar trabajos de segmentación. Esto le permite evaluar los datos a medida que se pasan a Experience Platform, lo que permite mantener actualizada automáticamente la pertenencia a audiencias.

Tipos de consulta aptos query-types

Una consulta puede optar a la segmentación de flujo continuo si cumple cualquiera de los criterios descritos en la siguiente tabla.

NOTE
Para que la segmentación de streaming funcione, deberá habilitar la segmentación programada para la organización. Para obtener más información sobre cómo habilitar la segmentación programada, consulte la descripción general de Audience Portal.
Tipo de consulta
Detalles
Consulta
Ejemplo
Evento único en un intervalo de tiempo inferior a 24 horas
Cualquier definición de segmento que haga referencia a un único evento entrante en un intervalo de tiempo inferior a 24 horas.
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
Se muestra un ejemplo de un solo evento dentro de una ventana de tiempo relativa.
Solo perfil
Cualquier definición de segmento que haga referencia únicamente a un atributo de perfil.
homeAddress.country.equals("US", false)
Se muestra un ejemplo de atributo de perfil.
Evento único con un atributo de perfil en un intervalo de tiempo relativo inferior a 24 horas
Cualquier definición de segmento que haga referencia a un único evento entrante, con uno o más atributos de perfil, y que se produzca en un intervalo de tiempo relativo inferior a 24 horas.
workAddress.country.equals("US", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
Se muestra un ejemplo de un solo evento con un atributo de perfil en un intervalo de tiempo relativo.
Segmento de segmentos
Cualquier definición de segmento que contenga uno o más segmentos de flujo continuo o por lotes. Nota: Si se usa un segmento de segmentos, la descalificación del perfil se producirá cada 24 horas.
inSegment("a730ed3f-119c-415b-a4ac-27c396ae2dff") and inSegment("8fbbe169-2da6-4c9d-a332-b6a6ecf559b9")
Se muestra un ejemplo de un segmento de segmentos.
Varios eventos con un atributo de perfil
Cualquier definición de segmento que haga referencia a varios eventos en las últimas 24 horas y (opcionalmente) tenga uno o más atributos de perfil.
workAddress.country.equals("US", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("directMarketing.emailClicked", false)) WHEN(today), C1: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
Se muestra un ejemplo de varios eventos con un atributo de perfil.

Una definición de segmento no será elegible para la segmentación de streaming en los siguientes casos:

  • La definición del segmento incluye segmentos o rasgos de Adobe Audience Manager (AAM).
  • La definición del segmento incluye varias entidades (consultas de varias entidades).
  • La definición del segmento incluye una combinación de un solo evento y un evento inSegment.
    • Sin embargo, si la definición del segmento contenida en el evento inSegment es solo de perfil, la definición del segmento se habilitará para la segmentación de flujo continuo.
  • La definición del segmento utiliza "Ignorar año" como parte de sus restricciones de tiempo.

Tenga en cuenta las siguientes directrices que se aplican a las consultas de segmentación de streaming:

Tipo de consulta
Directriz
Consulta de evento único
No hay límites en la ventana retrospectiva.
Consulta con historial de eventos
  • La ventana retrospectiva está limitada a un día.
  • Debe existir una condición de orden de tiempo estricta entre los eventos.
  • Se admiten consultas con al menos un evento denegado. Sin embargo, todo el evento no puede ser una negación.

Si se modifica una definición de segmento para que ya no cumpla los criterios de segmentación de flujo continuo, la definición de segmento cambiará automáticamente de "Flujo" a "Lote".

Además, la descalificación de segmentos, de manera similar a la calificación de segmentos, se produce en tiempo real. Como resultado, si una audiencia ya no cumple los requisitos para un segmento, se elimina inmediatamente. Por ejemplo, si la definición del segmento solicita "Todos los usuarios que compraron zapatos rojos en las últimas tres horas", después de tres horas, todos los perfiles que inicialmente se calificaron para la definición del segmento serán no calificados.

Crear público create-audience

Puede crear una audiencia que se evalúe mediante la segmentación de flujo continuo mediante la API del servicio de segmentación o a través de Audience Portal en la interfaz de usuario.

Una definición de segmento puede habilitarse para streaming si coincide con uno de los tipos de consulta elegibles.

API del servicio de segmentación

Formato de API

code language-http 
POST /segment/definitions

Solicitud

accordion
Una solicitud de ejemplo para crear una definición de segmento habilitada para la segmentación de flujo continuo
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/segment/definitions
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '{
        "name": "People in the USA",
        "description: "An audience that looks for people who live in the USA",
        "expression": {
            "type": "PQL",
            "format": "pql/text",
            "value": "homeAddress.country = \"US\""
        },
        "evaluationInfo": {
            "batch": {
                "enabled": false
            },
            "continuous": {
                "enabled": true
            },
            "synchronous": {
                "enabled": false
            }
        },
        "schema": {
            "name": "_xdm.context.profile"
        }
     }'

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 con detalles de la definición del segmento recién creada.

accordion
Una respuesta de ejemplo al crear una definición de segmento.
code language-json 
{
    "id": "4afe34ae-8c98-4513-8a1d-67ccaa54bc05",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "profileInstanceId": "ups",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "People in the USA",
    "description": "An audience that looks for people who live in the USA",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "homeAddress.country = \"US\""
    },
    "evaluationInfo": {
        "batch": {
            "enabled": false
        },
        "continuous": {
            "enabled": true
        },
        "synchronous": {
            "enabled": false
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 0,
    "updateEpoch": 1579292094,
    "updateTime": 1579292094000
}

Encontrará más información sobre el uso de este extremo en la guía de extremo de definición de segmento.

Portal de públicos

En Audience Portal, seleccione Crear audiencia.

El botón Crear audiencia está resaltado en el Portal de audiencias.

Aparece una ventana emergente. Seleccione Generar reglas para ingresar al Generador de segmentos.

El botón Generar reglas está resaltado en la ventana emergente Crear audiencia.

En el Generador de segmentos, cree una definición de segmento que coincida con uno de los tipos de consulta aptos. Si la definición del segmento cumple los requisitos para la segmentación de transmisión, podrá seleccionar Transmisión como método de evaluación.

Se muestra la definición del segmento. El tipo de evaluación está resaltado y muestra que la definición del segmento se puede evaluar mediante la segmentación de flujo continuo.

Para obtener más información sobre cómo crear definiciones de segmentos, lea la guía del Generador de segmentos

Recuperar audiencias retrieve-audiences

Puede recuperar todas las audiencias que se evalúan mediante la segmentación de streaming mediante la API del servicio de segmentación o a través de Audience Portal en la interfaz de usuario.

API del servicio de segmentación

Recupere una lista de todas las definiciones de segmentos que se evalúan mediante la segmentación de flujo continuo dentro de su organización realizando una petición GET al extremo /segment/definitions.

Formato de API

Debe incluir el parámetro de consulta evaluationInfo.synchronous.enabled=true en la ruta de solicitud para recuperar las definiciones de segmento evaluadas mediante la segmentación de flujo continuo.

code language-http 
GET /segment/definitions?evaluationInfo.continuous.enabled=true

Solicitud

accordion
Una solicitud de muestra para ver una lista de todas las definiciones de segmentos habilitados para streaming
code language-shell 
curl -X GET 'https://platform.adobe.io/data/core/ups/segment/definitions?evaluationInfo.continuous.enabled=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 con una matriz de definiciones de segmentos en su organización que están habilitadas para la segmentación de flujo continuo.

accordion
Una respuesta de ejemplo que contiene una lista de todas las definiciones de segmentos habilitadas para la segmentación por streaming de su organización
code language-json 
{
    "segments": [
        {
            "id": "15063cb-2da8-4851-a2e2-bf59ddd2f004",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "ttlInDays": 30,
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "",
                "sandboxName": "",
                "type": "production",
                "default": true
            },
            "name": " People who are NOT on their homepage ",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = false"
            },
            "evaluationInfo": {
                "batch": {
                    "enabled": false
                },
                "continuous": {
                    "enabled": true
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "creationTime": 1572029711000,
            "updateEpoch": 1572029712000,
            "updateTime": 1572029712000
        },
        {
            "id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "ttlInDays": 30,
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "",
                "sandboxName": "",
                "type": "production",
                "default": true
            },
            "name": "Homepage_continuous",
            "description": "People who are on their homepage - continuous",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = true"
            },
            "evaluationInfo": {
                "batch": {
                    "enabled": true
                },
                "continuous": {
                    "enabled": true
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "creationTime": 1572021085000,
            "updateEpoch": 1572021086000,
            "updateTime": 1572021086000
        }
    ],
    "page": {
        "totalCount": 2,
        "totalPages": 1,
        "sortField": "creationTime",
        "sort": "desc",
        "pageSize": 2,
        "limit": 100
    },
    "link": {}
}

Encontrará información más detallada sobre la definición de segmento devuelta en la guía de extremo de definiciones de segmento.
Portal de públicos

Puede recuperar todas las audiencias habilitadas para la segmentación de streaming dentro de su organización mediante filtros en Audience Portal. Seleccione el icono de filtro para mostrar la lista de filtros.

El icono de filtro está resaltado en Audience Portal.

Dentro de los filtros disponibles, ve a Actualizar frecuencia y selecciona "Transmisión". Uso de este filtro muestra todas las audiencias de su organización que se evalúan mediante la segmentación de flujo continuo.

Se ha seleccionado la frecuencia Actualización de flujo continuo, que muestra todas las audiencias de la organización que se evalúan mediante la segmentación de flujo continuo.

Para obtener más información acerca de cómo ver audiencias en Experience Platform, lea la guía de Audience Portal.

Detalles de público audience-details

Puede ver los detalles de una audiencia específica evaluada mediante la segmentación de flujo continuo seleccionándola en Audience Portal.

Después de seleccionar una audiencia en Audience Portal, aparece la página de detalles de la audiencia. Muestra información sobre la audiencia, incluido un resumen de los detalles de la audiencia, la cantidad de perfiles cualificados a lo largo del tiempo, así como los destinos a los que se ha activado la audiencia.

Se muestra la página de detalles de audiencia de una audiencia evaluada mediante la segmentación de flujo continuo.

Para audiencias habilitadas para streaming, se muestra la tarjeta Perfiles a lo largo del tiempo, que muestra las métricas totales calificadas y actualizadas de la nueva audiencia.

La métrica Total de audiencias calificadas representa el número total de audiencias calificadas, según las evaluaciones por lotes y de streaming para esta audiencia.

La métrica Nueva audiencia actualizada está representada por un gráfico de líneas que muestra el cambio en el tamaño de la audiencia a través de la segmentación de flujo continuo. Puede ajustar el menú desplegable para mostrar las últimas 24 horas, la semana pasada o los últimos 30 días.

La tarjeta Perfiles a lo largo del tiempo está resaltada.

Para obtener más información sobre los detalles de la audiencia, lea la descripción general del Portal de audiencias.

Pasos siguientes

En esta guía se explica cómo funcionan las definiciones de segmentos habilitadas para streaming en Adobe Experience Platform y cómo monitorizar las definiciones de segmentos habilitadas para streaming.

Para obtener más información acerca del uso de la interfaz de usuario de Adobe Experience Platform, lea la Guía del usuario de segmentación.

Para las preguntas más frecuentes acerca de la segmentación por transmisión, lea la sección de segmentación por transmisión de las preguntas frecuentes.

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871