Gestion du scintillement par at.js

Dernière mise à jour : 2023-07-27
  • Rubriques :
  • at.js
    Afficher plus sur ce sujet
  • Créé pour :
  • Developer

Informations sur la manière dont la variable Adobe Target La bibliothèque JavaScript at.js empêche le scintillement lors du chargement de la page ou de l’application.

Il y a scintillement lorsque du contenu par défaut est présenté temporairement aux visiteurs avant d’être remplacé par le contenu de l’activité. Ce phénomène peut déstabiliser les visiteurs et doit donc être évité.

Utilisation d’une mbox globale créée automatiquement

Lorsque vous activez la Création automatique d’une Mbox globale lors de la configuration d’at.js, ce dernier gère le scintillement en modifiant le paramètre d’opacité au chargement de la page. Lorsque at.js charge, cela change le paramètre d’opacité du <body> sur « 0 », rendant la page initialement invisible pour les visiteurs. Après une réponse de Target est reçu, ou si une erreur de la variable Target est détectée. at.js réinitialise l’opacité sur "1". Ainsi, le visiteur ne voit la page qu’une fois le contenu de vos activités appliqué.

Si vous activez le paramètre lors de la configuration de at.js, at.js définit l’opacité du style HTML BODY sur 0. Après une réponse de Target est reçu, at.js réinitialise l’opacité du HTML BODY sur 1.

L’opacité définie sur 0 conserve le contenu de la page masqué pour empêcher le scintillement, mais le navigateur effectue toujours le rendu de la page et charge tous les éléments nécessaires tels que CSS, les images, etc.

If opacity: 0 ne fonctionne pas dans votre implémentation, vous pouvez également gérer le scintillement en personnalisant bodyHiddenStyle et définissez-le sur body {visibility:hidden !important}. Vous pouvez utiliser body {opacity:0 !important} ou body {visibility:hidden !important}, selon ce qui fonctionne le mieux dans votre situation spécifique.

L’illustration suivante présente les appels à Masquer/Afficher le corps dans at.js 1.x et at.js 2.x.

at.js 2.x

(Cliquez sur l’image pour agrandir l’image en largeur réelle.)

Flux cible : demande de chargement de page at.js

at.js 1.x

(Cliquez sur l’image pour agrandir l’image en largeur réelle.)

Flux cible : mbox globale créée automatiquement

Pour plus d’informations sur le remplacement de bodyHiddenStyle, voir targetGlobalSettings().

Gestion du scintillement lors du chargement asynchrone du fichier at.js

Le chargement d’at.js de manière asynchrone est un excellent moyen d’éviter de bloquer le rendu du navigateur. Cependant, cette technique peut entraîner un scintillement de la page web.

Vous pouvez éviter le scintillement en utilisant un fragment de code de pré-masquage qui sera visible une fois les éléments HTML pertinents personnalisés par Target.

at.js peut être chargé de manière asynchrone, soit directement incorporé sur la page, soit via un gestionnaire de balises (Adobe Experience Platform Launch, par exemple).

Si at.js est incorporé à la page, le fragment de code doit être ajouté avant de charger at.js. Si vous chargez at.js via un gestionnaire de balises, qui est également chargé de manière asynchrone, vous devez ajouter le fragment de code avant de charger le gestionnaire de balises. Si le gestionnaire de balises est chargé de manière synchrone, le script peut être inclus dans le gestionnaire de balises avant at.js.

Le fragment de code de pré-masquage se présente comme suit :

;(function(win, doc, style, timeout) {
  var STYLE_ID = 'at-body-style';

  function getParent() {
    return doc.getElementsByTagName('head')[0];
  }

  function addStyle(parent, id, def) {
    if (!parent) {
      return;
    }

    var style = doc.createElement('style');
    style.id = id;
    style.innerHTML = def;
    parent.appendChild(style);
  }

  function removeStyle(parent, id) {
    if (!parent) {
      return;
    }

    var style = doc.getElementById(id);

    if (!style) {
      return;
    }

    parent.removeChild(style);
  }

  addStyle(getParent(), STYLE_ID, style);
  setTimeout(function() {
    removeStyle(getParent(), STYLE_ID);
  }, timeout);
}(window, document, "body {opacity: 0 !important}", 3000));

Par défaut, le fragment de code masque préalablement l’ensemble HTML BODY. Dans certains cas, vous souhaitez uniquement masquer préalablement certains éléments HTML et non la totalité de la page. Vous pouvez y parvenir en personnalisant le paramètre de style. Il peut être remplacé par un élément qui masque préalablement seulement des régions spécifiques de la page.

Par exemple, vous disposez de deux régions identifiées par les ID container-1 et container-2, alors le style peut être remplacé par ce qui suit :

#container-1, #container-2 {opacity: 0 !important}

Au lieu de la valeur par défaut :

body {opacity: 0 !important}

Gestion du scintillement dans at.js 2.x pour triggerView()

Lorsque vous utilisez triggerView() pour afficher du contenu ciblé dans votre SPA, la gestion du scintillement est fournie en dehors de la zone. Cela signifie que la logique de pré-masquage ne doit pas être ajoutée manuellement. À la place, at.js 2.x pré-masque l’emplacement de votre vue avant d’appliquer le contenu ciblé.

Gestion du scintillement avec getOffer() et applyOffer()

Comme getOffer() et applyOffer() sont des API de bas niveau, il n’y a aucun contrôle de scintillement intégré. Vous pouvez transmettre un sélecteur ou un élément HTML sous la forme d’une option à applyOffer(). Dans ce cas, applyOffer() ajoute le contenu de l’activité à cet élément spécifique. Veillez toutefois à ce que l’élément soit correctement pré-masqué avant d’appeler getOffer() et applyOffer().

document.documentElement.style.opacity = "0";

adobe.target.getOffer({
    mbox: 'target-global-mbox',
    success: function(offer) {
        adobe.target.applyOffer({
            mbox: 'target-global-mbox',
            offer: offer
        });

        document.documentElement.style.opacity = "1";
    },
    error: function() {
        document.documentElement.style.opacity = "1";
    }
});

Utilisation d’une mbox régionale avec mboxCreate() dans at.js 1.x (non pris en charge dans at.js 2.x)

Si vous utilisez une implémentation de mbox régionale, vous pouvez utiliser mboxCreate() avec votre page configurée comme suit :

<div class="mboxDefault">
Some default content
</div>
<script>
mboxCreate('some-mbox');
</script>

Si vos pages sont correctement configurées, at.js gère le scintillement en activant/désactivant, suivant les besoins, la propriété de « visibilité » CSS de l’élément avec la classe mboxDefault.

Sur cette page