Peut-on marquer une page par l'intermédiaire d'un élément HTML "iframe" ?

Oui. Un iframe peut contenir des tags Piano Analytics, ainsi que tout JavaScript nécessaire pour mesurer le contenu propre à l'iframe (par exemple, les clics et autres interactions).

Où implémenter le marquage

Le marquage doit être implémenté sur la page enfant (la page chargée à l'intérieur de l'iframe), et non sur la page parente. Tout le code inclus dans le contenu de l'iframe est exécuté dans le contexte de l'iframe et peut envoyer des événements normalement.

Lorsqu'un iframe est chargé sur une page partenaire, tout le marquage contenu dans l'iframe s'exécutera toujours, car il fonctionne comme partie intégrante du document de l'iframe.

Approche recommandée : utiliser la dernière bibliothèque Piano Analytics (SDK)

Nous recommandons d'utiliser la dernière version de la bibliothèque JavaScript Piano Analytics pour marquer un iframe.

1. Chargez la bibliothèque sur la page de l'iframe :

   CODE

   <script type="text/javascript" src="https://tag.aticdn.net/piano-analytics.js"></script>

2. Configurez le SDK (exemple) :

   CODE

   pa.setConfigurations({ site: 123456, collectDomain: "https://votre-domaine-de-collecte.com" });

3. Envoyez des événements comme d'habitude (exemple) :

   CODE

   pa.sendEvent('page.display', { page: 'Nom_Page' });

Toutes les méthodes disponibles dans le SDK Piano Analytics peuvent être utilisées dans un iframe. L'iframe peut être traité comme une page normale chargée dans un document parent.

Espaces de noms et éviter les conflits (important)

Nos SDK utilisent des variables globales, qui peuvent créer des conflits si du code analytique est présent à la fois sur :

• la page parente où l'iframe est intégré, et

• le contenu de l'iframe lui-même

Pour éviter les conflits, utilisez des espaces de noms uniques afin que les objets globaux et la configuration n'entrent pas en collision entre la page parente et l'iframe.

Considérations inter-domaines (identification du visiteur)

Si la page parente et l'iframe sont sur des domaines différents, l'identification du visiteur peut ne pas s'aligner automatiquement entre les deux contextes. Dans ce cas, vous devrez peut-être synchroniser l'ID client entre la page parente et l'iframe pour préserver un suivi cohérent du visiteur dans les deux environnements.