Datos de contexto y solicitudes de Edge Decisioning
- Temas:
- Gestión de decisiones
Creado para:
- Experimentado
- Desarrollador
Esta sección le guía a través del paso de datos de contexto en solicitudes de Edge Decisioning y su uso en reglas de elegibilidad. Exploraremos un caso de uso completo que muestra cómo ofrecer ofertas personalizadas en función del tipo de dispositivo que utilizan los clientes.
Este caso de uso implica varios pasos clave:
- Configurar requisitos previos: Asegúrese de que se hayan completado todos los pasos necesarios para pasar los datos de contexto en sus solicitudes.
- Usar datos de contexto en reglas de idoneidad: cree reglas que determinen qué ofertas mostrar en función del tipo de dispositivo del usuario.
- Diseñar ofertas específicas del dispositivo: cree ofertas adaptadas para cada tipo de dispositivo y vincúlelas a las reglas correspondientes.
- Crear una colección de ofertas: Agrupe todas las ofertas en una colección estática.
- Configurar una decisión : Cree una nueva decisión que aproveche el motor de decisión de ofertas para elegir la mejor oferta y presentarla a los usuarios según su tipo de dispositivo.
- Pasar datos de contexto en la solicitud de Edge Decisioning: pase datos de contexto a través de su solicitud de API para recuperar y presentar las ofertas adecuadas a los usuarios.
Para ir más lejos, también puede aprovechar los datos de contexto en fórmulas de clasificación o personalizar las representaciones de sus ofertas de forma dinámica. Por ejemplo, se puede crear una sola oferta y utilizar campos de personalización para adaptar su representación en función de los datos de contexto. Por ejemplo, mostrar una imagen determinada si el usuario tiene un iphone y otra para los usuarios de ipad. Para obtener más información, consulte estas secciones:
Requisitos previos para pasar datos de contexto en solicitudes de Edge Decisioning
A diferencia de pasar el contexto en un formato bastante libre mediante la API de decisiones, la carga útil de contexto de Edge Decisioning debe ser compatible con el evento de experiencia XDM. Para ello, el contexto debe definirse como parte del "Evento de experiencia XDM" que se utiliza para la recopilación de datos.
-
Defina un esquema de evento de experiencia. Para el propósito de este caso de uso, se crea un esquema "Contexto de oferta" y los campos del contexto de oferta forman parte de un grupo de campos "Contexto de oferta". En realidad, el grupo de campos se agregaría al esquema de evento de experiencia utilizado para la recopilación de datos asociado al flujo de datos "Edge Collection Network".
NOTEEl esquema del evento de experiencia del contexto de oferta debe formar parte del perfil, con un campo CUSTOMER_ID utilizado como identidad principal.En este ejemplo, el grupo de campos "Contexto de oferta" tiene dos propiedades: language y deviceType. Estas propiedades se utilizarán en la clasificación de ofertas y en las reglas de elegibilidad.
Aprenda a trabajar con esquemas en la guía de Adobe Experience Platform Experience Data Model (XDM)
-
Cree un conjunto de datos (aquí "Contexto de la oferta") y asegúrese de que esté habilitado para el perfil.
-
Cree una nueva secuencia de datos a partir del menú Recopilación de datos > Secuencias de datos. Aprenda a crear y configurar flujos de datos en la guía de flujos de datos de Adobe Experience Platform
Aquí, hemos creado un flujo de datos de "Contexto de oferta", con el esquema de evento "Contenido de oferta" seleccionado.
-
Edite el conjunto de datos recién creado y seleccione "Adobe Experience Platform" como servicio y "Contexto de oferta" como conjunto de datos de evento.
-
Guarde la secuencia de datos y copie su ID. Este ID se utilizará en el punto final de su solicitud de API. Aprenda a crear la llamada de API
Uso de datos de contexto en reglas de idoneidad
Cree reglas de aceptación que determinen qué ofertas mostrar en función del tipo de dispositivo del usuario:
-
regla de dispositivo iphone:
-
Nombre de regla: "Edge Context Rule - iphone"
-
Configuración: deviceType = 'iphone'
-
Sintaxis de PQL:
select _Any1 from xEvent where _Any1._experienceplatform.offerContextData.deviceType.equals("iphone", false)
-
-
regla de dispositivo ipad:
-
Nombre de regla: "Edge Context Rule - ipad"
-
Configuración: deviceType = 'ipad'
-
Sintaxis de PQL
select _Any1 from xEvent where _Any1._experienceplatform.offerContextData.deviceType.equals("ipad", false)
-
Crear ofertas
Cree una oferta para cada tipo de dispositivo y vincúlela a la regla de elegibilidad correspondiente creada anteriormente:
-
Oferta para usuarios de iphone:
- Nombre de la oferta : "Edge Context - iPhone Offer Content"
- Regla asociada: "Regla de contexto de Edge: iphone"
-
Oferta para usuarios de ipad:
- Nombre de la oferta: Contexto de Edge - Contenido de la oferta de iPad
- Regla asociada: "Regla de contexto de Edge - ipad"
Además, cree una oferta de reserva (aquí "Contenido de reserva de contexto") para que se muestre si no se cumplen criterios específicos de dispositivo.
Agregar ofertas en una colección
Añada las ofertas creadas anteriormente a una colección estática llamada aquí "Edge Device Context". Esta colección es donde la decisión de oferta elegirá las ofertas elegibles para presentarlas a los clientes.
Crear decisión de oferta
Cree una nueva decisión que aproveche el motor de decisión de ofertas para elegir la mejor oferta que se presentará a los usuarios según su tipo de dispositivo con la oferta de "reserva de contexto" seleccionada como oferta de reserva.
NOTEPaso de datos de contexto en la solicitud de Edge Decisioning
Punto de conexión
En el extremo, use el identificador de secuencia de datos creada anteriormente.
https://edge.adobedc.net/ee/irl1/v1/interact?configId=f3c47f2a-c484-4908-87a5-a82b55039e22
Carga útil
Este es un ejemplo de una solicitud que pasa datos de contexto.
-
Se pasa información sobre el tipo de dispositivo en el nodo
xdm:ContextData. -
En el nodo
decisionScopes, copie y pegue el ámbito de decisión de la decisión de oferta configurada anteriormente.Dónde recuperar el ámbito de decisión
{
"events": [{
"xdm": {
"identityMap": {
"customerId": [{
"id": "0000158216",
"authenticatedState": "authenticated",
"primary": true
}]
},
"_experienceplatform": {
"identity": {
"core": {
"customerId": "0000158216"
}
},
"offerContextData" : {
"language" : "NL",
"deviceType" : "iphone"
}
}
}
}],
"query": {
"personalization": {
"decisionScopes": ["eyJ4ZG06YWN0aXZpdHlJZCI6Inhjb3JlOm9mZmVyLWFjdGl2aXR5OjE3M2I1MGM5Mjg0ZGQ4NzkiLCJ4ZG06cGxhY2VtZW50SWQiOiJ4Y29yZTpvZmZlci1wbGFjZW1lbnQ6MTZhMzQxZWQ4ZDYyMzc2MSJ9"]
}
}
}
Respuesta
Este es un ejemplo de respuesta:
{
"requestId": "14a2d3f5-a6fa-494e-b42c-cc65a845284a",
"handle": [
{
"payload": [
{
"id": "1eafc831-4819-4800-8e25-c9e9f0838e09",
"scope": "eyJ4ZG06YWN0aXZpdHlJZCI6Inhjb3JlOm9mZmVyLWFjdGl2aXR5OjE3M2I1MGM5Mjg0ZGQ4NzkiLCJ4ZG06cGxhY2VtZW50SWQiOiJ4Y29yZTpvZmZlci1wbGFjZW1lbnQ6MTZhMzQxZWQ4ZDYyMzc2MSJ9",
"activity": {
"id": "xcore:offer-activity:173b50c9284dd879",
"etag": "1",
"name": "Edge Device Context"
},
"placement": {
"id": "xcore:offer-placement:16a341ed8d623761",
"etag": "1",
"name": "HIB",
"channel": "https://ns.adobe.com/xdm/channel-types/mobile",
"componentType": "https://ns.adobe.com/experience/offer-management/content-component-json"
},
"items": [
{
"id": "xcore:personalized-offer:173b4e05676d87f5",
"etag": "3",
"name": "Edge Context - iPhone Offer",
"priority": 0,
"schema": "https://ns.adobe.com/experience/offer-management/content-component-json",
"data": {
"id": "xcore:personalized-offer:173b4e05676d87f5",
"format": "application/json",
"language": [
"en-gb"
],
"content": "{\n \"name\" : \"iphone offer\"\n}"
}
}
]
}
],
"type": "personalization:decisions",
"eventIndex": 0
},
{
"payload": [],
"type": "activation:pull",
"eventIndex": 0
},
{
"payload": [],
"type": "personalization:decisions",
"eventIndex": 0
},
{
"payload": [
{
"scope": "Target",
"hint": "37",
"ttlSeconds": 1800
},
{
"scope": "AAM",
"hint": "6",
"ttlSeconds": 1800
},
{
"scope": "EdgeNetwork",
"hint": "irl1",
"ttlSeconds": 1800
}
],
"type": "locationHint:result"
},
{
"payload": [
{
"key": "kndctr_907075E95BF479EC0A495C73_AdobeOrg_identity",
"value": "CiY0MDAwMDgyMjMzNTEzNzU1OTcwMjQ0NDcyNjU1MTAyMDEwNDQ3MVIRCNnE4Y6QMRABGAEqBElSTDHwAdnE4Y6QMQ==",
"maxAge": 34128000
},
{
"key": "kndctr_907075E95BF479EC0A495C73_AdobeOrg_cluster",
"value": "irl1",
"maxAge": 1800
}
],
"type": "state:store"
}
]
}