Documentation Experience Platform Guide de modèle de données d’expérience (XDM)

Classe XDM ExperienceEvent

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Créé pour :

Développeur

XDM ExperienceEvent est une classe XDM (Experience Data Model) standard. Utilisez cette classe pour créer un instantané horodaté du système lorsqu’un événement spécifique se produit ou qu’un certain ensemble de conditions a été atteint.

Un événement dʼexpérience est un enregistrement factuel de ce qui s’est passé, y compris le moment et l’identité de la personne impliquée. Les événements peuvent être explicites (actions humaines directement observables) ou implicites (obtenus sans action humaine directe) et sont enregistrés sans agrégation ni interprétation. Pour plus d’informations détaillées sur l’utilisation de cette classe dans l’écosystème Platform, consultez la section Présentation du système XDM.

La classe XDM ExperienceEvent elle-même fournit plusieurs champs temporels à un schéma. Deux de ces champs (_id et timestamp) sont obligatoires pour tous les schémas basés sur cette classe, tandis que les autres sont facultatifs. Les valeurs de certains champs sont automatiquement renseignées lors de l’ingestion des données.

Structure de XDM ExperienceEvent telle qu’elle apparaît dans l’interface utilisateur de Platform.

Propriété

Description

_id
(Obligatoire)

Le champ Classe d’événements d’expérience _id identifie de manière unique les événements individuels ingérés dans Adobe Experience Platform. Ce champ permet de suivre l’unicité d’un événement individuel, d’éviter la duplication des données et de rechercher cet événement dans les services en aval.

Lorsque des événements en double sont détectés, les applications et services de Platform peuvent gérer la duplication différemment. Par exemple, les événements en double dans le service de profil sont ignorés si l’événement ayant le même _id existe déjà dans la banque de profils.

Dans certains cas, _id peut être un identifiant unique universel (UUID) ou un identifiant unique global (GUID).

Si vous diffusez des données depuis une connexion source ou que vous ingérez directement depuis un fichier Parquet, vous devez générer cette valeur en concaténant une certaine combinaison de champs qui rendent l’événement unique. Parmi les exemples d’événements pouvant être concaténés, citons l’ID principal, l’horodatage, le type d’événement, etc. La valeur concaténée doit être une chaîne formatée uri-reference, ce qui signifie que tout caractère deux-points doit être supprimé. La valeur concaténée doit ensuite être hachée à l’aide de lʼalgorithme SHA-256 ou d’un autre de votre choix.

Il est important de distinguer que ce champ ne représente pas une identité liée à une personne individuelle, mais plutôt lʼenregistrement de données lui-même. Les données d’identité relatives à une personne doivent plutôt être reléguées dans des champs d’identité fournis par des groupes de champs compatibles.

eventMergeId

Si vous utilisez le SDK web Adobe Experience Platform pour lʼingestion des données, cela représente l’identifiant du lot ingéré à l’origine de la création de l’enregistrement. Ce champ est automatiquement renseigné par le système lors de l’ingestion des données. L’utilisation de ce champ en dehors du cadre d’une implémentation du SDK web n’est pas prise en charge.

eventType

Chaîne indiquant le type ou la catégorie de l’événement. Ce champ peut être utilisé pour distinguer différents types d’événements au sein dʼun même schéma et dʼun même jeu de données. Par exemple, pour une société active dans la vente au détail, vous pouvez souhaiter distinguer un événement de consultation de produit d’un événement dʼajout au panier.

Les valeurs standard de cette propriété sont fournies dans la section annexe, y compris des descriptions de leur cas d’utilisation prévu. Ce champ est une énumération extensible, ce qui signifie que vous pouvez également utiliser vos propres chaînes de type d’événement pour classer les événements dont vous effectuez le suivi.La propriété

eventType vous limite à l’utilisation d’un seul événement par accès sur votre application. Par conséquent, vous devez utiliser des champs calculés pour indiquer au système quel événement est le plus important. Pour plus d’informations, consultez la section dédiée aux bonnes pratiques relatives aux champs calculés.

producedBy

Valeur de chaîne qui décrit le déclencheur ou l’origine de l’événement. Ce champ peut être utilisé, si nécessaire, pour filtrer certains déclencheurs d’événements à des fins de segmentation.

Certaines valeurs suggérées pour cette propriété sont indiquées dans la section annexe. Ce champ est une énumération extensible, ce qui signifie que vous pouvez également utiliser vos propres chaînes pour représenter différents déclencheurs d’événements.

identityMap

Champ de mappage contenant un jeu d’identités d’espace de noms pour l’individu auquel l’événement s’applique. Ce champ est automatiquement mis à jour par le système lors de l’ingestion des données d’identité. Pour utiliser correctement ce champ pour Real-time Customer Profile, ne tentez pas de mettre à jour manuellement le contenu du champ dans vos opérations de données.

Pour plus d’informations sur les cas d’utilisation des mappages dʼidentités, consultez la section correspondante sur la page consacrée aux principes de base de la composition des schémas.

timestamp
(Obligatoire)

Horodatage ISO 8601 du moment où l’événement s’est produit, formaté selon la norme RFC 3339 (section 5.6). Cet horodatage must se produit par le passé, mais must a lieu à partir de 1970. Pour connaître les bonnes pratiques relatives à l’utilisation de ce champ, consultez la section ci-dessous relative aux horodatages.

Bonnes pratiques relatives à la modélisation des événements

Les sections suivantes décrivent les bonnes pratiques pour la conception de vos schémas XDM (Modèle de données d’expérience) basés sur des événements dans Adobe Experience Platform.

Horodatages timestamps

Le champ racine timestamp d’un schéma d’événement peut uniquement représenter l’observation de l’événement lui-même et doit se produire dans le passé. Cependant, l'événement must a lieu à partir de 1970. Si vos cas d’utilisation de segmentation nécessitent l’utilisation d’horodatages qui peuvent se produire dans le futur, ces valeurs doivent être inscrites ailleurs dans votre schéma d’événement d’expérience.

Par exemple, si une entreprise active dans le secteur du voyage et de l’hôtellerie modélise un événement de réservation de vol, le champ timestamp au niveau de la classe représente lʼheure à laquelle l’événement de réservation a été observé. D’autres horodatages liés à l’événement, tels que la date de début de la réservation de voyage, doivent être capturés dans des champs distincts fournis par des groupes de champs standard ou personnalisés.

Exemple de schéma dévénement dexpérience avec réservation de vol et date de début en surbrillance.

En séparant l’horodatage au niveau de la classe des autres valeurs datetime associées dans vos schémas d’événement, vous pouvez implémenter des cas d’utilisation de segmentation flexibles tout en conservant un compte horodaté des parcours client dans votre application d’expérience.

Utiliser des champs calculés calculated

Certaines interactions dans vos applications d’expérience peuvent entraîner plusieurs événements associés partageant techniquement le même horodatage d’événement et pouvant donc être représentés comme un seul enregistrement d’événement. Si, par exemple, un client consulte un produit sur votre site web, un enregistrement d’événement comportant deux valeurs eventType potentielles peut être généré : un événement « vue du produit » (commerce.productViews) ou un événement générique « page vue » (web.webpagedetails.pageViews). Dans ces cas, vous pouvez utiliser des champs calculés pour capturer les attributs les plus importants lors d’une capture de plusieurs événements dans un seul accès.

Utilisez Adobe Experience Platform Data Prep pour mapper, transformer et valider des données vers et depuis XDM. En utilisant les fonctions de mappage fournies par le service, vous pouvez appeler des opérateurs logiques pour prioriser, transformer et/ou consolider des données provenant d’enregistrements multi-événements lors de leur ingestion dans Experience Platform. Dans l’exemple ci-dessus, vous pouvez désigner eventType comme champ calculé qui donne la priorité à une « vue du produit » plutôt qu’à une « vue de page » lorsquʼelles se produisent toutes les deux.

Si vous ingérez manuellement des données dans Platform via l’interface utilisateur, consultez le guide sur les champs calculés pour obtenir des instructions spécifiques sur la création de champs calculés.

Si vous diffusez des données en continu vers Platform à l’aide d’une connexion source, vous pouvez configurer la source pour qu’elle utilise à la place des champs calculés. Consultez la documentation de votre source spécifique pour obtenir des instructions sur lʼimplémentation de champs calculés lors de la configuration de la connexion.

Groupes de champs de schéma compatibles field-groups

NOTE

Les noms de plusieurs groupes de champs ont changé. Pour plus d’informations, consultez le document sur les mises à jour des noms de groupes de champs.

Adobe fournit plusieurs groupes de champs standard à utiliser avec la classe XDM ExperienceEvent. Voici une liste de groupes de champs couramment utilisés pour la classe :

Annexe

La section suivante contient des informations supplémentaires sur la classe XDM ExperienceEvent.

Valeurs acceptées pour `eventType` eventType

Le tableau suivant décrit les valeurs acceptées pour eventType, ainsi que leurs définitions :

Valeur

Définition

advertising.clicks

Cet événement suit le moment où une action de sélection d’une publicité se produit.

advertising.completes

Cet événement effectue le suivi lorsqu’une ressource multimédia minutée a été visionnée jusqu’à la fin. Cela ne signifie pas nécessairement que le spectateur a visionné toute la vidéo, car il aurait pu sauter devant.

advertising.conversions

Cet événement effectue le suivi d’une action prédéfinie effectuée par un client qui déclenche un événement pour l’évaluation des performances.

advertising.federated

Cet événement effectue le suivi de la création ou non d’un événement d’expérience par le biais d’une fédération de données (partage de données entre clients).

advertising.firstQuartiles

Cet événement effectue le suivi lorsqu’une publicité vidéo numérique a été lue pendant 25 % de sa durée à une vitesse normale.

advertising.impressions

Cet événement suit les impressions d’une publicité destinée à un client ayant le potentiel d’être visionné.

advertising.midpoints

Cet événement effectue le suivi lorsqu’une publicité vidéo numérique a été lue pendant 50 % de sa durée à une vitesse normale.

advertising.starts

Cet événement effectue le suivi du début de la lecture d’une publicité vidéo numérique.

advertising.thirdQuartiles

Cet événement effectue le suivi lorsqu’une publicité vidéo numérique a été lue pendant 75 % de sa durée à une vitesse normale.

advertising.timePlayed

Cet événement effectue le suivi de la durée passée par un utilisateur sur une ressource multimédia minutée spécifique.

application.close

Cet événement suit le moment où une application a été fermée ou envoyée en arrière-plan.

application.launch

Cet événement suit le moment où une application a été lancée ou mise en premier plan.

commerce.backofficeCreditMemoIssued

Cet événement suit lorsqu’un avis de crédit a été émis à un client.

commerce.backofficeOrderCancelled

Cet événement effectue le suivi lorsqu’un processus d’achat initié précédemment a été arrêté avant la fin.

commerce.backofficeOrderItemsShipped

Cet événement suit le moment où les articles achetés ont été physiquement envoyés au client.

commerce.backofficeOrderPlaced

Cet événement suit le placement d’une commande.

commerce.backofficeShipmentCompleted

Cet événement effectue le suivi de la réussite de l’ensemble du processus d’expédition.

commerce.checkouts

Cet événement effectue le suivi lorsqu’un événement de passage en caisse s’est produit pour une liste de produits. Il peut y avoir plusieurs événements de passage en caisse s’il existe plusieurs étapes dans un processus de passage en caisse. S’il y a plusieurs étapes, l’horodatage et la page/expérience référencée pour chaque événement sont utilisés pour identifier chaque événement individuel (étape), représenté dans l’ordre.

commerce.productListAdds

Cet événement effectue le suivi lorsqu’un produit a été ajouté à la liste de produits ou au panier.

commerce.productListOpens

Cet événement suit lorsqu’une nouvelle liste de produits (panier) a été initialisée ou créée.

commerce.productListRemovals

Cet événement suit lorsqu’une entrée de produit a été supprimée d’une liste de produits ou d’un panier.

commerce.productListReopens

Cet événement suit lorsqu’une liste de produits (panier) qui n’était plus accessible (abandonnée) a été réactivée par un client, par exemple par le biais d’une activité de remarketing.

commerce.productListViews

Cet événement suit lorsqu’une liste de produits ou un panier a reçu une consultation.

commerce.productViews

Cet événement effectue le suivi lorsqu’un produit a reçu une ou plusieurs consultations.

commerce.purchases

Cet événement effectue le suivi lorsqu’une commande a été acceptée. Il s’agit de la seule action requise lors dʼune conversion commerciale. Un événement d’achat doit avoir une liste de produits référencée.

commerce.saveForLaters

Cet événement effectue le suivi lorsqu’une liste de produits a été enregistrée pour une utilisation ultérieure, telle qu’une liste de souhaits de produits.

decisioning.propositionDisplay

Cet événement suit le moment où une proposition de prise de décision a été affichée pour une personne.

decisioning.propositionDismiss

Cet événement suit lorsqu’une décision a été prise de ne pas interagir avec l’offre présentée.

decisioning.propositionInteract

Cet événement suit le moment où une personne a interagi avec une proposition de prise de décision.

decisioning.propositionSend

Cet événement suit le moment où il a été décidé d’envoyer à un client potentiel une recommandation ou une offre à prendre en compte.

decisioning.propositionTrigger

Cet événement suit l'activation d'un processus de proposition. Une certaine condition ou action s’est produite pour inviter la présentation d’une offre.

delivery.feedback

Cet événement effectue le suivi des événements de retour pour une diffusion, tels qu’une diffusion par email.

directMarketing.emailBounced

Cet événement suit le moment où un message électronique à une personne a fait l’objet d’un rebond.

directMarketing.emailBouncedSoft

Cet événement suit le moment où un email à une personne rebondit doucement.

directMarketing.emailClicked

Cet événement suit le moment où une personne a cliqué sur un lien dans un courrier électronique marketing.

directMarketing.emailDelivered

Cet événement suit le moment où un message électronique a été correctement envoyé au service de messagerie d’une personne.

directMarketing.emailOpened

Cet événement est suivi lorsqu’une personne a ouvert un courrier électronique marketing.

directMarketing.emailSent

Cet événement suit le moment où un email marketing a été envoyé à une personne.

directMarketing.emailUnsubscribed

Cet événement suit lorsqu’une personne se désabonne d’un email marketing.

inappmessageTracking.dismiss

Cet événement suit le rejet d’un message in-app.

inappmessageTracking.display

Cet événement effectue le suivi de l’affichage d’un message in-app.

inappmessageTracking.interact

Cet événement suit le moment où un message in-app a été interagi avec .

leadOperation.callWebhook

Cet événement suit le moment où un webhook a été appelé en réponse à une piste.

leadOperation.changeCampaignStream

Cet événement signifie un changement dans la stratégie de marketing ou d’engagement pour un prospect particulier.

leadOperation.changeEngagementCampaignCadence

Cet événement effectue le suivi lorsqu’un prospect a été modifié dans le cadre d’une campagne.

leadOperation.convertLead

Cet événement effectue le suivi lorsqu’une piste a été convertie.

leadOperation.interestingMoment

Cet événement suit quand un moment intéressant a été enregistré pour une personne.

leadOperation.mergeLeads

Cet événement suit le moment où les informations provenant de plusieurs pistes qui font référence à la même entité ont été consolidées.

leadOperation.newLead

Cet événement effectue le suivi de la création d’une piste.

leadOperation.scoreChanged

Cet événement suit le moment où la valeur de l’attribut de score du prospect a été modifiée.

leadOperation.statusInCampaignProgressionChanged

Cet événement suit le moment où l’état d’une piste dans une campagne a changé.

listOperation.addToList

Cet événement suit le moment où une personne a été ajoutée à une liste marketing.

listOperation.removeFromList

Cet événement suit le moment où une personne a été supprimée d’une liste marketing.

media.adBreakComplete

Cet événement effectue le suivi lorsqu’un événement adBreakComplete s’est produit. Cet événement est déclenché au début d’une coupure publicitaire.

media.adBreakStart

Cet événement effectue le suivi lorsqu’un événement adBreakStart s’est produit. Cet événement est déclenché à la fin d’une coupure publicitaire.

media.adComplete

Cet événement effectue le suivi lorsqu’un événement adComplete s’est produit. Cet événement est déclenché lorsqu’une publicité est terminée.

media.adSkip

Cet événement effectue le suivi lorsqu’un événement adSkip s’est produit. Cet événement est déclenché lorsqu’une publicité a été sautée.

media.adStart

Cet événement effectue le suivi lorsqu’un événement adStart s’est produit. Cet événement est déclenché lorsqu’une publicité a commencé.

media.bitrateChange

Cet événement effectue le suivi lorsqu’un événement bitrateChange s’est produit. Cet événement est déclenché en cas de changement du débit binaire.

media.bufferStart

Cet événement effectue le suivi lorsqu’un événement bufferStart s’est produit. Cet événement est déclenché lorsque le média a commencé à mettre en mémoire tampon.

media.chapterComplete

Cet événement effectue le suivi lorsqu’un événement chapterComplete s’est produit. Cet événement est déclenché à la fin d’un chapitre dans le média.

media.chapterSkip

Cet événement effectue le suivi lorsqu’un événement chapterSkip s’est produit. Cet événement est déclenché lorsqu’un utilisateur passe d’une section ou d’un chapitre à l’autre dans le contenu multimédia.

media.chapterStart

Cet événement effectue le suivi lorsqu’un événement chapterStart s’est produit. Cet événement est déclenché au début d’une section ou d’un chapitre spécifique dans le contenu multimédia.

media.downloaded

Cet événement effectue le suivi lorsque le contenu téléchargé par le média s’est produit.

media.error

Cet événement effectue le suivi lorsqu’un événement error s’est produit. Cet événement est déclenché lorsqu’une erreur ou un problème se produit au cours de la lecture multimédia.

media.pauseStart

Cet événement effectue le suivi lorsqu’un événement pauseStart s’est produit. Cet événement est déclenché lorsqu’un utilisateur lance une pause dans la lecture multimédia.

media.ping

Cet événement effectue le suivi lorsqu’un événement ping s’est produit. Cela vérifie la disponibilité d’une ressource multimédia.

media.play

Cet événement effectue le suivi lorsqu’un événement play s’est produit. Cet événement est déclenché lorsque le contenu multimédia est en cours de lecture, indiquant une consommation active de l’utilisateur.

media.sessionComplete

Cet événement effectue le suivi lorsqu’un événement sessionComplete s’est produit. Cet événement marque la fin d’une session de lecture multimédia.

media.sessionEnd

Cet événement effectue le suivi lorsqu’un événement sessionEnd s’est produit. Cet événement indique la fin d’une session multimédia. Cette conclusion peut impliquer la fermeture du lecteur multimédia ou l’arrêt de la lecture.

media.sessionStart

Cet événement effectue le suivi lorsqu’un événement sessionStart s’est produit. Cet événement marque le début d’une session de lecture multimédia. Elle est déclenchée lorsqu’un utilisateur commence la lecture d’un fichier multimédia.

media.statesUpdate

Cet événement effectue le suivi lorsqu’un événement statesUpdate s’est produit. Les fonctionnalités de suivi de l’état du lecteur peuvent être associées à un flux audio ou vidéo. Les états standard sont les suivants : plein écran, mute, closedCaptioning, pictureInPicture et inFocus.

opportunityEvent.addToOpportunity

Cet événement suit le moment où une personne a été ajoutée à une opportunité.

opportunityEvent.opportunityUpdated

Cet événement suit le moment où une opportunité a été mise à jour.

opportunityEvent.removeFromOpportunity

Cet événement suit le moment où une personne a été supprimée d’une opportunité.

pushTracking.applicationOpened

Cet événement est suivi lorsqu’une personne a ouvert une application à partir d’une notification push.

pushTracking.customAction

Cet événement suit lorsqu’une personne a sélectionné une action personnalisée dans une notification push.

web.formFilledOut

Cet événement suit le moment où une personne remplit un formulaire sur une page web.

web.webinteraction.linkClicks

Cet événement effectue le suivi lorsqu’un lien a été sélectionné une ou plusieurs fois.

web.webpagedetails.pageViews

Cet événement effectue le suivi lorsqu’une page web a reçu une ou plusieurs vues.

location.entry

Cet événement effectue le suivi de l’entrée d’une personne ou d’un appareil à un emplacement spécifique.

location.exit

Cet événement effectue le suivi de la sortie d’une personne ou d’un appareil à partir d’un emplacement spécifique.

Valeurs suggérées pour `producedBy` producedBy

Le tableau suivant présente quelques-unes des valeurs acceptées pour producedBy :

Valeur

Définition

self

Self

system

Système

salesRef

Représentant commercial

customerRep

Représentant du client

recommendation-more-help

62e9ffd9-1c74-4cef-8f47-0d00af32fc07