Cette page décrit les xdm de la méthode sendEvent de Server SDK. Pour le Web SDK, voir xdm.
L’objet xdm contient les données que vous envoyez à Adobe dans une structure correspondant à votre schéma Modèle de données d’expérience (XDM). Les champs que vous définissez dans cet objet mappent directement aux champs du schéma du jeu de données auquel votre flux de données envoie des données.
Assurez-vous que la hiérarchie de cet objet correspond au schéma du jeu de données configuré. Vous pouvez inclure l’objet xdm et l’objet data dans le même appel sendEvent.
L’exemple suivant utilise le groupe de champs de schéma Détails de 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" }
]
}
});
Inclure une identité principale primary-identity
Chaque événement envoyé par le SDK du serveur doit inclure une identité principale dans xdm.identityMap. Dans un navigateur, Edge Network peut identifier le visiteur à partir de ses cookies. Sur une requête serveur à serveur, il a besoin d’une identité dans l’événement lui-même. Si aucune identité de l’événement n’est marquée comme principale, l’Edge Network rejette l’événement avec le code d’erreur EXEG-0306-400, et sendEvent rejette.
Définissez primary: true sur une seule identité :
xdm: {
identityMap: {
Email: [
{ id: "visitor@example.com", primary: true }
],
CRMID: [
{ id: "1234567" }
]
}
}
Chaque clé dans identityMap est un espace de noms d’identité défini dans votre organisation et chaque valeur est un tableau d’identités dans cet espace de noms. Voir Utilisation d’identityMap pour plus d’informations.
Données ajoutées par le SDK automatic
Le SDK ajoute des xdm.implementationDetails à chaque événement et peut ajouter des xdm.web.webPageDetails.URL à partir de l’en-tête Referer de la requête. Si vous définissez également xdm.web.webPageDetails.URL, votre valeur est utilisée. Voir En-têtes contextuels et transférés.
Si vous définissez à la fois xdm.eventType et l’option type , la valeur en xdm.eventType est utilisée.