[Legacy]{class="badge informative"}
Dati contestuali e richieste Edge Decisioning edge
Questa sezione ti guida attraverso il passaggio di dati contestuali nelle richieste di Edge Decisioning e il loro utilizzo nelle regole di idoneità. Esploreremo un caso d’uso end-to-end che illustra come distribuire offerte personalizzate in base al tipo di dispositivo utilizzato dai clienti.
Questo caso d’uso prevede diversi passaggi chiave:
- Configura prerequisiti: assicurati che siano stati completati tutti i passaggi necessari per trasmettere i dati contestuali nelle richieste.
- Utilizza i dati contestuali nelle regole di idoneità: crea regole che determinano quali offerte mostrare in base al tipo di dispositivo dell'utente.
- Progettare offerte specifiche per il dispositivo: crea offerte personalizzate per ogni tipo di dispositivo e collegale alle regole corrispondenti.
- Crea una raccolta di offerte: raggruppa tutte le offerte in una raccolta statica.
- Configura una decisione: crea una nuova decisione che sfrutta il motore delle decisioni per le offerte per scegliere l'offerta migliore da presentare agli utenti in base al tipo di dispositivo.
- Trasmettere i dati contestuali nella richiesta Edge Decisioning: trasmettere i dati contestuali tramite la richiesta API per recuperare e presentare le offerte appropriate agli utenti.
Per andare oltre, puoi anche sfruttare i dati contestuali nelle formule di classificazione o per personalizzare le rappresentazioni delle offerte in modo dinamico. Ad esempio, puoi creare una singola offerta e utilizzare i campi di personalizzazione per adattarne la rappresentazione in base ai dati contestuali. Ad esempio, puoi visualizzare una determinata immagine se l’utente dispone di un iPhone, e un’altra per gli utenti di iPad. Per ulteriori informazioni, consulta queste sezioni:
Prerequisiti per trasmettere i dati contestuali nelle richieste di Edge Decisioning prerequisites
A differenza del passaggio del contesto in un formato libero utilizzando l’API Decisioning, il contesto Edge Decisioning richiede la conformità XDM. Il payload di contesto deve essere conforme all’evento esperienza XDM. A questo scopo, il contesto deve essere definito come parte dell’evento "Esperienza XDM" utilizzato per la raccolta dati.
-
Definisci uno schema di evento esperienza. Ai fini di questo caso d’uso, viene creato uno schema "Contesto dell’offerta" e i campi del contesto dell’offerta fanno parte di un gruppo di campi "Contesto dell’offerta". In realtà, il gruppo di campi viene aggiunto allo schema evento esperienza utilizzato per la raccolta dati associata allo stream di dati "Edge Collection Network".
note note NOTE Lo schema evento esperienza contesto offerta deve far parte del profilo, con un campo "CUSTOMER_ID" utilizzato come identità primaria. In questo esempio, il gruppo di campi "Contesto offerta" ha due proprietà: language e deviceType. Queste proprietà verranno utilizzate nelle regole di classificazione e idoneità delle offerte.
Scopri come utilizzare gli schemi nella Adobe Experience Platform guida di Experience Data Model (XDM)
-
Crea un set di dati (qui "Contesto dell’offerta") e assicurati che sia abilitato per il profilo.
-
Crea un nuovo flusso di dati dal menu Raccolta dati > Flussi di dati. Scopri come creare e configurare lo stream di dati nella Adobe Experience Platform guida dello stream di dati
In questo caso, abbiamo creato un flusso di dati "Contesto offerta", con lo schema evento "Contenuto offerta" selezionato.
-
Modifica lo stream di dati appena creato e seleziona "Adobe Experience Platform" come servizio e "Contesto offerta" come set di dati dell’evento.
-
Salva lo stream di dati e copiane l’ID. Questo ID verrà utilizzato nell’endpoint di richiesta API. Scopri come generare la chiamata API
Utilizzare i dati contestuali nelle regole di idoneità rules
Crea regole di idoneità che determinano le offerte da mostrare in base al tipo di dispositivo dell’utente:
-
regola dispositivo iphone:
-
Nome regola: "Edge Context Rule - iphone"
-
Configurazione: deviceType = 'iphone'
-
Sintassi PQL:
code language-none select _Any1 from xEvent where _Any1._experienceplatform.offerContextData.deviceType.equals("iphone", false)
-
-
regola dispositivo ipad:
-
Nome regola: "Edge Context Rule - ipad"
-
Configurazione: deviceType = 'ipad'
-
Sintassi PQL
code language-none select _Any1 from xEvent where _Any1._experienceplatform.offerContextData.deviceType.equals("ipad", false)
-
Crea offerte offers
Crea un’offerta per ciascun tipo di dispositivo e collegala alla regola di idoneità corrispondente creata in precedenza:
-
Offerta per gli utenti di iPhone:
- Nome offerta: "Contesto Edge - Contenuto offerta iPhone"
- Regola associata: "Edge Context Rule - iphone"
-
Offerta per gli utenti di iPad:
- Nome offerta: "Contesto Edge - Contenuto offerta iPad"
- Regola associata: "Edge Context Rule - ipad"
Inoltre, crea un’offerta di fallback (qui "Contenuto di fallback contestuale") da visualizzare se non sono soddisfatti criteri specifici del dispositivo.
Aggiungere offerte in una raccolta collection
Aggiungi le offerte create in precedenza a una raccolta statica denominata qui "Edge Device Context". Questa raccolta sarà il luogo in cui la decisione di offerta selezionerà le offerte idonee da presentare ai clienti.
Crea decisione di offerta decision
Crea una nuova decisione che sfrutta il motore delle decisioni per le offerte per scegliere l’offerta migliore da presentare agli utenti in base al tipo di dispositivo con l’offerta "Context Fallback" selezionata come offerta di fallback.
Trasmettere i dati contestuali nella richiesta Edge Decisioning request
Endpoint
Nell'endpoint, utilizzare l'ID dello stream di dati creato in precedenza.
https://edge.adobedc.net/ee/irl1/v1/interact?configId=f3c47f2a-c484-4908-87a5-a82b55039e22
Payload
Di seguito è riportato un esempio di richiesta che trasmette dati contestuali.
-
Le informazioni sul tipo di dispositivo vengono passate nel nodo
xdm:ContextData. -
Nel nodo
decisionScopes, copia e incolla l'ambito di decisione della decisione di offerta configurata in precedenza.accordion Dove recuperare l’ambito della decisione 
{
"events": [{
"xdm": {
"identityMap": {
"customerId": [{
"id": "0000158216",
"authenticatedState": "authenticated",
"primary": true
}]
},
"_experienceplatform": {
"identity": {
"core": {
"customerId": "0000158216"
}
},
"offerContextData" : {
"language" : "NL",
"deviceType" : "iphone"
}
}
}
}],
"query": {
"personalization": {
"decisionScopes": ["eyJ4ZG06YWN0aXZpdHlJZCI6Inhjb3JlOm9mZmVyLWFjdGl2aXR5OjE3M2I1MGM5Mjg0ZGQ4NzkiLCJ4ZG06cGxhY2VtZW50SWQiOiJ4Y29yZTpvZmZlci1wbGFjZW1lbnQ6MTZhMzQxZWQ4ZDYyMzc2MSJ9"]
}
}
}
Risposta
Ecco un esempio di risposta:
{
"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"
}
]
}