Show Menu
SUJETS×

Extension Adobe Target v2

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.

Configuration de l’extension Adobe Target v2

L’extension Adobe Target requiert le fichier at.js 2.x.
Si l’extension Adobe Target n’est pas encore installée, ouvrez votre propriété, puis cliquez sur Extensions > Catalog (Extensions > Catalogue), survolez l’extension Target avec la souris et cliquez sur Install (Installer).
Pour configurer l’extension, ouvrez l’onglet Extensions, survolez l’extension avec la souris, puis cliquez sur Configure (Configurer).

Paramètres at.js

Tous les paramètres at.js, à l’exception du délai d’expiration, sont automatiquement extraits de la configuration at.js de l’interface utilisateur de Target. L’extension extrait les paramètres de l’interface utilisateur de Target uniquement lors de l’ajout initial. De ce fait, tous les paramètres doivent être gérés dans l’interface Launch si d’autres mises à jour sont nécessaires.
Les options de configuration disponibles sont les suivantes :

Client Code (Code client)

Le code client est l’identificateur du compte Target. Cette valeur doit presque toujours être conservée comme valeur par défaut.
Il peut être modifié à l’aide d’éléments de données.

Organization ID (ID d’organisation)

Cet identifiant associe votre mise en œuvre à votre compte Adobe Experience Cloud. Cette valeur doit presque toujours être conservée comme valeur par défaut.
Il peut être modifié à l’aide d’éléments de données.

Server Domain (Domaine du serveur)

Le domaine vers lequel les requêtes Target sont envoyées. Cette valeur doit presque toujours être conservée comme valeur par défaut.

Opt-in RGPD (Accord préalable RGPD)

Lorsque cette option est activée, Adobe Target fournit une fonctionnalité d’accord préalable aidant à prendre en charge la stratégie de gestion du consentement. Cette fonctionnalité permet aux clients de décider comment et à quel moment la balise Target est déclenchée. Pour plus d’informations sur la fonctionnalité d’accord préalable d’Adobe, voir  Confidentialité et Règlement général sur la protection des données (RGPD) .

Timeout (Délai d’expiration) (ms)

Si la réponse de Target n’est pas reçue au cours de la période définie, la demande expire et le contenu par défaut s’affiche. Des tentatives de requêtes supplémentaires sont effectuées pendant la session du visiteur. La valeur par défaut de 3 000 ms peut différer du délai configuré dans l’interface utilisateur de Target.
Pour plus d’informations sur le fonctionnement du délai d’expiration, consultez l’ aide d’Adobe Target .

Types d’actions de l’extension Target

Cette section décrit les types d’actions disponibles dans l’extension Target.
L’extension Target permet d’effectuer les actions suivantes dans la partie « Then » d’une règle :

Load Target (Charger Target)

Ajoute cette action à l’endroit correspondant de votre règle Launch pour charger Target dans le cadre de votre règle. Cette opération charge la bibliothèque at.js sur la page. Dans la plupart des mises en œuvre, Target doit être chargé sur chacune des pages de votre site.
Aucune configuration n’est nécessaire.

Ajout de paramètres à toutes les requêtes (Ajout de paramètres à toutes les requêtes)

Ajoute des paramètres à toutes les requêtes Target. L’action Load Target (Charger Target) doit avoir été utilisée au préalable.
  1. Indiquez le nom et la valeur du paramètre que vous souhaitez ajouter.
  2. Cliquez sur l’icône Add (Ajouter) pour ajouter d’autres paramètres.

Add Params to Page Load Request (Ajout de paramètres à la requête de chargement de page)

N’ajoute des paramètres qu’à vos requêtes de chargement de page. L’action Load Target (Charger Target) doit avoir été utilisée au préalable.
  1. Indiquez le nom et la valeur du paramètre que vous souhaitez ajouter.
  2. Cliquez sur l’icône Add (Ajouter) pour ajouter d’autres paramètres.

Fire Page Load Request (Déclenchement de la requête pendant le chargement de la page)

Déclenche une requête Target lors du chargement de votre page. L’action Load Target (Charger Target) doit avoir été utilisée au préalable.
Indiquez s’il convient d’activer le masquage du corps pour éviter le scintillement, ainsi que le style utilisé lors du masquage de l’élément de corps.
Les options disponibles sont les suivantes :
  • Body Hiding (Masquage du corps) : vous pouvez activer ou désactiver ce paramètre. La valeur par défaut est Enabled (Activé), ce qui signifie que la balise HTML BODY est masquée.
  • Body Hidden Style (Style masqué de l’élément corps) : la valeur par défaut est body. Cette valeur peut être modifiée et remplacée par autre chose, par exemple body.
Pour plus d’informations, reportez-vous à la documentation d’aide en ligne de Target .

Trigger View (Déclenchement d’affichage)

Déclenche un affichage pour vos applications d’une seule page.
  1. Spécifiez le nom d’affichage qui doit être déclenché.
  2. Précisez si le déclenchement de la vue doit être attribué à une impression de reporting en cochant la case Page. Si l’affichage est corrélé à un composant qui est à nouveau rendu et n’est pas attribué à une impression de reporting, ne cochez pas la case Page.
Pour plus d’informations sur le déclenchement d’un affichage, reportez-vous à la documentation d’aide de .

Déploiement de base d’Adobe Target

Une fois que l’extension Target est installée, créez au moins une règle pour la déployer correctement. Vous devez d’abord charger la bibliothèque Target (at.js), définir les paramètres que vous souhaitez utiliser avec la requête de chargement de page, puis déclencher la requête de chargement de page.
Une règle Target avec cette mise en œuvre de base ressemble à ceci :
Une fois cette règle enregistrée, vous devez l’ajouter à une bibliothèque et la créer/déployer afin de pouvoir tester le comportement.

Extension Adobe Target avec déploiement asynchrone

Launch peut être déployé de manière asynchrone. Si vous chargez la bibliothèque Launch avec Target de manière asynchrone, alors Target sera également chargé de manière asynchrone. Ce scénario est entièrement pris en charge, mais il faut tenir compte d’un autre aspect.
Avec les déploiements asynchrones, il est possible que la page termine de rendre le contenu par défaut avant que la bibliothèque Target ne soit complètement chargée et que le contenu ait été permuté. Cela peut entraîner un « scintillement », c’est-à-dire que le contenu par défaut s’affiche brièvement avant d’être remplacé par le contenu personnalisé spécifié par Target. Si vous souhaitez éviter ce scintillement, nous vous suggérons d’utiliser un fragment de code de masquage préalable et de charger le lot Launch de manière asynchrone pour éviter tout scintillement de contenu.
Voici quelques éléments à garder à l’esprit lors de l’utilisation du fragment de code de masquage préalable :
  • Le code doit être ajouté avant de charger le code incorporé d’en-tête Launch.
  • Ce code ne peut pas être géré par Launch et doit donc être ajouté à la page directement.
  • La page s’affiche lorsque le premier des événements suivants se produit :
    • Lorsque la réponse de chargement de page a été reçue
    • Lorsque la requête de chargement de page arrive à expiration
    • Lorsque le fragment lui-même arrive à expiration.
  • L’action « Fire Page Load Request » (Déclenchement de la requête pendant le chargement de la page) doit être utilisée sur toutes les pages à l’aide du fragment de code de masquage préalable afin de minimiser la durée du masquage.
Le fragment de code de masquage préalable se présente comme suit et peut être réduit. Les options configurables se trouvent à la fin :
;(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 au préalable l’ensemble HTML BODY. Dans certains cas, il est possible de ne masquer que certains éléments HTML et non la totalité de la page. Vous pouvez y parvenir en personnalisant le paramètre de style. Remplacez-le par un élément qui masque préalablement uniquement certaines régions de la page.
Par exemple, si vous disposez de deux régions identifiées par les ID container-1 et container-2, le style peut être remplacé par ce qui suit :
#container-1, #container-2 {opacity: 0 !important}

À la place du code par défaut :
body {opacity: 0 !important}

Par défaut, le fragment de code de masquage préalable expire à 3 000 ms ou 3 secondes. Cette valeur peut être personnalisée.