Questa pagina descrive xdm nel metodo Server SDK sendEvent. Per il Web SDK, vedere xdm.
L’oggetto xdm contiene i dati inviati ad Adobe in una struttura corrispondente allo schema Experience Data Model (XDM). I campi impostati in questo oggetto vengono mappati direttamente ai campi nello schema del set di dati a cui il flusso di dati invia i dati.
Assicurati che la gerarchia in questo oggetto corrisponda allo schema per il set di dati configurato. È possibile includere sia l’oggetto xdm che l’oggetto data nella stessa chiamata sendEvent.
Nell’esempio seguente viene utilizzato il gruppo di campi dello schema Dettagli Commerce:
await visitor.sendEvent({
xdm: {
eventType: "commerce.productViews",
identityMap: {
Email: [{ id: "visitor@example.com", primary: true }]
},
commerce: {
productViews: { value: 1 }
},
productListItems: [
{ SKU: "HT105", name: "Large field hat" },
{ SKU: "HT104", name: "Small field hat" }
]
}
});
Includi un’identità primaria primary-identity
Ogni evento inviato da Server SDK deve includere un’identità primaria in xdm.identityMap. In un browser, Edge Network può identificare il visitatore dai suoi cookie. In una richiesta da server a server, è necessaria un’identità nell’evento stesso. Se nessuna identità nell’evento è contrassegnata come primaria, Edge Network rifiuta l’evento con il codice di errore EXEG-0306-400 e sendEvent rifiuta.
Imposta primary: true esattamente su un’identità:
xdm: {
identityMap: {
Email: [
{ id: "visitor@example.com", primary: true }
],
CRMID: [
{ id: "1234567" }
]
}
}
Ogni chiave in identityMap è uno spazio dei nomi identity definito nell’organizzazione e ogni valore è un array di identità in tale spazio dei nomi. Per ulteriori informazioni, vedere Utilizzo di identityMap.
Dati aggiunti da SDK automatic
SDK aggiunge xdm.implementationDetails a ogni evento e può aggiungere xdm.web.webPageDetails.URL dall’intestazione Referer della richiesta. Se imposti anche xdm.web.webPageDetails.URL, verrà utilizzato il tuo valore. Vedi Intestazioni contestuali e inoltrate.
Se si impostano sia xdm.eventType che l’opzione type, verrà utilizzato il valore in xdm.eventType.