Comment mesurer les ouvertures des emails marketing grâce au SDK Piano Analytics ?

Vous pouvez mesurer les ouvertures d'e-mails marketing avec Piano Analytics en intégrant un événement brut dans vos e-mails à l'aide d'une balise <img> (un pixel de tracking). Lorsque l'e-mail est ouvert et que les images sont autorisées à se charger, le pixel est demandé et Piano Analytics reçoit un événement d'ouverture.

Cette implémentation s'appuie sur l'API de Collecte (et non sur un SDK s'exécutant dans le client e-mail).

Principe : envoyer un événement offsite avec un pixel de tracking

Pour tracker les ouvertures d'e-mails, vous devez utiliser l'événement offsite :

• Nom de l'événement : email.display.offsite

Placez un pixel invisible en haut de votre HTML d'e-mail pour qu'il se charge dès que l'e-mail est ouvert.

Exemple de pixel (recommandé : paramètre events encodé en URL)

<img
  src="https://<collection-domain>/event?s=<site-id>&events=%5B%7B%22name%22%3A%22email.display.offsite%22%2C%22data%22%3A%7B%22src_medium%22%3A%22email%22%2C%22src_campaign%22%3A%22email%20campaign%22%7D%7D%5D"
  width="1"
  height="1"
  style="display:none;"
  alt=""
/>

Vous devez adapter l'attribut src avec :

• <collection-domain> : votre domaine de collecte de données Piano Analytics

• <site-id> : votre ID de site

Ces valeurs sont disponibles dans votre interface Piano Analytics (Data Collection).

Vous pouvez modifier les valeurs de src_medium et src_campaign selon vos besoins.

Propriétés requises et Data Model

Au minimum, incluez ces propriétés dans la charge utile de l'événement pour identifier la source :

• src_medium (par exemple : email)

• src_campaign (le nom de votre campagne)

Si vous utilisez des propriétés personnalisées (y compris des propriétés src_* supplémentaires comme src_email_id), assurez-vous qu'elles sont déclarées dans votre Data Model, sinon elles pourraient ne pas être disponibles pour le reporting.

Tracking des ouvertures uniques (déduplication)

Les pixels d'ouverture d'e-mail peuvent être chargés plusieurs fois (réouvertures, e-mails transférés, certains clients préchargeant les images). Si vous voulez estimer les ouvertures uniques, ajoutez un identifiant unique par destinataire (ou par envoi) et dédupliquez dans le reporting, par exemple :

• src_email_id : un ID unique pour le destinataire/message

Exemple (JSON affiché pour la lisibilité - assurez-vous d'un encodage URL approprié lorsqu'il est utilisé dans l'URL src) :

<img
  src='https://<collection-domain>/event?s=<site-id>&events=[{"name":"email.display.offsite","data":{"src_medium":"email","src_campaign":"your_campaign_name","src_email_id":"unique_id"}}]'
  width="1"
  height="1"
  style="display:none;"
  alt=""
/>

Limitations importantes de la mesure d'ouverture d'e-mail

• Blocage des images : De nombreux clients e-mail bloquent les images par défaut. Si les images ne se chargent pas, le pixel ne se déclenchera pas et l'ouverture ne sera pas trackée.

• Non lié aux visites onsite : Les événements *.offsite sont collectés en dehors du contexte de votre site/app. Ils ne sont généralement pas associés aux identifiants onsite standard (comme visit_id / visitor_id) et sont mieux utilisés comme compteurs et pour l'analyse au niveau de la campagne.

• HTTPS requis : Utilisez https:// pour éviter les avertissements de contenu mixte/sécurité et améliorer la délivrabilité.