Links

Pixel de conversion

Suivez les conversions sur des pages de destination que vous ne contrôlez pas, attribuées au clic et à la variante A/B d'origine.

Les tests A/B de liens courts peuvent envoyer les visiteurs vers une page de destination que vous ne contrôlez pas — une boutique, un constructeur de pages d'arrivée, le site d'un partenaire. Styrar mesure le clic et la variante sur laquelle le visiteur est arrivé, mais n'a aucun moyen de savoir si ce visiteur a converti après la redirection.

Le pixel de conversion comble cet écart. C'est un petit script que vous intégrez sur la page de destination, qui renvoie les conversions à Styrar, corrélées au clic exact (et à la variante A/B) qui a envoyé le visiteur là-bas.

Comment ça fonctionne

Lorsqu'un lien court redirige un visiteur, Styrar ajoute un jeton à usage unique styrar_ck à l'URL de destination.
Le script du pixel sur cette page lit le jeton dans l'URL (ou dans localStorage, pour qu'il survive à une navigation ultérieure sur votre site) et le garde prêt à être envoyé avec n'importe quel événement.
Vous appelez window.styrar.track(eventName, data) — ou ajoutez un attribut data-styrar-track — lorsqu'un visiteur fait quelque chose qui compte (s'inscrit, passe à la caisse, démarre un essai).
Styrar résout le jeton vers le lien et la variante A/B d'origine, et la conversion apparaît dans le panneau d'expérience de ce lien.

Il n'y a aucun identifiant de compte, identifiant de site ou clé API à configurer. Le jeton lui-même est la seule chose qui relie un événement à votre espace de travail, et il est limité à un seul clic.

Mettre en place un pixel de conversion

1. Trouvez votre extrait à intégrer

Ouvrez le panneau Avancé → Test A/B du lien court dans le tableau de bord et démarrez (ou configurez) une expérience. Le panneau affiche une carte « Suivre les conversions sur la page de destination » avec un extrait prêt à copier :

HTML

<script src="https://api.styrar.com/v1/pixel/styrar.js" async></script>
<!-- mark a conversion -->
<button data-styrar-track="signup">Sign up</button>
<!-- or call it from your own code -->
<script>window.styrar && window.styrar.track('signup', { value: 19.99 })</script>

2. Ajoutez la balise script à votre page de destination

Collez la balise <script src="…/v1/pixel/styrar.js"> dans la page sur laquelle les visiteurs arrivent après la redirection du lien court — dans le <head> ou juste avant </body>. Cela fonctionne sur n'importe quelle plateforme (Shopify, Webflow, un site statique, votre propre application) car le pixel et son point de terminaison de suivi utilisent une politique CORS ouverte et sans cookies.

3. Marquez une conversion

Choisissez ce qui convient le mieux à votre page :

Déclaratif, sans JavaScript de votre part :

HTML

<button data-styrar-track="signup">Sign up</button>
<form data-styrar-track="checkout_complete">…</form>

Un click déclenche l'événement sur la plupart des éléments ; sur un <form>, il se déclenche plutôt sur submit.

Depuis votre propre code, une fois le script chargé :

HTML

<script>
  window.styrar && window.styrar.track('purchase', { value: 49.99 })
</script>

4. Confirmez que ça fonctionne

Déclenchez la conversion sur la page de destination, puis ouvrez le panneau de test A/B du lien — le nombre et le taux de conversion de la variante se mettent à jour une fois l'événement reçu.

Valeurs de conversion personnalisées

window.styrar.track(eventName, data) accepte n'importe quel nom d'événement et un objet data optionnel :

HTML

<script>
  window.styrar.track('purchase', {
    value: 49.99,          // numeric — stored as the event's value
    plan: 'pro_annual',    // any other field is stored alongside the event
    currency: 'USD',
  })
</script>

Champ	Type	Comportement
`eventName`	string	Requis. Jusqu'à 64 caractères — utilisez ce qui convient à votre funnel : `signup`, `add_to_cart`, `purchase`, etc.
`value`	number	Stocké uniquement s'il s'agit d'un `number` JS (par exemple le revenu de la commande). Tout autre type est ignoré.
tout autre champ de `data`	toute valeur JSON	Stocké avec l'événement (jusqu'à 4 Ko sérialisés). Les charges utiles plus volumineuses sont rejetées, pas tronquées.

Il n'y a pas de schéma à enregistrer au préalable — appelez track() avec la forme qui convient à votre page, et elle est conservée avec l'événement.

Signaler des conversions depuis votre serveur

Si la conversion se produit côté serveur (un webhook de votre prestataire de paiement, par exemple) plutôt que dans le navigateur, lisez le paramètre styrar_ck sur la requête d'origine et envoyez-le directement :

RequestPOST

Content-Type: application/json

{
  "clickToken": "the styrar_ck value",
  "eventName": "purchase",
  "value": 49.99
}

Response200 OK

{
  "ok": true
}

C'est la même requête non authentifiée que celle effectuée par le pixel du navigateur. Il n'y a pas de clé API — le clickToken est limité à un usage unique sur un seul clic et n'est pas énumérable, il fait donc également office d'identifiant.

Référence de l'API

Plain text

GET  /v1/pixel/styrar.js   # the embeddable script, no auth required
POST /v1/pixel/track        # records a conversion event, no auth required

Corps de POST /v1/pixel/track :

Champ	Requis	Description
`clickToken`	Oui	La valeur `styrar_ck` provenant de l'URL de destination ou de `localStorage`
`eventName`	Oui	Jusqu'à 64 caractères
`value`	Non	Nombre, par exemple la valeur de la commande
`eventData`	Non	Objet JSON arbitraire, jusqu'à 4 Ko sérialisés
`pageUrl`	Non	Jusqu'à 2048 caractères ; le script envoie automatiquement `window.location.href`

Le point de terminaison répond toujours 200 { "ok": true } — y compris pour un clickToken non reconnu ou expiré — de sorte que le pixel ne fait jamais apparaître d'erreur sur une page que vous ne contrôlez pas entièrement.

Confidentialité et sécurité

Le pixel n'envoie que le jeton de clic, le nom/valeur/données de l'événement que vous lui transmettez, et l'URL de la page actuelle. Aucun cookie, empreinte numérique ou identifiant intersite n'est impliqué.
/v1/pixel/track est limité en débit par IP (120 requêtes/minute) pour absorber les abus sans affecter le trafic normal.
clickToken est un identifiant aléatoire à usage limité à un clic — il ne peut pas être déduit du code court d'un lien ni d'aucune autre valeur publique.

Limites

Le suivi de conversion nécessite qu'un test A/B soit configuré sur le lien ; la conversion est attribuée à la variante affichée au visiteur au moment du clic.
Il n'y a pas de suivi automatique des pages vues — le pixel ne signale que les événements que vous déclenchez explicitement, afin de limiter le bruit et le volume de requêtes.
Pas encore de point de terminaison d'export ou de suppression en masse pour les événements de conversion ; contactez-nous si vous avez besoin de faire supprimer des données pour un espace de travail spécifique.

Liens utiles

Webhooks — soyez notifié lorsqu'un test A/B se termine via link.experiment.completed
Liens courts et codes QR dans le centre d'aide
Trackers de page bio — Google Analytics, Meta, GTM et plus sur votre page bio
Installer ce pixel par plateforme : Shopify · WordPress · Wix · Framer · Côté serveur