Présentation de l’extension Core

L’extension Core est l’extension par défaut disponible avec Adobe Experience Platform Launch.

Utilisez cette référence pour obtenir des informations sur les options disponibles lors de l’utilisation de cette extension 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, voir Options.

Browser

Tab Blur

Déclenchez l’action lorsqu’un onglet n’est plus mis au point.

Il n’existe aucun paramètre pour ce type d’événement.

Tab Focus

Déclenchez l’action lorsque la mise au point est faite sur un onglet.

Il n’existe aucun paramètre pour ce type d’événement.

Form

Blur

Déclenchez l’action lorsqu’un formulaire n’est plus mis au point.

Voir Options ci-dessous.

Focus

Déclenchez l’action lorsque la mise au point est faite sur un formulaire.

Voir Options ci-dessous.

Submit

Déclenchez l’action lorsqu’un formulaire est envoyé.

Voir Options ci-dessous.

Clavier

Key Press

Déclenchez l’événement si une touche est enfoncée.

Voir Options ci-dessous.

Médias

Media Ended

Déclenchez l’événement à la fin du fichier multimédia.

Voir Options ci-dessous.

Media Loaded Data

Déclenchez l’événement lorsque le fichier multimédia charge des données.

Voir Options ci-dessous.

Media Pause

Déclenchez l’événement lorsque le fichier multimédia est en pause.

Voir Options ci-dessous.

Media Play

Déclenchez l’événement lors de la lecture du fichier multimédia.

Voir Options ci-dessous.

Media Stalled

Déclenchez l’événement si le fichier multimédia se bloque.

Voir Options ci-dessous.

Media Time Played

Déclenchez l’événement si le fichier multimédia est lu pendant une durée spécifiée.

Voir Options ci-dessous.

En outre, indiquez que l’événement est déclenché après une durée spécifique.

Media Volume Changed

Déclenchez l’événement si le volume est augmenté ou réduit.

Voir Options ci-dessous.

Mobile

Orientation Change

Déclenchez l’événement si l’orientation de l’appareil change.

Il n’existe aucun paramètre pour ce type d’événement.

En outre, indiquez que l’événement est déclenché après une durée spécifique.

Zoom Change

Déclenchez l’événement si l’utilisateur effectue un zoom avant ou arrière.

Il n’existe aucun paramètre pour ce type d’événement.

Souris

Click

Déclenchez l’élément 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 un lien (une balise <a>), 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.

Lorsque vous utilisez le délai de lien, Platform Launch empêche le navigateur de quitter la page, puis effectue une redirection JavaScript vers la destination d’origine à la fin du délai d’attente 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. Veuillez noter que Platform Launch attend toujours que la durée soit spécifiée et n’est en aucun cas lié à 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 davantage de temps pour l’exécution des règles, mais contribuent également à une expérience utilisateur moins agréable.

En outre, indiquez que l’événement est déclenché après une durée spécifique.

Pour les options avancées, voir Options ci-dessous.

Hover

Déclenchez l’événement si l’utilisateur survole un élément spécifié.

Voir Options ci-dessous.

De plus, choisissez si la règle est déclenchée immédiatement ou après un certain nombre de millisecondes.

Autre

Custom Event

Déclenchez l’événement si un type d’événement personnalisé se produit.

Vous pouvez nommer une fonction JavaScript que vous avez définie ailleurs et l’utiliser pour l’événement.

Indiquez le nom du type d’événement personnalisé, puis configurez les autres paramètres tel que décrit dans la section Options ci-dessous.

Data Element Changed

Déclenchez l’événement si un élément de données spécifié change.

Saisissez le nom de l’élément de données. Vous pouvez sélectionner l’élément de données dans une liste en cliquant sur l’icône, puis en sélectionnant l’élément de données.

Direct Call

Conçu pour contourner les systèmes de recherche et la détection des événements.

Les règles d’appel direct sont adaptées aux situations dans lesquelles vous devez indiquer à Platform Launch ce qui se passe exactement. Elles s’avèrent également très utiles lorsque Platform Launch 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.

Element Exists

Déclenchez l’événement si un élément spécifié existe.

Voir Options ci-dessous.

Enters Viewport

Déclenchez l’événement si l’utilisateur entre dans une fenêtre d’affichage spécifiée.

Voir Options ci-dessous.

De plus, choisissez si la règle est déclenchée immédiatement ou après un certain nombre de millisecondes.

History Change

Déclenchez l’événement si un événement pushState ou hashchange se produit.

Il n’existe aucun paramètre pour ce type d’événement.

Time Spent on Page

Déclenchez l’événement si l’utilisateur reste sur la page pendant un certain nombre de secondes.

Indiquez le nombre de secondes qui doivent s’écouler avant le déclenchement de l’événement.

Chargement de page

DOM Ready

Déclenchez 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.

Library Loaded (Page Top)

Déclenchez l’événement dès que la bibliothèque Platform Launch est chargée.

Il n’existe aucun paramètre pour ce type d’événement.

Page Bottom

Déclenchez l’événement 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 Platform Launch.

Il n’existe aucun paramètre pour ce type d’événement.

Window Loaded

Déclenchez l’événement 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 Specific Elements, les options permettant de sélectionner les éléments et les valeurs de propriété s’affichent.
• Si vous choisissez Any Element, 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

Cookie

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 Custom Code.

1. Sélectionner Open Editor.
2. Saisissez le Custom Code.
3. Sélectionner Save.

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, Platform Launch considère 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

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.

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.

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.

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.

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.

Sampling

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électionner Open Editor.
5. Modifiez le code, puis cliquez sur Save.

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 de Platform Launch, contient une action Custom Code 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 Platform Launch 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 Platform Launch 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.

Note : cela ne fonctionne que si votre code JavaScript n’est pas défini pour s’exécuter globalement. Si vous exécutez votre action Custom Code dans la portée globale, Platform Launch traite la promesse comme résolue immédiatement et passe à 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 Custom Code est terminé et que Platform Launch peut 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 à Platform Launch 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.

Cookie

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.

Lorsque vos balises contiennent des variables JavaScript ou des propriétés d’objets et que vous souhaitez recueillir ces valeurs dans Platform Launch pour les utiliser avec l’une de vos extensions ou règles, une méthode de capture de ces valeurs consiste à utiliser des éléments de données dans Platform Launch. Ainsi, vous pouvez vous reporter à l’élément de données dans vos règles, et si la source des données venait à changer, il vous suffirait de modifier la référence à la source (l’élément de données) vers un emplacement de Platform Launch.

Par exemple, supposons que vos balises contiennent une variable JavaScript nommée « Page_Name » comme illustré ci-dessous :

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

Lorsque vous créez l’élément de données dans Launch, fournissez simplement le chemin d’accès à cette variable.

Si vous utilisez un objet collecteur de données dans votre couche de données, utilisez simplement la notation point dans le chemin d’accès 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

Similaire 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 la collecte de données.

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