Présentation de l’extension Core

REMARQUE

Adobe Experience Platform Launch est désormais une suite de technologies destinées à la collecte de données dans Adobe Experience Platform. Plusieurs modifications terminologiques ont par conséquent été apportées à la documentation du produit. Reportez-vous au document suivant pour consulter une référence consolidée des modifications terminologiques.

Lʼextension de balise Core est lʼextension par défaut disponible avec Adobe Experience Platform.

Ce document fournit des informations sur les options disponibles lors de lʼutilisation de lʼextension Core pour créer une règle.

Types d’événements de l’extension Core

Cette section décrit les types d’événements disponibles dans l’extension Core. Pour plus dʼinformations sur les options pouvant être définies pour plusieurs types dʼévénements différents, reportez-vous à la section Options.

Événements basés sur le navigateur

Tab Blur

Lʼévénement Onglet flou déclenche lʼaction lorsquʼun onglet nʼest plus actif. Il n’existe aucun paramètre pour ce type d’événement.

Tab Focus

Lʼévénement Onglet actif déclenche lʼaction lorsquʼun onglet devient actif. Il n’existe aucun paramètre pour ce type d’événement.

Form

Blur

Lʼévénement Flou déclenche lʼaction lorsquʼun formulaire nʼest plus actif. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, reportez-vous à la section Options.

Focus

Lʼévénement Actif déclenche lʼaction lorsquʼun formulaire devient actif. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, reportez-vous à la section Options.

Envoyer

Lʼévénement Envoi déclenche lʼaction lors de lʼenvoi dʼun formulaire. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, reportez-vous à la section Options.

Événements contrôlés par le clavier

Appui sur une touche

Lʼévénement se déclenche lorsquʼune touche est enfoncée. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, reportez-vous à la section Options.

Événements basés sur le fichier multimédia

Fin du média

Lʼévénement se déclenche lorsque le fichier multimédia se termine. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, reportez-vous à la section Options.

Données chargées sur le fichier multimédia

Lʼévénement se déclenche lorsque le fichier multimédia charge des données. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, reportez-vous à la section Options.

Pause du média

Lʼévénement se déclenche lorsque le fichier multimédia est en pause. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, reportez-vous à la section Options.

Lecture du média

Lʼévénement se déclenche lors de la lecture du fichier multimédia. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, reportez-vous à la section Options.

Média bloqué

Lʼévénement se déclenche si le fichier multimédia se bloque. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, voir la section Options.

Durée de lecture du fichier multimédia

Lʼévénement se déclenche si le fichier multimédia est lu pendant une durée spécifiée. Pour déclencher lʼévénement, vous devez spécifier la durée de lecture du média. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, voir la section Options.

Modification du volume du fichier multimédia

Lʼévénement se déclenche si le volume est augmenté ou réduit. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, voir la section Options.

Événements orientés vers les appareils mobiles

Modification de l’orientation

Lʼévénement se déclenche si lʼorientation de lʼappareil change. Pour déclencher lʼévénement, vous devez spécifier la durée pendant laquelle lʼorientation doit changer. Il n’existe aucun paramètre pour ce type d’événement.

Modification du zoom

Lʼévénement se déclenche si lʼutilisateur effectue un zoom avant ou arrière. Il n’existe aucun paramètre pour ce type d’événement.

Événements contrôlés par la souris

Clic

Lʼévénement se déclenche si lʼélément spécifié est sélectionné (clic). Vous pouvez éventuellement spécifier des valeurs de propriété qui doivent être vraies pour l’élément avant que l’événement ne soit déclenché.

Si lʼélément est une balise dʼancrage (<a>) vers du contenu lié, vous pouvez également indiquer si la navigation doit être retardée pendant une certaine période. Cela peut sʼavérer utile si votre règle nécessite un délai dʼexécution supplémentaire et nʼest normalement pas terminée avant que la page ne sʼouvre.

AVERTISSEMENT

Cette option doit être utilisée avec une extrême prudence en raison des conséquences négatives potentielles quʼelle peut entraîner pour lʼexpérience utilisateur si elle est mal utilisée.

Lorsque vous utilisez un délai de lien, Platform empêche le navigateur de quitter la page. Platform effectue ensuite une redirection JavaScript vers la destination dʼorigine après le délai dʼexpiration spécifié. C’est particulièrement risqué lorsque le balisage de votre page comporte des balises <a> où la fonctionnalité prévue ne permet pas de rediriger l’utilisateur en dehors de la page. S’il vous est impossible de résoudre ce problème d’une autre manière, soyez extrêmement précis quant à la définition de votre sélecteur afin que cet événement se déclenche exactement là où vous en avez besoin et nulle part ailleurs.

La valeur par défaut du délai de lien est de 100 millisecondes. Remarquez que les balises attendent toujours que la durée soit spécifiée et quʼelles ne sont en aucun cas liées à lʼexécution des actions de la règle. Il est possible que le délai oblige l’utilisateur à attendre plus longtemps que nécessaire et qu’il ne soit pas suffisant pour permettre à toutes les actions de la règle de s’achever correctement. Des délais plus longs offrent du temps supplémentaire à lʼexécution des règles, mais entraînent également une détérioration de lʼexpérience client.

Pour appliquer le délai, il est nécessaire de fournir à la fois lʼélément sélectionné qui déclenche lʼévénement, ainsi que la durée spécifique avant le déclenchement de celui-ci.

Pour plus dʼinformations sur les options avancées, reportez-vous à la section Options.

Survol

Lʼévénement se déclenche si lʼutilisateur survole un élément spécifié. Vous devez également choisir si la règle est déclenchée immédiatement ou après un certain nombre de millisecondes. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, reportez-vous à la section Options.

Autres événements

Événement personnalisé

Lʼévénement se déclenche si un type dʼévénement personnalisé se produit. Les fonctions JavaScript nommées définies ailleurs dans le code base peuvent être utilisées comme type dʼévénement personnalisé. Vous devez indiquer le nom du type dʼévénement personnalisé et configurer tous les autres paramètres tel que décrit dans la section Options ci-dessous.

Élément de données modifié

Lʼévénement se déclenche si un élément de données spécifié change. Vous devez attribuer un nom à lʼélément de données. Vous pouvez sélectionner lʼélément de données en saisissant son nom dans le champ de texte ou en sélectionnant lʼicône de lʼélément de données à droite du champ de texte et en effectuant ensuite une sélection dans une liste fournie dans la boîte de dialogue qui sʼaffiche.

Appel direct

Lʼévénement « direct-call » contourne les systèmes de recherche et de détection dʼévénements. Les règles « direct-call » sont adaptées aux situations dans lesquelles vous devez indiquer à Platform ce qui se passe exactement. Elles s’avèrent également très utiles lorsque Platform ne peut pas détecter un événement dans le modèle DOM (dans le cas d’Adobe Flash, par exemple). Indiquez la chaîne _satellite.track dans le champ de texte de lʼidentifiant.

L’élément existe

Lʼévénement se déclenche si un élément spécifié existe. Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, reportez-vous à la section Options.

Entre dans la fenêtre d’affichage

Lʼévénement se déclenche si lʼutilisateur entre dans une fenêtre dʼaffichage spécifiée. Vous devez fournir un sélecteur CSS en tant que critère pour cibler les éléments correspondants. Vous devez également choisir si la règle est déclenchée immédiatement ou après un certain nombre de millisecondes, et si lʼévénement doit se déclencher à chaque fois que lʼévénement se produit ou uniquement la première fois.

Pour plus dʼinformations sur les paramètres dʼévénements personnalisables, reportez-vous à la section Options.

History change

Lʼévénement se déclenche si un événement « pushState » ou « hashchange » se produit. Il n’existe aucun paramètre pour ce type d’événement.

Durée de consultation de la page

Lʼévénement se déclenche si lʼutilisateur reste sur la page pendant un certain nombre de secondes. Vous devez indiquer le nombre de secondes qui doivent sʼécouler avant le déclenchement de lʼévénement.

Événements de chargement de page

DOM prêt

Lʼévénement se déclenche lorsque le DOM est prêt et que lʼutilisateur peut interagir avec la page. Il n’existe aucun paramètre pour ce type d’événement.

Bibliothèque chargée (haut de page)

Lʼévénement se déclenche dès que la bibliothèque de balises est chargée. Il n’existe aucun paramètre pour ce type d’événement.

Bas de page

Lʼévénement se déclenche une fois que _satellite.pageBottom(); a été appelé. Ce type dʼévénement ne doit pas être utilisé lors du chargement asynchrone de la bibliothèque de balises. Il n’existe aucun paramètre pour ce type d’événement.

Window Loaded

Lʼévénement se déclenche lorsque onLoad est appelé par le navigateur et que le chargement de la page est terminé. Il n’existe aucun paramètre pour ce type d’événement.

Options

Chacun des types d’événements de formulaire utilise les paramètres suivants :

Specific Elements | Any Element

  • Si vous choisissez Éléments spécifiques, les options permettant de sélectionner les éléments et les valeurs de propriété s’affichent.
  • Si vous choisissez N’importe quel élément, aucune autre option n’est nécessaire pour réduire les éléments.

Elements matching the CSS selector

Entrez le sélecteur CSS permettant d’identifier les éléments qui déclenchent l’événement.

And having certain property values

Lorsque vous sélectionnez cette option, les paramètres suivants deviennent disponibles :

  • property=value

    Indiquez la valeur de la propriété.

  • Regex

    Activez si property=value est une expression régulière.

  • Add

    Ajoutez une autre paire property=value.

Advanced options (Bubbling)

  • Exécuter cette règle même lorsque l’événement provient d’un élément descendant
  • Autoriser cette règle à s’exécuter même si l’événement a déjà déclenché une règle qui cible un élément descendant
  • Une fois la règle exécutée, empêcher l’événement de déclencher des règles qui ciblent des éléments ancêtres

Types de conditions de l’extension Core

Cette section décrit les types de conditions disponibles dans l’extension Core. Ces types de condition peuvent être utilisés avec le type de logique normal ou Exception.

Données

Spécifiez le nom et la valeur du cookie devant exister pour qu’un événement déclenche une action.

  1. Indiquez un nom de cookie.
  2. Entrez la valeur qui doit exister dans le cookie si l’événement doit déclencher une action.
  3. (Facultatif) Activez les Regex s’il s’agit d’une expression régulière.

Custom Code

Spécifiez un Custom Code qui doit exister comme condition de l’événement. Utilisez l’éditeur de code intégré pour saisir le code personnalisé.

  1. Sélectionnez Ouvrir l’éditeur.
  2. Saisissez le Custom Code.
  3. Sélectionnez Enregistrer.

Une variable nommée event sera automatiquement disponible et vous pouvez y faire référence à partir de votre Custom Code. L’objet event contient des informations utiles sur l’événement qui a déclenché la règle. Le moyen le plus simple de déterminer les données d’événement disponibles consiste à connecter event à la console à partir du Cutom Code :

console.log(event);
return true;

Exécutez la règle dans un navigateur et examinez l’objet d’événement consigné dans la console du navigateur. Une fois que vous avez compris quelles informations sont disponibles, vous pouvez les utiliser pour la prise de décision par programmation dans votre Custom Code.

Séquençage de conditions

Lorsque l’option « Run rule components in sequence » des paramètres de propriété est activée, vous pouvez faire attendre les composants de règle suivants pendant que votre condition effectue une tâche asynchrone.

Lorsque la condition renvoie une promesse, la prochaine condition de la règle ne s’exécutera pas tant que la promesse renvoyée n’aura pas été résolue. Si la promesse est refusée, les balises considèrent que la condition a échoué et aucune autre condition ou action de cette règle ne sera exécutée.

Exemple de condition qui renvoie une promesse :

return new Promise(function(resolve, reject) {
  setTimeout(function() {
    if (new Date().getDay() === 5) {
      resolve();
    } else {
      reject();
    }
  }, 1000);
});

Value Comparison (Comparaison de valeurs)

Compare deux valeurs afin de déterminer si cette condition renvoie true (vrai).

Si vous disposez d’une règle avec plusieurs conditions, il est possible que cette condition renvoie true (vrai), mais que la règle ne se déclenche toujours pas, car les autres conditions sont considérées comme false (faux) ou l’une des exceptions est considérée comme true (vrai).

  1. Donnez une valeur.
  2. Sélectionnez l’opérateur. Pour plus d’informations, reportez-vous à la liste des opérateurs de comparaison de valeurs ci-dessous.
  3. (Si nécessaire) Indiquez si la comparaison doit être sensible à la casse.
  4. Donnez une autre valeur pour la comparaison.

Les opérateurs de comparaison de valeurs suivants sont disponibles :

Equal : la condition renvoie true (vrai) si les deux valeurs sont égales à l’aide d’une comparaison non stricte (dans JavaScript, l’opérateur ==). Les valeurs peuvent être de n’importe quel type. Lorsque vous saisissez un mot tel que true (vrai), false (faux), null (nul) ou undefined (non défini) dans un champ de valeur, le mot est comparé en tant que chaîne et n’est pas converti vers son équivalent JavaScript.

Does Not Equal : la condition renvoie true (vrai) si les deux valeurs ne sont pas égales à l’aide d’une comparaison non stricte (dans JavaScript, l’opérateur !=). Les valeurs peuvent être de n’importe quel type. Lorsque vous saisissez un mot tel que true (vrai), false (faux), null (nul) ou undefined (non défini) dans un champ de valeur, le mot est comparé en tant que chaîne et n’est pas converti vers son équivalent JavaScript.

Contains : la condition renvoie true (vrai) si la première valeur contient la seconde valeur. Les nombres sont convertis en chaînes. Pour toute autre valeur qu’un nombre ou une chaîne, la condition renvoie false (faux).

Does Not Contain : la condition renvoie true (vrai) si la première valeur ne contient pas la seconde valeur. Les nombres sont convertis en chaînes. Pour toute autre valeur qu’un nombre ou une chaîne, la condition va renvoyer true (vrai).

Starts With : la condition renvoie true (vrai) si la première valeur commence par la seconde valeur. Les nombres sont convertis en chaînes. Pour toute autre valeur qu’un nombre ou une chaîne, la condition renvoie false (faux).

Does Not Start With : la condition renvoie true (vrai) si la première valeur ne commence pas par la seconde valeur. Les nombres sont convertis en chaînes. Pour toute autre valeur qu’un nombre ou une chaîne, la condition renvoie true (vrai).

Ends With : la condition renvoie true (vrai) si la première valeur termine par la seconde valeur. Les nombres sont convertis en chaînes. Pour toute autre valeur qu’un nombre ou une chaîne, la condition renvoie false (faux).

Does Not End With : la condition renvoie true (vrai) si la première valeur ne se termine pas par la seconde valeur. Les nombres sont convertis en chaînes. Pour toute autre valeur qu’un nombre ou une chaîne, la condition renvoie true (vrai).

Matches Regex : la condition renvoie true (vrai) si la première valeur correspond à l’expression régulière. Les nombres sont convertis en chaînes. Pour toute autre valeur qu’un nombre ou une chaîne, la condition renvoie false (faux).

Does Not Match Regex : la condition renvoie true (vrai) si la première valeur ne correspond pas à l’expression régulière. Les nombres sont convertis en chaînes. Pour toute autre valeur qu’un nombre ou une chaîne, la condition renvoie true (vrai).

Is Less Than : la condition renvoie true (vrai) si la première valeur est inférieure à la seconde valeur. Les chaînes représentant des nombres sont converties en nombres. Pour toute autre valeur qu’un nombre ou une chaîne convertible, la condition renvoie false (faux).

Is Less Than Or Equal To : la condition renvoie true (vrai) si la première valeur est inférieure ou égale à la seconde valeur. Les chaînes représentant des nombres sont converties en nombres. Pour toute autre valeur qu’un nombre ou une chaîne convertible, la condition renvoie false (faux).

Is Greater Than : la condition renvoie true (vrai) si la première valeur est supérieure à la seconde valeur. Les chaînes représentant des nombres sont converties en nombres. Pour toute autre valeur qu’un nombre ou une chaîne convertible, la condition renvoie false (faux).

Is Greater Than Or Equal To : la condition renvoie true (vrai) si la première valeur est supérieure ou égale à la seconde valeur. Les chaînes représentant des nombres sont converties en nombres. Pour toute autre valeur qu’un nombre ou une chaîne convertible, la condition renvoie false (faux).

Is True : la condition renvoie true (vrai) si la valeur est une valeur booléenne dont la valeur est true (vrai). La valeur fournie n’est pas convertie en valeur booléenne s’il s’agit d’un autre type. Pour toute autre valeur qu’une valeur booléenne dont la valeur est true (vrai), la condition renvoie false (faux).

Is Truthy : la condition renvoie true (vrai) si la valeur est true (vrai) après avoir été convertie en valeur booléenne. Voir la documentation sur la condition Truthy de MDN pour des exemples de valeurs « truthy ».

Is False : la condition renvoie true (vrai) si la valeur est une valeur booléenne dont la valeur est false (faux). La valeur fournie n’est pas convertie en valeur booléenne s’il s’agit d’un autre type. Pour toute autre valeur qu’une valeur booléenne dont la valeur est false (faux), la condition renvoie false (faux).

Is Falsy : la condition renvoie true (vrai) si la valeur est false (faux) après avoir été convertie en valeur booléenne. Voir la documentation sur la condition Falsy de MDN pour des exemples de valeurs « falsy ».

Variable

Spécifiez le nom et la valeur de la variable JavaScript devant exister pour qu’un événement déclenche une action.

  1. Spécifiez le nom de la variable JavaScript.
  2. Spécifiez la valeur de la variable qui doit exister comme condition pour l’événement.
  3. (Facultatif) Activez les Regex s’il s’agit d’une expression régulière.

Engagement

Landing Page

Indiquez la page sur laquelle l’utilisateur doit entrer pour déclencher l’événement.

  1. Indiquez la page d’entrée.
  2. (Facultatif) Activez les Regex s’il s’agit d’une expression régulière.

New/Returning Visitor

Indiquez si le visiteur doit être un nouveau visiteur ou un visiteur récurrent pour qu’un événement déclenche une action.

Sélectionnez l’une des options suivantes :

  • New Visitor
  • Returning Visitor

Page Views

Configurez le nombre de fois où le visiteur doit consulter la page avant que l’action ne soit déclenchée.

  1. Sélectionnez si le nombre de pages vues doit être supérieur, égal ou inférieur à la valeur indiquée.
  2. Indiquez le nombre de pages vues qui déterminent si la condition est remplie.
  3. Configurez le moment où les pages vues sont comptabilisées en sélectionnant l’une des options suivantes :
    • Lifetime
    • Current Session

Sessions

Déclenchez l’action si le nombre de sessions de l’utilisateur respecte les critères indiqués.

  1. Indiquez si le nombre de sessions doit être supérieur, égal ou inférieur à la valeur indiquée.
  2. Indiquez le nombre de sessions qui déterminent si la condition est remplie.

Time On Site

Déclenchez l’action si le nombre de sessions de l’utilisateur respecte les critères indiqués.

Configurez la durée pendant laquelle le visiteur doit se trouver sur le site avant que l’action ne soit déclenchée.

  1. Sélectionnez si le nombre de minutes passées par l’utilisateur sur le site doit être supérieur, égal ou inférieur à la valeur indiquée.
  2. Indiquez le nombre de minutes qui déterminent si la condition est remplie.

Traffic Source

Déclenchez l’action si le nombre de sessions de l’utilisateur respecte les critères indiqués.

Spécifiez la source du trafic du visiteur qui doit être true (vrai) pour que l’action soit déclenchée.

  1. Indiquez la source du trafic.
  2. (Facultatif) Activez les Regex s’il s’agit d’une expression régulière.

Technologie

Browser

Sélectionnez le navigateur que le visiteur doit utiliser pour que l’action soit déclenchée.

Sélectionnez un ou plusieurs navigateurs parmi les suivants :

  • Chrome
  • Firefox
  • Internet Explorer / Edge
  • Internet Explorer Mobile
  • Safari mobile
  • OmniWeb
  • Opera
  • Opera Mini
  • Opera Mobile
  • Safari

Device Type

Sélectionnez le type de périphérique que le visiteur doit utiliser pour que l’action soit déclenchée.

Sélectionnez un ou plusieurs types de périphériques parmi les suivants :

  • Android
  • BlackBerry
  • Bureau
  • iPad
  • iPhone
  • iPod
  • Nokia
  • Windows Phone

Operating System

Sélectionnez le système d’exploitation que le visiteur doit utiliser pour que l’action soit déclenchée.

Sélectionnez un ou plusieurs des systèmes d’exploitation suivants :

  • Android
  • BlackBerry
  • iOS
  • Linux
  • MacOS
  • Maemo
  • Symbian OS
  • Unix
  • Windows

Screen Resolution

Sélectionnez la résolution d’écran que les visiteurs doivent utiliser sur leurs appareils pour que l’action soit déclenchée.

  1. Indiquez si la largeur de résolution de l’écran de l’appareil du visiteur doit être supérieure, égale ou inférieure à la valeur spécifiée.
  2. Indiquez le nombre de pixels requis pour la largeur de résolution d’écran.
  3. Indiquez si la hauteur de résolution de l’écran de l’appareil du visiteur doit être supérieure, égale ou inférieure à la valeur spécifiée.
  4. Indiquez le nombre de pixels requis pour la hauteur de résolution d’écran.

Window Size

Sélectionnez la taille de la fenêtre que les visiteurs doivent utiliser sur leurs appareils pour que l’action soit déclenchée.

  1. Indiquez si la largeur de la taille de fenêtre de l’appareil du visiteur doit être supérieure ou égale à la valeur spécifiée.
  2. Spécifiez le nombre de pixels requis pour la largeur de la taille de fenêtre.
  3. Indiquez si la hauteur de la taille de fenêtre de l’appareil du visiteur doit être supérieure ou égale à la valeur spécifiée.
  4. Spécifiez le nombre de pixels requis pour la hauteur de la taille de fenêtre.

URL

Domain

Indiquez le domaine du visiteur.

Hash

Indiquez un ou plusieurs modèles de hachage qui doivent exister dans l’URL.

REMARQUE

Plusieurs modèles de hachage sont unis par un OR.

  1. Indiquez le modèle de hachage.
  2. (Facultatif) Activez les Regex s’il s’agit d’une expression régulière.
  3. Ajoutez d’autres modèles de hachage.

Path And Query String

Indiquez un ou plusieurs chemins d’accès qui doivent exister dans l’URL. Cela inclut le chemin et la chaîne de requête.

REMARQUE

Plusieurs chemins sont unis par un OR.

  1. Indiquez le chemin d’accès.
  2. (Facultatif) Activez les Regex s’il s’agit d’une expression régulière.
  3. Ajoutez d’autres chemins d’accès.

Path Without Query String

Indiquez un ou plusieurs chemins d’accès qui doivent exister dans l’URL. Cela inclut le chemin d’accès, mais n’inclut pas la chaîne de requête.

REMARQUE

Plusieurs chemins sont unis par un OR.

  1. Indiquez le chemin d’accès.
  2. (Facultatif) Activez les Regex s’il s’agit d’une expression régulière.
  3. Ajoutez d’autres chemins d’accès.

Protocol

Indiquez le protocole utilisé dans l’URL.

Sélectionnez l’une des options suivantes :

  • HTTP
  • HTTPS

Paramètre de chaîne de requête

Indiquez le paramètre d’URL utilisé dans l’URL.

  1. Indiquez un nom de paramètre d’URL.
  2. Indiquez la valeur utilisée pour le paramètre d’URL.
  3. (Facultatif) Activez les Regex s’il s’agit d’une expression régulière.

Subdomain

Indiquez un ou plusieurs sous-domaines qui doivent exister dans l’URL.

REMARQUE

Plusieurs sous-domaines sont unis par un OR.

  1. Indiquez le sous-domaine.
  2. (Facultatif) Activez les Regex s’il s’agit d’une expression régulière.
  3. Ajoutez d’autres sous-domaines.

Autre

Date Range

Spécifiez une plage de dates. Sélectionnez la date et l’heure auxquelles l’événement se produit après, la date à laquelle il se produit avant et le fuseau horaire.

Max Frequency

Indiquez le nombre maximal de fois où la condition renvoie true (vrai). Vous avez les choix suivants :

  • Page view
  • Sessions
  • Visitor
  • Seconds
  • Minutes
  • Days
  • Weeks
  • Months

Pour la fréquence maximale de la condition 1 par session, ces deux éléments localStorage sont comparés. Si la valeur visitorTracking.sessionCount est supérieure au nombre maxFrequency.session, la condition d’échantillonnage est vraie. S’ils sont égaux, la condition est fausse.

sessionCount est un élément visitorTracking. L’API du visiteur doit donc être activée pour que la condition d’échantillonnage fonctionne.

Échantillonnage

Indiquez le pourcentage de fois où la condition renvoie true (vrai).

Types d’actions de l’extension Core

Cette section décrit les types d’actions disponibles dans l’extension Core.

Custom Code

Fournissez le code qui s’exécute une fois que l’événement est déclenché et que les conditions sont évaluées.

  1. Nommez le code d’action.
  2. Sélectionnez le langage utilisé pour définir l’action :
    • JavaScript
    • HTML
  3. Indiquez si le code d’action doit être exécuté globalement.
  4. Sélectionnez Ouvrir l’éditeur.
  5. Modifiez le code, puis cliquez sur Enregistrer.

Lorsque JavaScript est sélectionné comme langage, une variable nommée event est automatiquement disponible et vous pouvez y faire référence à partir de votre Custom Code. L’objet event contient des informations utiles sur l’événement qui a déclenché la règle. Le moyen le plus simple de déterminer les données d’événement disponibles consiste à connecter event à la console à partir du Cutom Code :

console.log(event);

Exécutez la règle dans un navigateur et examinez l’objet d’événement consigné dans la console du navigateur. Une fois que vous avez compris quelles informations sont disponibles, vous pouvez les utiliser pour la prise de décision programmée dans votre Custom Code, envoyer une partie de l’objet event à un serveur et bien plus encore.

Traitement de l’action Custom Code

L’extension Core, disponible pour tous les utilisateurs d’Adobe Experience Platform, contient une action Code personnalisé pour l’exécution du code JavaScript ou HTML fourni par l’utilisateur. Il est souvent utile que les utilisateurs comprennent comment les règles avec les actions Custom Code sont traitées.

Règles utilisant les événements de haut ou de bas de page

Le code provenant d’actions personnalisées est incorporé dans la bibliothèque de balises principale. Le code est écrit dans le document à l’aide de document.write. Si une règle comporte plusieurs actions Custom Code, le code est écrit dans l’ordre configuré dans la règle.

Règles utilisant n’importe quel autre événement que haut de page ou bas de page

Le code provenant d’actions personnalisées est chargé depuis le serveur et écrit dans le document à l’aide de Postscribe. Si une règle comporte plusieurs actions Custom Code, le code est chargé en parallèle depuis le serveur, mais écrit dans l’ordre configuré dans la règle.

Bien que l’utilisation de document.write après le chargement d’une page poserait généralement des problèmes, ce n’est pas problématique pour le code fourni via des actions Custom Code. Vous pouvez utiliser document.write dans des actions Custom Code, quelle que soit la date d’exécution du code.

Validation du Custom Code

Le programme de validation utilisé dans l’éditeur de code de balises est conçu pour identifier les problèmes liés au code écrit par le développeur. Le code qui a fait l’objet d’un processus de minimisation (tel que le code AppMeasurement.js téléchargé depuis le Gestionnaire de code) peut être faussement signalé comme ayant des problèmes par le programme de validation de, lesquels peuvent généralement être ignorés.

Séquencage d’actions

Lorsque l’option « Run rule components in sequence » des paramètres de propriété est activée, vous pouvez faire attendre les composants de règle suivants pendant que votre action effectue une tâche asynchrone. Cela fonctionne différemment pour le Custom Code JavaScript et HTML.

JavaScript

Lors de la création d’une action Custom Code JavaScript, vous pouvez renvoyer une promesse depuis votre action. L’action suivante de la règle sera exécutée uniquement lorsque la promesse renvoyée sera résolue. Si la promesse est refusée, les actions suivantes de la règle ne seront pas exécutées.

REMARQUE

Cela ne fonctionne que si votre JavaScript n’est pas défini pour s’exécuter globalement. Si vous exécutez votre action Code personnalisée dans la portée globale, les balises traitent la promesse comme résolue immédiatement et passent à l’élément suivant dans la file d’attente de traitement.

Exemple d’action Custom Code JavaScript renvoyant une promesse :

return new Promise(function(resolve, reject) {
  setTimeout(function() {
    if (new Date().getDay() === 5) {
      resolve();
    } else {
      reject();
    }
  }, 1000);
});

HTML

Lors de la création d’une action Custom Code HTML, une fonction nommée onCustomCodeSuccess() peut être utilisée dans votre Custom Code. Vous pouvez appeler cette fonction pour indiquer que votre code personnalisé est terminé et que les balises peuvent passer à l’exécution des actions suivantes. D’un autre côté, si votre Custom Code a échoué d’une manière ou d’une autre, vous pouvez appeler onCustomCodeFailure(). Cette action indiquera aux balises de ne pas exécuter les actions suivantes à partir de cette règle.

Exemple d’action Custom Code HTML utilisant les nouveaux rappels :

<script>
setTimeout(function() {
  if (new Date().getDay() === 5) {
    onCustomCodeSuccess();
  } else {
    onCustomCodeFailure();
  }
}, 1000);
</script>

Types d’éléments de données de l’extension Core

Les types d’éléments de données sont déterminés par l’extension. Les types qui peuvent être créés ne sont pas limités.

Les sections suivantes décrivent les types d’éléments de données disponibles dans l’extension Core. D’autres extensions utilisent d’autres types d’éléments de données.

N’importe quel cookie de domaine disponible peut être référencé dans le champ de nom du cookie.

Exemple :

cookieName

Constant

Toute valeur de chaîne constante qui peut ensuite être référencée dans des actions ou des conditions.

Exemple :

string

Custom code

Il est possible d’entrer du code JavaScript personnalisé dans l’interface utilisateur en cliquant sur Open Editor et en insérant le code dans la fenêtre de l’éditeur.

Une instruction de retour est nécessaire dans la fenêtre de l’éditeur afin d’indiquer quelle valeur doit être utilisée en tant que valeur de l’élément de données. Si une instruction de retour n’est pas incluse ou que la valeur null ou undefined est renvoyée, la valeur par défaut de l’élément de données est utilisée comme valeur de l’élément de données.

Exemple :

var pageType = $('div.page-wrapper').attr('class').split('')[1];
if (window.location.pathname == '/') {
  return 'homepage';
} else {
  return pageType;
}

Si l’élément de données de Custom Code est récupéré dans le cadre de l’exécution d’une règle, une variable nommée event est automatiquement disponible et vous pouvez y faire référence à partir de votre code personnalisé. L’objet event contient des informations utiles sur l’événement qui a déclenché la règle. Le moyen le plus simple de déterminer les données d’événement disponibles consiste à connecter event à la console à partir du Cutom Code :

console.log(event);
return true;

Exécutez la règle dans un navigateur et examinez l’objet d’événement consigné dans la console du navigateur. Une fois que vous avez compris quelles informations sont disponibles sous les différentes règles pouvant utiliser votre élément de données, vous pouvez les utiliser pour la prise de décision programmée dans votre Custom Code ou renvoyer une partie de l’objet event comme valeur de l’élément de données.

Attribut DOM

N’importe quelle valeur d’élément peut être récupérée (balise div ou H1, par exemple).

Exemple :

Chaîne de sélecteur CSS :

id#dc logo img

Obtention de la valeur de :

src

Variable JavaScript

N’importe quelle variable ou n’importe quel objet JavaScript peut être référencé à l’aide du champ de chemin d’accès.

Les éléments de données de balises peuvent être utilisés pour capturer vos variables JavaScript dʼannotation ou vos propriétés d’objet. Ces valeurs peuvent ensuite être utilisées dans vos extensions ou règles personnalisées en référençant les éléments de données de balise. Si la source des données change, il suffit de mettre à jour la référence à la source dans l’interface utilisateur de la collecte de données.

Dans l’exemple ci-dessous, lʼannotation contient une variable JavaScript nommée Page_Name.

<script>
  //data layer
  var Page_Name = "Homepage"
</script>

Lorsque vous créez l’élément de données dans l’interface utilisateur de la collecte de données, il vous suffit de fournir le chemin d’accès à cette variable.

Si vous utilisez un objet collecteur de données dans votre couche de données, utilisez la notation point dans le chemin pour faire référence à l’objet et à la propriété que vous souhaitez capturer dans l’élément de données, par exemple _myData.pageName ou digitalData.pageName, etc.

Exemple :

window.document.title

Stockage local

Indiquez le nom de votre élément de stockage local dans le champ Local Storage Item Name.

Le stockage local permet aux navigateurs de stocker des informations d’une page à l’autre (https://www.w3schools.com/html/html5_webstorage.asp). Le stockage local est très similaire aux cookies, mais est beaucoup plus volumineux et plus souple.

Utilisez le champ fourni pour spécifier la valeur que vous avez créée pour un élément de stockage local, comme lastProductViewed.

Informations sur la page

Utilisez ces points de données pour recueillir les informations sur la page à utiliser dans la logique votre règle ou pour envoyer des informations à Analytics ou à des systèmes de suivi externes.

Vous pouvez sélectionner l’un des attributs de page suivants à utiliser dans votre élément de données :

  • URL
  • Hostname
  • Pathname
  • Protocol
  • Référent
  • Title

Paramètre de chaîne de requête

Spécifiez un paramètre d’URL unique dans le champ URL Parameter.

Seule la section de nom est nécessaire. Les indicateurs spéciaux tels que « ? » ou « = » doivent être omis.

Exemple :

contentType

Nombre aléatoire

Utilisez cet élément de données pour générer un nombre aléatoire. Il est souvent utilisé pour échantillonner des données ou pour créer des identifiants, comme un ID d’accès. Le nombre aléatoire peut également être utilisé pour obscurcir ou appliquer un salage aux données sensibles. Voici quelques exemples :

  • Générer un ID d’accès
  • Concaténer le nombre à un jeton utilisateur ou à un horodatage pour garantir l’unicité
  • Réaliser un hachage unidirectionnel sur des données personnelles identifiables (PII)
  • Déterminer de manière aléatoire à quel moment il convient d’afficher une demande d’enquête sur le site

Indiquez les valeurs minimale et maximale de votre nombre aléatoire.

Valeurs par défaut :

Minimum : 0

Maximum : 1 000 000 000

Stockage de session

Indiquez le nom de votre élément de stockage de session dans le champ Session Storage Item Name.

Le stockage de session est similaire au stockage local, sauf que les données sont perdues une fois la session terminée, alors qu’un stockage local ou un cookie peut conserver les données.

Comportement du visiteur

Semblable aux informations sur la page, cet élément de données utilise des types de comportements courants pour enrichir la logique dans les règles ou d’autres solutions Platform.

Sélectionnez l’un des attributs de comportement du visiteur suivants :

  • Landing page
  • Traffic source
  • Minutes on site
  • Session count
  • Session page view count
  • Lifetime page view count
  • Is new visitor

Voici quelques cas d’utilisation courants :

  • Afficher une enquête une fois qu’un visiteur a consulté le site pendant cinq minutes
  • S’il s’agit de la page d’entrée de la visite, renseigner une mesure Analytics
  • Afficher une nouvelle offre au visiteur après un nombre de sessions égal à X
  • Afficher un abonnement au bulletin d’information s’il s’agit d’un nouveau visiteur

Sur cette page