Tracking des diffusions
⚠️ Cette section n'est valable que pour les diffuseurs de missions par API et/ou par campagne. Dans les widgets, les impressions de missions sont automatiquement capturées.
Last updated
⚠️ Cette section n'est valable que pour les diffuseurs de missions par API et/ou par campagne. Dans les widgets, les impressions de missions sont automatiquement capturées.
Last updated
Sur la partie gauche, dans le cadre bleu (Site diffuseur B, vous), l'API traque les impressions.
Sur la partie droite, dans le cadre vert (Site annonceur A), l'API traque plusieurs étapes du parcours de l'engagement. L'API peut ainsi donner des statistiques consolidées à ses partenaires :
sur le nombre de candidatures pour une mission donnée.
sur le nombre d'inscriptions (ou de création de comptes) sur le site annonceur
L'API Engagement appelle impression, la vue d'une page de mission (ou d'un élément portant un lien tracké comme par exemple un bouton ou une bannière dans le cadre d'une campagne) par un utilisateur sur votre site/appli.
Pour que l'API comptabilise une impression, il faut que la mission ou l'élément portant un lien tracké API soit visualisé au moins 1,5 seconde par l'internaute.
L'API Engagement permet aux annonceurs et diffuseurs de faciliter l'engagement en France en mettant à disposition d'outils facilitant la mise en relation entre bénévoles/volontaires et organisations.
Pour rendre compte de la performance de cette mise en relation et afin de fournir à ses partenaires annonceurs et diffuseurs des statistiques poussées, l'API demande de transmettre ces informations d'impressions :
les diffuseurs peuvent ainsi valoriser leur impact en mesurant combien de fois une mission ou une campagne a été exposée à ses visiteurs.
les annonceurs peuvent comprendre où ont été diffusées leurs missions et quel est le niveau d'attractivité de leur offre par rapport aux redirections (clics) et candidatures reçues.
Toutes les missions de bénévolat et volontariat diffusées par API.
Les liens trackés qui seront cliqués sur votre site ou application (exemples : des boutons ou des images figurant sur votre site). ⚠️ En revanche, les liens trackés placés dans des emails ne peuvent pas faire l'objet d'un tracking d'impressions.
La Balise API Engagement, doit être ajoutée en haut de la balise <head> et avant tout autre script ou balise CSS.
Ce script effectue trois actions principales :
Crée un élément <script> pour démarrer le téléchargement asynchrone de la bibliothèque JavaScript jstag.js depuis https://app.api-engagement.beta.gouv.fr/jstag.js
Initialise une fonction globale apieng (appelée "file d'attente de commandes apieng()") permettant de planifier l'exécution des commandes une fois la bibliothèque jstag.js chargée et prête à être utilisée
Ajoute la commande apieng() à la varaiable window qui permet d'accéder à toutes les fonctionnalités de tracking de l'API Engagement.
Pour le vérifier, il vous suffit de faire clic droit, puis "Inspecter". Dans la console, vous devez voir un lien dans la balise de type <a href="https://api.api-engagement.beta.gouv.fr/r/......."> </a>
Si ce lien est visible, alors il n'y a rien de plus à faire et l'API pourra tracker les impressions.
⚠️ S'il n'est pas possible de mettre le lien visible tel que mentionné ci-dessus, consultez l'alternative expliquée ci-dessous :
Le rajout de la balise décrite en (1.) reste requis. Cependant, si l'implémentation décrite en (2.) ne convient pas, alors il est possible de tracker les impressions via la méthode du pixel.
Sur le bouton (ou la bannière) qui sert à rediriger les utilisateurs vers la page cible (de l'annonceur), vous devez ajouter une balise <span> de la forme suivante :
où tracker_counter n’est pas à changer (c’est avec ce nom que le script retrouve le tracker) et mission_id est l’identifiant que l’API fournit de la mission.
