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.
L’extension Adobe Target requiert at.js. Elle ne prend pas en charge mbox.js.
Si l'extension Adobe Target n'est pas encore installée, ouvrez votre propriété, puis sélectionnez Extensions > Catalog, passez la souris sur l'Extension de la cible et sélectionnez Install.
Pour configurer l'extension, ouvrez l'onglet Extensions, passez la souris sur l'extension, puis sélectionnez Configure.
Tous vos paramètres at.js, à l’exception du délai d’expiration, sont automatiquement récupérés depuis votre configuration at.js dans 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 Adobe Experience Platform Launch si d’autres mises à jour sont nécessaires.
Les options de configuration disponibles sont les suivantes :
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.
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.
Indique le nom de votre requête Target globale. Par défaut, ce nom est target-global-mbox, sauf si vous l’avez modifié dans l’interface utilisateur de Target avant d’ajouter l’extension.
Il peut être modifié à l’aide d’éléments de données.
Le domaine vers lequel les requêtes Target sont envoyées. Cette valeur doit presque toujours être conservée comme valeur par défaut.
Détermine où Target définit des cookies dans les navigateurs.
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.
Plusieurs paramètres disponibles sur la page Edit at.js settings de l’interface utilisateur de Target ne font pas partie de l’extension Target. Voici quelques solutions suggérées :
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 :
Ajoute cette action à l’endroit correspondant de votre règle Platform 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.
Ajoutez des paramètres à toutes les requêtes de mbox. L’action Load Target (Charger Target) doit avoir été utilisée au préalable.
Ajoutez des paramètres uniquement à vos requêtes de mbox globale. L’action Load Target (Charger Target) doit avoir été utilisée au préalable.
Déclenchez la mbox globale sur 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{opacity:0}
. Cette valeur peut être modifiée et remplacée par autre chose, par exemple body{display:none}
.Pour plus d’informations, reportez-vous à la documentation d’aide en ligne de Target.
Une fois que l’extension Target est installée, vous devez créer au moins une règle pour la déployer correctement. Vous devez d’abord charger la bibliothèque Target (at. js), spécifier les paramètres à utiliser avec la mbox globale et déclencher la mbox globale.
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.
Platform Launch peut être déployé de manière asynchrone. Si vous chargez la bibliothèque Platform 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 Platform 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 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.