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é.

Plus d'informations sur le marquage d'ouverture d'e-mail peuvent être trouvées à : Mesure d'ouverture d'e-mail.

Il vous sera en effet possible de mesurer l'ouverture d'email grâce au SDK Piano Analytics. Afin de suivre l'ouverture des e-mails avec le marquage Piano Analytics, il est obligatoire de créer un événement brut, intégré dans les e-mails à l'intérieur d'une balise <img>.

Pour cela, vous devrez utiliser l'évènement "email.display.offsite".

Un pixel invisible qui doit être implémenté dans le haut de votre email pour être chargé dès l'ouverture de l'email et ainsi envoyer le hit d'ouverture vers nos serveurs.

Voici un exemple de code pour le pixel invisible :

<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">

Comme vous le constaterez, vous devrez adapter l'attribut "src" avec votre domaine de collecte, ainsi qu'avec l'ID de site.

Ces derniers pourront être trouvés dans l'interface "Site Management" de vos interfaces : https://collection.atinternet-solutions.com/#/sites-management . 

Cette manière de procéder se base sur la Collection API. De nombreuses informations sont disponibles à ce sujet en suivant le lien suivant : https://developers.atinternet-solutions.com/piano-analytics/data-collection/how-to-send-events/collection-api#get.

Vous pourrez venir modifier les valeurs de "src_medium" et "src_campaign" selon vos souhaits.

Vous trouverez plus d'informations sur le marquage des ouvertures d'email à l'adresse suivante : Mesure des ouvertures d'Emails

Le support reste à votre disposition pour tout complément d'information sur le sujet.