Segmentación de Edge
La segmentación de Edge es la capacidad de evaluar definiciones de segmentos en Adobe Experience Platform de forma instantánea en Edge de, lo que permite casos de uso de personalización de la misma página y de la siguiente.
Introducción
Esta guía para desarrolladores requiere una comprensión práctica de los distintos servicios de Adobe Experience Platform relacionados con la segmentación de Edge. Antes de comenzar este tutorial, revise la documentación de los siguientes servicios:
- Real-Time Customer Profile: proporciona un perfil de consumidor unificado en tiempo real, basado en los datos agregados de varias fuentes.
- Adobe Experience Platform Segmentation Service: permite crear audiencias a partir de los datos de Real-Time Customer Profile.
- Experience Data Model (XDM): El marco estandarizado mediante el cual Platform organiza los datos de experiencia del cliente.
Para realizar llamadas correctamente a cualquier extremo de API de Experience Platform, lea la guía de introducción a las API de plataforma para obtener información acerca de los encabezados necesarios y cómo leer llamadas de API de ejemplo.
Tipos de consultas de segmentación de Edge query-types
Para que se pueda evaluar un segmento mediante la segmentación de Edge, la consulta debe cumplir las siguientes directrices:
Además, el segmento debe estar vinculado a una política de combinación que esté activa en Edge. Para obtener más información acerca de las políticas de combinación, lea la guía de políticas de combinación.
Una definición de segmento no se habilitará para la segmentación de perímetros en los siguientes casos:
- La definición del segmento incluye una combinación de un solo evento y un evento
inSegment.- Sin embargo, si el segmento contenido en el evento
inSegmentes solo de perfil, la definición del segmento se habilitará para la segmentación de Edge.
- Sin embargo, si el segmento contenido en el evento
- La definición del segmento utiliza "Ignorar año" como parte de sus restricciones de tiempo.
Recuperar todos los segmentos habilitados para la segmentación de Edge
Puede recuperar una lista de todos los segmentos habilitados para la segmentación de extremos dentro de su organización realizando una solicitud de GET al extremo /segment/definitions.
Formato de API
Para recuperar segmentos habilitados para la segmentación de Edge, debe incluir el parámetro de consulta evaluationInfo.synchronous.enabled=true en la ruta de solicitud.
GET /segment/definitions?evaluationInfo.synchronous.enabled=true
Solicitud
curl -X GET \
'https://platform.adobe.io/data/core/ups/segment/definitions?evaluationInfo.synchronous.enabled=true' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-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 una matriz de segmentos en su organización que están habilitados para la segmentación de Edge. Encontrará información más detallada sobre la definición de segmento devuelta en la guía de extremo de definiciones de segmento.
{
"segments": [
{
"id": "15063cb-2da8-4851-a2e2-bf59ddd2f004",
"schema": {
"name": "_xdm.context.profile"
},
"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": false
},
"synchronous": {
"enabled": true
}
},
"creationTime": 1572029711000,
"updateEpoch": 1572029712000,
"updateTime": 1572029712000
},
{
"id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
"schema": {
"name": "_xdm.context.profile"
},
"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": false
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": true
}
},
"creationTime": 1572021085000,
"updateEpoch": 1572021086000,
"updateTime": 1572021086000
}
],
"page": {
"totalCount": 2,
"totalPages": 1,
"sortField": "creationTime",
"sort": "desc",
"pageSize": 2,
"limit": 100
},
"link": {}
}
Cree un segmento que esté habilitado para la segmentación de Edge
Puede crear un segmento habilitado para la segmentación de Edge realizando una solicitud de POST al extremo /segment/definitions que coincida con uno de los tipos de consultas de segmentación de Edge enumerados arriba.
Formato de API
POST /segment/definitions
Solicitud
curl -X POST \
https://platform.adobe.io/data/core/ups/segment/definitions \
-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}' \
-d '{
"schema": {
"name": "_xdm.context.profile"
},
"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": false
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": true
}
}
}'
Respuesta
Una respuesta correcta devuelve los detalles de la definición del segmento recién creada que está habilitada para la segmentación de Edge.
{
"id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
"schema": {
"name": "_xdm.context.profile"
},
"imsOrgId": "{ORG_ID}",
"sandbox": {
"sandboxId": "{SANDBOX_ID}",
"sandboxName": "{SANDBOX_NAME}",
"type": "production",
"default": true
},
"name": "Homepage_continuous",
"description": "People who are on their homepage - continuous",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "chain(xEvent, timestamp, [X: WHAT(var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = "true")])"
},
"evaluationInfo": {
"batch": {
"enabled": false
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": true
}
},
"creationTime": 1572021085000,
"updateEpoch": 1572021086000,
"updateTime": 1572021086000
}
Pasos siguientes
Ahora que sabe cómo crear segmentos habilitados para la segmentación de Edge, puede utilizarlos para habilitar casos de uso de personalización de la misma página y de la siguiente.
Para aprender a realizar acciones similares y trabajar con segmentos mediante la interfaz de usuario de Adobe Experience Platform, visite la guía del usuario del Generador de segmentos.
Apéndice
En la siguiente sección se enumeran las preguntas más frecuentes sobre la segmentación de Edge:
¿Cuánto tiempo tarda un segmento en estar disponible en el Edge Network?
Un segmento puede tardar hasta una hora en estar disponible en el Edge Network.