DocumentationExperience PlatformBalises

Types d’actions

Last update: Wed Aug 07 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur

Après avoir configuré l’ extension de balise du SDK Web Adobe Experience Platform, vous devez configurer vos types d’actions.

Cette page décrit les types d’actions pris en charge par l’ extension de balise SDK Web Adobe Experience Platform.

Appliquer les propositions apply-propositions

Le type d’action Appliquer les propositions vous permet de générer des propositions dans des applications d’une seule page sans incrémenter de mesures.

Ce type d’action est utile lorsque vous utilisez des applications d’une seule page dans lesquelles des parties de la page sont régénérées, ce qui peut remplacer toute personnalisation déjà appliquée à la page.

Vous pouvez utiliser ce type d’action pour divers cas d’utilisation, tels que :

  1. Rendre les offres d’HTML de mbox. Les propositions explicitement demandées via une portée ou une surface à partir d’une action Envoyer l’événement ne sont pas automatiquement rendues. Vous pouvez utiliser le type d’action Appliquer les propositions pour indiquer au SDK Web où les rendre en spécifiant les métadonnées de proposition.
  2. Effectuez le rendu des offres pour une vue sur une application d’une seule page. Lors du rendu d’un événement view change, si les données d’analyse ne sont pas encore prêtes, vous pouvez utiliser l’action Appliquer les propositions pour effectuer le rendu des propositions d’affichage en haut de la page. Pour plus d’informations, voir top and bottom of page events (deuxième page vue - Option 2) . Pour l’utiliser, saisissez un nom d’affichage dans le formulaire.
  3. Renouveler les propositions. Lorsque votre site utilise une structure telle que React pour effectuer le rendu du contenu, vous devrez peut-être réappliquer la personnalisation. Dans ce cas, vous pouvez utiliser le type d’action Appliquer les propositions pour effectuer cette opération.

Ce type d’action n’envoie pas d’événement d’affichage pour les propositions générées. Il effectue le suivi des propositions générées afin qu’elles puissent être incluses dans les appels Send event suivants.

L’interface utilisateur des balises de plateforme affiche le type d’action Appliquer les propositions.

Ce type d’action prend en charge les champs suivants :

  • Propositions : un tableau d’objets de proposition que vous souhaitez rendre à nouveau.

  • Nom de la vue : nom de la vue à afficher.

  • Métadonnées de proposition : objet qui détermine la manière dont les offres d’HTML peuvent être appliquées. Vous pouvez fournir ces informations par le biais du formulaire ou d’un élément de données. Il contient les propriétés suivantes :

    • Périmètre
    • Sélecteur
    • Type d’action

Appliquer la réponse apply-response

Utilisez le type d’action Appliquer la réponse lorsque vous souhaitez effectuer diverses actions en fonction d’une réponse de l’Edge Network. Ce type d’action est généralement utilisé dans les déploiements hybrides où le serveur effectue un appel initial vers l’Edge Network, puis ce type d’action prend la réponse de cet appel et initialise le SDK Web dans le navigateur.

L’utilisation de ce type d’action peut réduire les temps de chargement des clients pour les cas d’utilisation de personnalisation hybride.

Image de linterface utilisateur Experience Platform montrant le type daction Appliquer la réponse.

Ce type d’action prend en charge les options de configuration suivantes :

  • Instance : sélectionnez l’instance du SDK Web que vous utilisez.
  • En-têtes de réponse : sélectionnez l’élément de données qui renvoie un objet contenant les clés d’en-tête et les valeurs renvoyées par l’appel serveur Edge Network.
  • Corps de la réponse : sélectionnez l’élément de données qui renvoie l’objet contenant la charge utile JSON fournie par la réponse de l’Edge Network.
  • Rendre les décisions de personnalisation visuelle : activez cette option pour effectuer automatiquement le rendu du contenu de personnalisation fourni par l’Edge Network et pré-masquer le contenu pour empêcher le scintillement.

Évaluation des jeux de règles evaluate-rulesets

Ce type d’action déclenche manuellement l’évaluation de l’ensemble de règles. Les jeux de règles sont renvoyés par Adobe Journey Optimizer pour prendre en charge des fonctionnalités telles que les messages dans le navigateur.

Image de l’interface utilisateur de l’Experience Platform montrant le type d’action de réponse Évaluer les jeux de règles.

Ce type d’action prend en charge les options suivantes :

  • Rendre les décisions de personnalisation visuelle : activez cette option pour effectuer le rendu des décisions de personnalisation visuelle pour les éléments de l’ensemble de règles qui correspondent.
  • Contexte de décision : il s’agit d’un mappage clé-valeur utilisé lors de l’évaluation des jeux de règles Adobe Journey Optimizer pour la prise de décision sur l’appareil. Vous pouvez fournir le contexte de décision manuellement ou par le biais d’un élément de données.

Obtention du suivi de Media Analytics get-media-analytics-tracker

Cette action est utilisée pour obtenir l’API Media Analytics héritée. Lors de la configuration de l’action et qu’un nom d’objet est fourni, l’API Media Analytics héritée est exportée vers cet objet de fenêtre. Si aucun fichier n’est fourni, il sera exporté vers window.Media comme le fait la bibliothèque Media JS actuelle.

Image de l’interface utilisateur de la plateforme montrant le type d’action Get Media Analytics Tracker.

Redirection vers une identité redirect-with-identity

Utilisez ce type d’action pour partager les identités de la page active avec d’autres domaines. Cette action est conçue pour être utilisée avec un type d’événement click et une condition de comparaison de valeurs. Voir Ajout d’une identité à une URL à l’aide de l’extension SDK Web pour plus d’informations sur l’utilisation de ce type d’action.

Envoyer un événement send-event

Envoie un événement à Experience Platform afin que Platform puisse collecter les données que vous envoyez et agir sur la base de ces informations. Toutes les données que vous souhaitez envoyer peuvent être envoyées dans le champ XDM Data. Utilisez un objet JSON conforme à la structure de votre schéma XDM. Cet objet peut être créé sur votre page ou par l’intermédiaire d’un ​ ​ élément de données.

Le type d’action Envoyer l’événement prend en charge les champs et paramètres décrits ci-dessous. Ces champs sont tous facultatifs.

Paramètres des instances instance

Utilisez le sélecteur Instance pour choisir l’instance de SDK Web que vous souhaitez configurer. Si vous n’avez qu’une seule instance, elle est présélectionnée.

Image de l’interface utilisateur des balises de plateforme montrant les paramètres de l’instance pour le type d’action Envoyer l’événement.

  • Instance : sélectionnez l’instance du SDK Web que vous souhaitez configurer. Si vous n’avez qu’une seule instance, elle sera présélectionnée.

  • Utiliser des événements guidés : activez cette option pour renseigner ou masquer automatiquement certains champs afin d’activer un cas d’utilisation spécifique. L’activation de cette option déclenche l’affichage des paramètres suivants.

    • Demander la personnalisation : cet événement est conçu pour être appelé en haut de la page. Lorsqu’il est sélectionné, cet événement définit les champs suivants :

      • Type : Récupération de proposition de prise de décision
      • Envoyer automatiquement un événement d’affichage : false
      • Pour effectuer automatiquement le rendu de la personnalisation dans ce cas, activez l’option Render Visual personalization Decisions (Rendre les décisions de personnalisation visuelle).

    • Collect analytics : cet événement est conçu pour être appelé au bas de la page. Lorsqu’il est sélectionné, cet événement définit les champs suivants :

      • Inclure les propositions rendues : true
      • Les paramètres Personalization sont masqués
    note note
    NOTE
    Les événements guidés sont liés aux événements de haut et de bas de page.

Données data

Image de l’interface utilisateur des balises de plateforme montrant les paramètres de l’élément de données pour le type d’action Envoyer l’événement.

  • Type : ce champ vous permet de spécifier un type d’événement qui sera enregistré dans votre schéma XDM. Voir type dans la commande sendEvent pour plus d’informations.
  • XDM :
  • Data : utilisez ce champ pour envoyer des données qui ne correspondent pas à un schéma XDM. Ce champ est utile si vous essayez de mettre à jour un profil Adobe Target ou d’envoyer des attributs Recommendations Target. Voir data dans la commande sendEvent pour plus d’informations.
  • Inclure les propositions rendues : activez cette option pour inclure toutes les propositions qui ont été rendues, mais aucun événement d’affichage n’a été envoyé. Utilisez-le en tandem avec Envoi automatique d’un événement d’affichage désactivé. Ce paramètre met à jour le champ XDM _experience.decisioning avec des informations sur les propositions générées.
  • Le document va se décharger : activez cette option pour vous assurer que les événements atteignent le serveur même si l’utilisateur quitte la page. Cela permet aux événements d’atteindre le serveur, mais les réponses sont ignorées.
  • ID de fusion : Ce champ est obsolète. Cela renseignera le champ XDM eventMergeId.

Personnalisation personalization

Image de l’interface utilisateur des balises de plateforme montrant les paramètres Personalization pour le type d’action Envoyer l’événement.

  • Portées : sélectionnez les portées (Adobe Target mboxes) que vous souhaitez demander explicitement à la personnalisation. Vous pouvez saisir les portées manuellement ou en fournissant un élément de données.

  • Surfaces : définissez les surfaces web disponibles sur la page pour la personnalisation. Pour plus d’informations, consultez la documentation Adobe Journey Optimizer .

  • Rendre les décisions de personnalisation visuelle : Si vous souhaitez effectuer le rendu du contenu personnalisé sur votre page, cochez la case Render Visual personalization Decisions . Vous pouvez également spécifier des portées de décision et/ou des surfaces si nécessaire. Pour plus d’informations sur le rendu du contenu personnalisé, consultez la documentation de personnalisation .

  • Demander la personnalisation par défaut : utilisez cette section pour contrôler si la portée à l’échelle de la page (mbox globale) et la surface par défaut (surface web en fonction de l’URL actuelle) sont demandées. Par défaut, cette demande est automatiquement effectuée lors du premier appel sendEvent du chargement de la page. Vous pouvez choisir parmi les options suivantes :

    • Automatique : il s’agit du comportement par défaut. Ne demandez la personnalisation par défaut que si elle n’a pas encore été demandée. Cela correspond à requestDefaultPersonalization non défini dans la commande du SDK Web.
    • Activé : demandez explicitement la portée de la page et la surface par défaut. Cela met à jour le cache d’affichage SPA. Cela correspond à requestDefaultPersonalization défini sur true.
    • Désactivé : supprimez explicitement la demande pour la portée de la page et la surface par défaut. Cela correspond à requestDefaultPersonalization défini sur false.

  • Contexte de décision : il s’agit d’un mappage clé-valeur utilisé lors de l’évaluation des jeux de règles Adobe Journey Optimizer pour la prise de décision sur l’appareil. Vous pouvez fournir le contexte de décision manuellement ou par le biais d’un élément de données.

Remplacements de la configuration des flux de données datastream-overrides

Les remplacements de trains de données vous permettent de définir des configurations supplémentaires pour vos trains de données, qui sont transmises au réseau Edge via le SDK Web.

Vous pouvez ainsi déclencher différents comportements de flux de données par rapport aux comportements par défaut, sans créer de flux de données ni modifier vos paramètres existants. Pour plus d’informations, consultez la documentation sur la configuration des remplacements de la banque de données .

Envoyer un événement multimédia send-media-event

Envoie un événement multimédia à Adobe Experience Platform et/ou Adobe Analytics. Cette action est utile lorsque vous effectuez le suivi des événements multimédia sur votre site web. Sélectionnez une instance (si vous en avez plusieurs). L’action nécessite un playerId qui représente un identifiant unique pour une session multimédia trackée. Elle nécessite également une qualité de l’expérience et un élément de données playhead lors du démarrage d’une session multimédia.

Image de l’interface utilisateur de la plateforme montrant l’écran d’événement de média envoyé.

Le type d’action Envoyer un événement multimédia prend en charge les propriétés suivantes :

  • Instance : instance du SDK Web utilisée.
  • Type d’événement multimédia : type de l’événement multimédia suivi.
  • ID du lecteur : identifiant unique de la session multimédia.
  • Curseur de lecture : position actuelle de la lecture du média, en secondes.
  • Détails de la session multimédia : lors de l’envoi d’un événement de démarrage du média, les détails requis de la session multimédia doivent être spécifiés.
  • Détails du chapitre : dans cette section, vous pouvez spécifier les détails du chapitre lors de l’envoi d’un événement multimédia de début de chapitre.
  • Détails Advertising : lors de l’envoi d’un événement AdBreakStart, vous devez spécifier les détails publicitaires requis.
  • Détails de la capsule Advertising : détails de la capsule publicitaire lors de l’envoi d’un événement AdStart.
  • Détails de l’erreur : détails sur l’erreur de lecture qui est suivie.
  • Détails de mise à jour de l’état : état du lecteur mis à jour.
  • Métadonnées personnalisées : métadonnées personnalisées de l’événement multimédia en cours de suivi.
  • Qualité de l’expérience : qualité multimédia des données d’expérience suivies.

Une fois que vous avez reçu le consentement de votre utilisateur, ce consentement doit être communiqué au SDK Web de Adobe Experience Platform à l’aide du type d’action "Définir le consentement". Actuellement, deux types de standards sont pris en charge : « Adobe » et « IAB TCF ». Voir Prise en charge des préférences de consentement du client. Lors de l’utilisation d’Adobe version 2.0, seule une valeur d’élément de données est prise en charge. Vous devez créer un élément de données qui résout l’objet de consentement.

Dans cette action, vous recevez également un champ facultatif pour inclure une carte des identités afin que les identités puissent être synchronisées une fois le consentement reçu. La synchronisation est utile lorsque le consentement est configuré comme "En attente" ou "Sortie", car l’appel de consentement est probablement le premier appel à se déclencher.

Mettre à jour la variable update-variable

Utilisez cette action pour modifier un objet XDM suite à un événement. Cette action est destinée à créer un objet qui peut être référencé ultérieurement à partir d’une action Envoyer l’événement, pour enregistrer l’objet XDM d’événement.

Pour utiliser ce type d’action, vous devez avoir défini un élément de données variable . Une fois que vous avez choisi un élément de données de variable à modifier, un éditeur s’affiche, semblable à l’éditeur de l’élément de données objet XDM .

Le schéma XDM utilisé pour l’éditeur est le schéma sélectionné sur l’élément de données variable . Vous pouvez définir une ou plusieurs propriétés de l’objet en cliquant sur l’une des propriétés de l’arborescence à gauche, puis en modifiant la valeur à droite. Par exemple, dans la capture d’écran ci-dessous, la propriété producBy est définie sur l’élément de données "Produit par l’élément de données".

Il existe des différences entre l’éditeur dans l’action de mise à jour de variable et l’éditeur dans l’élément de données de l’objet XDM. Tout d’abord, l’action de mise à jour de variable comporte un élément de niveau racine intitulé "xdm". Si vous cliquez sur cet élément, vous pouvez spécifier un élément de données à utiliser pour définir l’objet entier. Deuxièmement, l’action de mise à jour de variable comporte des cases à cocher pour effacer les données de l’objet xdm. Cliquez sur l’une des propriétés à gauche, puis cochez la case à droite pour effacer la valeur. Cela permet d’effacer la valeur actuelle avant de définir des valeurs sur la variable.

Étapes suivantes next-steps

Après avoir lu cet article, vous devriez mieux comprendre comment configurer vos actions. Ensuite, découvrez comment configurer vos types d’éléments de données.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743