Suivi par pixel

Utilisez les points de terminaison pixel lorsque vous devez envoyer des événements Convertmax depuis des environnements où une simple requête GET est plus facile qu’exécuter du JavaScript.

Pour le modèle d’événements complet et les noms d’événements pris en charge, voir Suivi des événements.

Points de terminaison pris en charge

Convertmax prend en charge ces deux routes de type pixel :

• GET /px/<event_type>
• GET /pixel

Les deux renvoient un GIF transparent 1x1 une fois l’événement accepté.

Authentification

Les requêtes envoyées à l’hôte Convertmax partagé prennent en charge l’un de ces paramètres de requête :

• key=<api_key>

Pour les hôtes de pixel personnalisés à la marque comme https://t.acme.com, Convertmax peut déduire le compte depuis le mapping de l’hôte, donc aucune clé publique n’est requise sur la requête pixel.

Champs de requête courants

Vous pouvez passer les données d’événement directement dans la chaîne de requête :

• visitor ou uid pour l’identifiant visiteur
• session_id ou sid pour l’identifiant de session
• e pour le nom de l’événement sur /pixel
• data.page, data.title, ou d’autres champs data.* imbriqués
• properties.* pour les propriétés personnalisées imbriquées
• gclid, fbclid, msclk, ttclid, et d’autres identifiants de clic

Convertmax accepte aussi un payload data encodé en base64 pour les cas où empaqueter l’événement dans un seul paramètre est plus simple.

Normalisation du nom d’événement

Les requêtes pixel normalisent automatiquement quelques alias courants :

• page devient page_view
• pageview devient page_view
• purchase devient convert
• add_to_cart devient add_cart
• t devient custom

Exemple de balise basique

<img
  src="https://event.convertmax.io/px/page_view?key=<api_key>&visitor=visitor_123&session_id=session_abc&data.page=https%3A%2F%2Fexample.com%2Flanding"
  alt=""
  height="1"
  width="1"
/>

Exemple /pixel court

<img
  src="https://event.convertmax.io/pixel?key=<api_key>&e=pageview&uid=visitor_123&sid=session_abc"
  alt=""
  height="1"
  width="1"
/>

Exemple de payload base64

<img
  src="https://event.convertmax.io/px/convert?key=<api_key>&data=eyJ2aXNpdG9yIjoidmlzaXRvcl8xMjMiLCJkYXRhIjp7InBhZ2UiOiJodHRwczovL2V4YW1wbGUuY29tL2NoZWNrb3V0In19"
  alt=""
  height="1"
  width="1"
/>

Retro-remplissage du référent

Si le navigateur peut envoyer un référent et que vous voulez que Convertmax l’utilise comme URL de page, ajoutez :

process_headers=true

Lorsque ce flag est présent, Convertmax peut retro-remplir data.page depuis le référent de la requête si vous n’avez pas déjà fourni page explicitement.

Hôtes de pixel first-party à la marque

Convertmax peut accepter des requêtes pixel sur un hôte à la marque tel que :

https://t.acme.com/pixel?e=pageview&uid=123

Sur ces requêtes pixel à la marque, le worker peut déduire le compte depuis l’hôte lui-même, donc vous n’avez pas besoin d’inclure key dans l’URL.

Les domaines de pixel personnalisés à la marque sont configurés par l’équipe Convertmax afin que les requêtes vers votre hôte de suivi résolvent automatiquement vers le bon compte.

Cas d’usage recommandés

• plateformes marketing historiques qui ne prennent en charge que les URL de balise
• pages rendues côté serveur où vous voulez un repli sans JavaScript
• collecte first-party sur des sous-domaines à la marque
• pings légers de page vue et de conversion depuis des environnements contraints