Attribuer conversions et ventes

Une conversion est une vente ou un paiement de soutien que LinkHarbor peut attribuer à un clic sur votre page. Vous voyez ainsi non seulement combien de fois un lien a été cliqué, mais aussi ce que ce clic a rapporté. Cet article s’adresse aux créateurs qui ont leur propre boutique et aux développeurs qui la connectent. Vous pouvez analyser les conversions et créer des secrets de callback à partir de Creator Pro.

#D’où viennent les conversions

• Les ventes que votre boutique ou votre serveur signale via un callback de vente
• Les paiements des soutiens via Stripe ; un remboursement retire à nouveau la conversion, voir Paiements des soutiens avec Stripe

Chaque conversion reprend les données du clic auquel elle appartient : page, lien, pays, appareil, référent et paramètres UTM. C’est pourquoi elle apparaît dans les statistiques exactement là d’où venait le clic.

#Comment fonctionne l’attribution

1. Un visiteur clique sur un lien de votre page
2. LinkHarbor compte le clic et, lors de la redirection, ajoute à l’URL cible le paramètre lt_click_id avec un ID de clic unique
3. Votre page cible (par exemple la boutique) lit lt_click_id dans l’adresse et le conserve jusqu’à l’achat
4. Après l’achat, votre serveur envoie à LinkHarbor un callback de vente avec cet ID de clic
5. La conversion apparaît sur le tableau de bord et dans les statistiques de la page

L’ID de clic n’est ajouté qu’aux cibles commençant par http:// ou https://. Les liens mailto: ou tel: n’en reçoivent pas, car le paramètre y fausserait l’objet ou le numéro de téléphone. Les clics des bots ne reçoivent pas non plus d’ID de clic.

#Créer un secret de callback

Un callback de vente doit s’identifier avec un secret de callback. Les propriétaires et les admins gèrent les secrets à partir de Creator Pro sous « Callback et API », dans la section compte du menu.

1. Ouvrez « Callback et API »
2. Dans la carte « Secrets Callback », cliquez sur « + Créer un nouveau secret »
3. Saisissez éventuellement un nom, par exemple « Callback boutique »
4. Cliquez sur « Créer le secret »
5. Copiez le secret immédiatement : il n’est affiché qu’une seule fois

« Modifier »

Modifie le nom et le statut (Actif ou Inactif). Un secret inactif est refusé.

« ↺ Régénérer »

Crée un nouveau secret. L’ancien cesse immédiatement de fonctionner – saisissez donc tout de suite le nouveau dans votre boutique.

« Supprimer »

Supprime le secret après une demande de confirmation.

« Dernier callback : »

Indique quand le secret a été utilisé pour la dernière fois, sinon « Pas encore utilisé ».

Vous pouvez créer jusqu’à 5 secrets de callback par espace de travail.

#Envoyer le callback de vente

Votre serveur envoie une requête POST à l’API LinkHarbor. Le secret figure dans l’en-tête X-Callback-Secret.

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
    "order_id": "B-10042",
    "amount": "49.90",
    "currency": "EUR"
  }'

click_id

Obligatoire. L’ID de clic issu de lt_click_id (10 à 36 caractères).

order_id

Obligatoire. Votre numéro de commande (1 à 128 caractères). Une seule conversion est comptée par numéro de commande, un callback répété n’en crée donc pas une seconde.

amount

Obligatoire. Le montant sous forme de nombre décimal.

currency

Obligatoire. Un code de devise de 3 lettres, par exemple EUR.

occurred_at, meta

Facultatif. L’heure de l’achat et jusqu’à 50 clés personnalisées (de 1 à 64 caractères chacune) avec des informations supplémentaires. Une valeur est un texte de 500 caractères au maximum, un nombre, true/false ou null ; l’API refuse les objets imbriqués.

Réponses

Tous les champs et codes d’erreur pour les développeurs se trouvent dans Envoyer des ventes et des données personnalisées.

#Analyser les conversions

• Tableau de bord : les tuiles « Conversions » et « CVR » et la carte « Conversions » par source et support UTM
• Statistiques de page : la carte « Conversions » avec « CVR total », « CVR unique » et « Répartition »
• CVR total = conversions divisées par clics ; CVR unique = conversions divisées par clics uniques