Conversions et revenus

Le suivi des conversions referme la boucle entre un clic et l’argent qu’il a rapporté. Le redirecteur émet un identifiant signé à chaque redirection ; votre serveur ou votre page de remerciement le renvoie avec une commande ; et chaque répartition que vous lisez déjà gagne une colonne de revenus.

Les conversions sont une fonction payante. Quand le forfait ne les inclut pas, le redirecteur cesse complètement d’émettre des identifiants, et les deux voies de réception refusent les conversions avec une restriction de forfait.

L’identifiant de clic

À chaque redirection, le worker émet un jeton et :

• l’ajoute à l’adresse de destination sous un nom de paramètre que vous choisissez (lp_cid par défaut) ;
• l’écrit dans un cookie propriétaire sur votre domaine de redirection, valable 90 jours.

C’est le cookie qui permet à l’attribution de survivre dans les navigateurs qui n’acceptent plus rien de tiers : il est posé par votre propre domaine, pas par le nôtre.

Le jeton est signé et lié au locataire : les identifiants de l’espace de travail et du partenaire font partie de la charge signée, si bien qu’un jeton émis sur le lien d’un client est refusé dans l’espace de travail d’un autre exactement comme une contrefaçon. Il ne porte aucune donnée personnelle : l’instant du clic, le lien, la variante de répartition, le pays, la classe d’appareil, la source de trafic et un marqueur de trafic suspect.

Le nom du paramètre comme l’interrupteur d’activation vivent dans Conversions → Réglages. Modifier l’un ou l’autre réécrit immédiatement la configuration mise en cache de chaque lien.

La fenêtre d’attribution

Une conversion qui arrive après la fenêtre est refusée avec attribution_expired, un code distinct de invalid_click_id, pour qu’une intégration puisse distinguer « trop tard » et « identifiant cassé » sans deviner. La fenêtre est un réglage par espace de travail.

Objectifs

Un objectif est un résultat nommé : purchase, signup, trial. Les objectifs peuvent porter une valeur par défaut et une devise, utilisées quand une conversion arrive sans montant. Un objectif référencé par une conversion et qui n’existe pas encore est créé à la première utilisation : une intégration n’a donc pas à être configurée à deux endroits.

Envoyer des conversions

Depuis votre serveur

curl -X POST https://api.linkprofit.com/v1/conversions \
  -H "Authorization: Bearer lp_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-10241" \
  -d '{
    "click_id": "1.eyJ1aWQiOiJ...",
    "goal": "purchase",
    "order_id": "10241",
    "amount_cents": 4999,
    "currency": "usd"
  }'

La clé a besoin de la portée conversions:write. Les montants sont des unités minimales entières — centimes, pence, kopecks. Un montant de 49.99 est refusé en nommant le champ plutôt qu’arrondi en silence, parce qu’une règle d’arrondi inventée au milieu d’un parcours de paiement, c’est ainsi que les rapports de revenus cessent discrètement de correspondre aux factures.

Depuis le navigateur

Le worker sert un petit script depuis votre propre domaine de redirection :

<script src="https://go.example.com/cv.js" defer></script>
<script>
  window.lpConversion({ goal: 'purchase', orderId: '10241', amountCents: 4999, currency: 'usd' });
</script>

Le script lit l’identifiant dans l’URL ou dans le cookie propriétaire. Il n’y a aucun hôte tiers dans toute la chaîne, ce qui est à la fois une propriété de confidentialité et une propriété de marque blanche : la page de votre client ne charge rien qui mentionne la plateforme.

Doublons

La déduplication est une seule insertion atomique, pas une lecture suivie d’une écriture. Les envois répétés du même order_id créent une seule conversion et la renvoient marquée comme doublon — c’est précisément ce qui rend la reprise d’un webhook en échec sûre plutôt que dangereuse.

Conversions suspectes

Le verdict du classificateur voyage dans le jeton : une conversion attribuée à un centre de données ou à un proxy est donc marquée comme suspecte au moment de son enregistrement. Elle apparaît dans les rapports comme un segment à part, au lieu d’être supprimée ou mélangée en silence. « Deux cents conversions » et « deux cents conversions, dont quarante venues d’une même plage d’hébergement en une heure » sont des faits différents.

Où vont ensuite les conversions

• Un événement de webhook conversion.created signé est émis par la machinerie de webhooks habituelle : file d’attente, signature, calendrier de relances, cron de rattrapage.
• Les intégrations publicitaires configurées reçoivent la conversion via une file d’envoi dotée d’un compteur de tentatives incrémenté avant l’appel sortant, d’un backoff documenté et d’un marquage d’abandon plutôt que de relances infinies.

Quota mensuel

Un forfait peut plafonner le nombre de conversions acceptées par mois calendaire, comptées en UTC. Au-delà du plafond, la réception répond quota_exceeded — un code distinct d’une restriction de forfait, pour que la différence entre « ce n’est pas dans votre forfait » et « épuisé ce mois-ci » soit visible sans ticket au support.