Ajout du code incorporé
Dans cette leçon, vous allez mettre en oeuvre le code incorporé asynchrone de l’environnement de développement de votre propriété de balise. En cours de route, vous découvrirez deux concepts principaux des balises : les environnements et les codes incorporés.
- Le platform launch (côté client) est désormais tags
- Le platform launch côté serveur est désormais event forwarding
- Les configurations Edge sont désormais datastreams
Objectifs d’apprentissage
À la fin de cette leçon, vous saurez comment :
- Obtention du code incorporé de votre propriété de balise
- différencier environnement de développement, d’évaluation et de production ;
- Ajout d’un code incorporé de balise à un document HTML
- Expliquer l’emplacement optimal du code incorporé de balise par rapport à d’autres codes dans le
<head>
d’un document HTML
Copie du code incorporé
Le code incorporé est une balise <script>
que vous placez sur vos pages web pour charger et exécuter la logique que vous créez dans les balises . Si vous chargez la bibliothèque de manière asynchrone, le navigateur continue à charger la page, récupère la bibliothèque de balises et l’exécute parallèlement. Dans ce cas, il n’y a qu’un seul code incorporé à placer dans l’élément <head>
. (Lorsque les balises sont déployées de manière synchrone, il existe deux codes incorporés, l’un que vous placez dans le <head>
et l’autre que vous placez avant le </body>
.)
Dans l’écran Présentation de la propriété, cliquez sur Environments dans le volet de navigation de gauche pour accéder à la page des environnements. Notez que les environnements de développement, d’évaluation et de production ont déjà été créés pour vous.
Les environnements de développement, d’évaluation et de production correspondent aux environnements typiques du processus de développement et de mise à jour du code. Le code est d’abord écrit par un développeur dans un environnement de développement. Lorsqu’ils ont terminé leur travail, les développeurs envoient le code à un environnement d’évaluation où il est révisé par des équipes d’assurance qualité et d’autres équipes. Une fois que les équipes d’assurance qualité et les autres équipes sont satisfaites, le code est publié dans l’environnement de production, qui est l’environnement sur lequel les visiteurs arrivent lorsqu’ils se connectent à votre site web.
Les balises permettent d’autres environnements de développement, ce qui s’avère utile pour les grandes entreprises où plusieurs développeurs travaillent simultanément sur différents projets.
Ce sont les seuls environnements nécessaires pour suivre jusqu’au bout ce tutoriel. Les environnements vous permettent de disposer de différentes versions opérationnelles de vos bibliothèques de balises hébergées à différentes URL, afin que vous puissiez ajouter de nouvelles fonctionnalités et les mettre à la disposition des utilisateurs appropriés (par exemple, développeurs, ingénieurs qualité, public, etc.). au moment opportun.
Copions maintenant le code incorporé :
-
Sur la ligne Développement, cliquez sur l’icône Installer
-
Notez que les balises sont définies par défaut sur les codes incorporés asynchrones.
-
Cliquez sur l’icône Copier
-
Cliquez sur Fermer pour fermer le modal.
Mise en œuvre du code incorporé dans l’élément <head>
de la page HTML d’exemple
Le code incorporé doit être mis en œuvre dans l’élément <head>
de toutes les pages HTML qui partageront la propriété. Il se peut qu’un ou plusieurs fichiers de modèle contrôlent l’ <head>
sur l’ensemble du site, ce qui simplifie le processus d’ajout de balises.
Si ce n’est déjà fait, copiez l’exemple de code de page HTML et collez-le dans un éditeur de code. Si vous en avez besoin, Brackets est un éditeur libre et open source.
code language-html |
---|
|
Remplacez le code incorporé existant sur la ligne 34, ou autour de celle-ci, par le code du presse-papiers et enregistrez la page. Ouvrez ensuite la page dans un navigateur web. Si vous chargez la page à l’aide du protocole file://
, vous devez ajouter « https: » au début de l’URL du code incorporé dans l’éditeur de code. Les lignes 33 à 36 de votre page d’exemple devraient ressembler à ceci :
<!--Tags Header Embed Code: REPLACE LINE 39 WITH THE EMBED CODE FROM YOUR OWN DEVELOPMENT ENVIRONMENT-->
<script src="https://assets.adobedtm.com/launch-ENa21cfed3f06f4ddf9690de8077b39e81-development.min.js" async></script>
<!--/Tags Header Embed Code-->
Ouvrez les outils de développement de votre navigateur web et accédez à l’onglet Réseau. À ce stade, une erreur 404 devrait s’afficher pour l’URL de l’environnement de balises :
L’erreur 404 est attendue car vous n’avez pas encore créé de bibliothèque dans cet environnement de balises. Ce point sera abordé dans la leçon suivante. Si un message d’erreur « fail » s’affiche à la place d’une erreur 404, vous avez probablement oublié d’ajouter le protocole https://
au code incorporé. Là encore, il suffit d’ajouter https://
si vous chargez la page d’exemple à l’aide du protocole file://
. Effectuez cette modification et rechargez la page jusqu’à ce que l’erreur 404 s’affiche.
Bonnes pratiques de mise en oeuvre des balises
Prenez quelques instants pour passer en revue certaines des bonnes pratiques de mise en oeuvre des balises qui sont illustrées dans la page d’exemple :
-
Couche de données :
-
Nous vous recommandons de créer une couche de données sur votre site contenant tous les attributs nécessaires pour renseigner les variables dans Analytics, Target et d’autres solutions marketing. Cette page d’exemple ne contient qu’une couche de données très simple, mais une véritable couche de données peut contenir beaucoup plus de détails à propos de la page, du visiteur, des informations sur son panier, etc. Pour plus d’informations sur les couches de données, consultez le document Customer Experience Digital Data Layer 1.0.
-
Définissez votre couche de données avant le code incorporé de balise afin d’optimiser ce que vous pouvez faire avec les solutions Experience Cloud.
-
-
Bibliothèques d’assistance JavaScript : si une bibliothèque comme JQuery est déjà implémentée dans le
<head>
de vos pages, chargez-la avant les balises afin d’exploiter sa syntaxe dans les balises et dans Target. -
Doctype HTML5 : Target a besoin du doctype HTML5.
-
preconnect et dns-prefetch : utilisez preconnect and dns-prefetch pour améliorer le temps de chargement de la page. Voir aussi : https://w3c.github.io/resource-hints/
-
fragment de code de pré-masquage pour les implémentations asynchrones de Target : Vous en apprendrez plus à ce sujet dans la leçon sur Target. Cependant, lorsque Target est déployé via des codes incorporés de balise asynchrones, vous devez coder en dur un fragment de code de pré-masquage sur vos pages avant les codes incorporés de balise afin de gérer le scintillement de contenu.
Voici un résumé des bonnes pratiques décrites ci-dessus dans l’ordre conseillé. Notez qu’il existe des espaces réservés pour les détails spécifiques au compte :
<!doctype html>
<html lang="en">
<head>
<title>Basic Demo</title>
<!--Preconnect and DNS-Prefetch to improve page load time. REPLACE "techmarketingdemos" WITH YOUR OWN AAM PARTNER ID, TARGET CLIENT CODE, AND ANALYTICS TRACKING SERVER-->
<link rel="preconnect" href="//dpm.demdex.net">
<link rel="preconnect" href="//fast.techmarketingdemos.demdex.net">
<link rel="preconnect" href="//techmarketingdemos.demdex.net">
<link rel="preconnect" href="//cm.everesttech.net">
<link rel="preconnect" href="//techmarketingdemos.tt.omtrdc.net">
<link rel="preconnect" href="//techmarketingdemos.sc.omtrdc.net">
<link rel="dns-prefetch" href="//dpm.demdex.net">
<link rel="dns-prefetch" href="//fast.techmarketingdemos.demdex.net">
<link rel="dns-prefetch" href="//techmarketingdemos.demdex.net">
<link rel="dns-prefetch" href="//cm.everesttech.net">
<link rel="dns-prefetch" href="//techmarketingdemos.tt.omtrdc.net">
<link rel="dns-prefetch" href="//techmarketingdemos.sc.omtrdc.net">
<!--/Preconnect and DNS-Prefetch-->
<!--Data Layer to enable rich data collection and targeting-->
<script>
var digitalData = {
"page": {
"pageInfo" : {
"pageName": "Home"
}
}
};
</script>
<!--/Data Layer-->
<!--jQuery or other helper libraries-->
<script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>
<!--/jQuery-->
<!--prehiding snippet for Adobe Target with asynchronous tags deployment-->
<script>
(function(g,b,d,f){(function(a,c,d){if(a){var e=b.createElement("style");e.id=c;e.innerHTML=d;a.appendChild(e)}})(b.getElementsByTagName("head")[0],"at-body-style",d);setTimeout(function(){var a=b.getElementsByTagName("head")[0];if(a){var c=b.getElementById("at-body-style");c&&a.removeChild(c)}},f)})(window,document,"body {opacity: 0 !important}",3E3);
</script>
<!--/prehiding snippet for Adobe Target with asynchronous tags deployment-->
<!--Tags Header Embed Code: REPLACE LINE 39 WITH THE INSTALL CODE FROM YOUR OWN DEVELOPMENT ENVIRONMENT-->
<script src="//assets.adobedtm.com/launch-EN93497c30fdf0424eb678d5f4ffac66dc.min.js" async></script>
<!--/Tags Header Embed Code-->
</head>
<body>
<h1>Tags Basic Demo</h1>
<p>This is a very simple page to demonstrate basic concepts of tags</p>
</body>
</html>
Vous savez maintenant comment ajouter le code incorporé de balise à votre site.
Suite : "Ajout d’un élément de données, d’une règle et d’une bibliothèque" >