Types d’actions
Après avoir configuré la variable Extension de balise SDK Web Adobe Experience Platform, vous devez configurer les types d’actions.
Cette page décrit les types d’actions pris en charge par le Extension de balise SDK Web Adobe Experience Platform.
Appliquer la réponse apply-response
Utilisez la variable Appliquer la réponse type d’action 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.
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 au 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 Edge Network.
- Rendu des 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.
Envoyer un événement send-event
Envoie un événement à Adobe Experience Platform afin que Adobe Experience Platform puisse collecter les données que vous envoyez et agir en fonction de ces informations. Sélectionnez une instance (si vous en avez plusieurs). Toutes les données que vous souhaitez envoyer peuvent être envoyées dans la variable Données XDM champ . Utilisez un objet JSON conforme à la structure de votre schéma XDM. Cet objet peut être créé sur votre page ou au moyen d’un Code personnalisé Élément de données.
D’autres champs du type d’action Envoyer l’événement peuvent également être utiles en fonction de votre implémentation. Ces champs sont tous facultatifs.
- Type : Ce champ vous permet de spécifier un type d’événement qui sera enregistré dans votre schéma XDM. Voir
typedans lesendEventpour plus d’informations. - Données : Les données qui ne correspondent pas à un schéma XDM peuvent être envoyées à l’aide de ce champ. Ce champ est utile si vous essayez de mettre à jour un profil Adobe Target ou d’envoyer des attributs Recommendations Target. Voir
datadans lesendEventpour plus d’informations. - Identifiant du jeu de données : Si vous devez envoyer des données à un jeu de données autre que celui que vous avez spécifié dans votre flux de données, vous pouvez spécifier cet identifiant de jeu de données ici.
- Le document se décharge : Si vous souhaitez vous assurer que les événements atteignent le serveur même si l’utilisateur quitte la page, cochez la case Le document sera déchargé. . Cela permet aux événements d’atteindre le serveur, mais les réponses sont ignorées.
- Rendu des décisions de personnalisation visuelle : Si vous souhaitez effectuer le rendu du contenu personnalisé sur votre page, cochez la case Rendu des décisions de personnalisation visuelle . Vous pouvez également spécifier des portées de décision et/ou des surfaces si nécessaire. Voir documentation de personnalisation pour plus d’informations sur le rendu du contenu personnalisé.
Définition du consentement set-consent
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’un Envoyer un événement pour enregistrer l’objet XDM d’événement.
Pour utiliser ce type d’action, vous devez avoir défini une variable élément de données. Une fois que vous avez choisi un élément de données de variable à modifier, un éditeur s’affiche, semblable à l’éditeur pour le Objet XDM élément de données.
Le schéma XDM utilisé pour l’éditeur est le schéma sélectionné sur la page variable élément de données. 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.
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 une playerId qui représente un identifiant unique pour une session multimédia suivie. Elle nécessite également une Qualité d’expérience et un playhead élément de données lors du démarrage d’une session multimédia.
La variable Envoyer un événement multimédia le type d’action prend en charge les propriétés suivantes :
- Instance: instance du SDK Web utilisée.
- Type d’événement multimédia: type d’é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 de session multimédia requis 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.
- Informations publicitaires: lors de l’envoi d’un événement
AdBreakStart, vous devez spécifier les détails publicitaires requis. - Détails de la capsule publicitaire: informations détaillées sur la capsule publicitaire lors de l’envoi d’une
AdStart. - Détails de l’erreur: informations détaillées sur l’erreur de lecture qui est suivie.
- Détails de la mise à jour de l’état: état du lecteur mis à jour.
- Métadonnées personnalisées: métadonnées personnalisées sur l’événement multimédia suivi.
- Qualité d’expérience: qualité du média des données d’expérience suivies.
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 n’est fourni, il sera exporté vers window.Media comme le fait la bibliothèque Media JS actuelle.
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 une click type d’événement et condition de comparaison des valeurs. Voir Ajout d’une identité à l’URL à l’aide de l’extension SDK Web pour plus d’informations sur l’utilisation de ce type d’action.
Étapes suivantes next-steps
Après avoir lu cet article, vous devriez mieux comprendre comment configurer vos actions. Ensuite, découvrez comment configuration des types d’éléments de données.