Les zones

Une zone est un bloc de page que vous voulez suivre : une grille de prix, un bandeau, un bloc d’avis, un encart d’inscription. Marquez-le d’un attribut :

<section data-eodia-zone="tarifs">
  …
</section>

Le script le suit, sans autre code :

• son temps de visibilité : le temps pendant lequel la zone est visible à 50 % au moins, page au premier plan (un onglet en arrière-plan ne compte pas) ;
• les clics qu’elle contient : chaque clic porte la clé de la zone la plus proche.

Les zones ajoutées après le chargement (un carrousel, un rendu côté client) sont trouvées d’elles-mêmes.

La clé

La clé est un texte court, stable, sans espace : tarifs, avis, hero, newsletter-footer (64 caractères au plus). Elle sert aussi de sélecteur stable aux clics : un bouton dans [data-eodia-zone="tarifs"] garde le même sélecteur quand la mise en page change autour de lui.

Déclarer une zone

Dans l’onglet Métadonnées du site, une zone reçoit un libellé et une description :

Clé	Libellé	Description
hero	Bandeau d’accueil	Le grand visuel en haut de la page d’accueil.
avis	Avis clients	Le bloc des avis sous la fiche produit.
tarifs	Grille de prix	Le tableau des prix de la carte cadeau.

Le libellé arrive dans la colonne label de analytics.zone_views, et la liste des zones dans analytics.zones. Une zone non déclarée est mesurée quand même.

Ce que donnent les vues

• analytics.zone_views : une ligne par zone et par page vue, avec visible_seconds et seen (vrai si la zone est restée visible au moins une seconde) ;
• analytics.clicks : une ligne par clic, avec selector, zone, la position relative x et y (de 0 à 1 dans l’élément) et l’appareil.

-- Part des pages vues où la grille de prix a vraiment été vue, par appareil
SELECT p.device,
       avg(CASE WHEN z.seen THEN 1.0 ELSE 0 END) AS part_vue,
       avg(z.visible_seconds)                    AS secondes
FROM analytics.zone_views z
JOIN analytics.page_views p ON p.page_view_id = z.page_view_id
WHERE z.zone = 'tarifs'
GROUP BY 1

Cartes de chaleur

Les positions relatives des clics et les temps de visibilité des zones servent aux cartes de chaleur : avec data-preview dans la balise, une page ouverte par eodia insights en #eodia-preview ne mesure plus rien et dessine, sur la vraie page, la carte que lui envoie insights. Seule l’origine d’insights configurée (INSIGHTS_URL) est écoutée.