Auf dieser Seite werden xdm in der sendEvent-Methode von Server SDK beschrieben. Informationen zu Web SDK finden Sie unter xdm.
Das xdm-Objekt enthält die Daten, die Sie an Adobe senden, in einer Struktur, die Ihrem Experience-Datenmodell (XDM)- entspricht. Felder, die Sie in diesem Objekt festlegen, werden direkt Feldern im Schema des Datensatzes zugeordnet, an den Ihr Datenstrom Daten sendet.
Stellen Sie sicher, dass die Hierarchie in diesem Objekt mit dem Schema für den konfigurierten Datensatz übereinstimmt. Sie können sowohl das xdm als auch das data in denselben sendEvent-Aufruf einbeziehen.
Im folgenden Beispiel wird die Schemafeldgruppe Commerce-Details verwendet:
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" }
]
}
});
Primäre Identität einschließen primary-identity
Jedes Ereignis, das der SDK-Server sendet, muss eine primäre Identität in xdm.identityMap enthalten. In einem Browser kann die Edge Network den Besucher über ihre Cookies identifizieren. Bei einer Server-zu-Server-Anfrage benötigt sie eine Identität im Ereignis selbst. Wenn keine Identität im Ereignis als primär markiert ist, lehnt der Edge Network das Ereignis mit dem Fehlercode EXEG-0306-400 ab, und sendEvent lehnt ab.
Legen Sie primary: true auf genau eine Identität fest:
xdm: {
identityMap: {
Email: [
{ id: "visitor@example.com", primary: true }
],
CRMID: [
{ id: "1234567" }
]
}
}
Jeder Schlüssel in identityMap ist ein Identity-Namespace der in Ihrer Organisation definiert ist, und jeder Wert ist ein Array von Identitäten in diesem Namespace. Siehe Verwenden von identityMap für weitere Informationen.
Daten, die SDK hinzufügt automatic
Die SDK fügt jedem Ereignis xdm.implementationDetails hinzu und kann xdm.web.webPageDetails.URL aus der Referer-Kopfzeile der Anfrage hinzufügen. Wenn Sie auch xdm.web.webPageDetails.URL festlegen, wird Ihr -Wert verwendet. Siehe Kontext und weitergeleitete Kopfzeilen.
Wenn Sie sowohl xdm.eventType als auch die Option type festlegen, wird der Wert in xdm.eventType verwendet.