BibSync

Ressources

Parcourir les guides

Sur cette page
Organisateur
Marketing et croissance8 min

Guide d'intégration du tracking

Connectez votre plateforme d'inscription à BibSync pour suivre les inscriptions générées par les partners. Choisissez la méthode la mieux adaptée à votre configuration.

Google Tag Manager

Si votre site d'inscription utilise GTM, c'est la façon la plus rapide d'intégrer BibSync. Aucun changement de code n'est nécessaire sur votre site, il suffit d'ajouter deux balises dans la console GTM.

Recommandé
1

Balise de base

Créez une balise HTML personnalisée. Définissez le déclencheur sur Toutes les pages.

HTML
<script src="https://bibsync.link/v1/pixel.js" async></script>
<script>
  window.__bsq = window.__bsq || [];
  window.__bsq.push(['init', 'YOUR_CAMPAIGN_SLUG']);
</script>

Remplacez YOUR_CAMPAIGN_SLUG par le slug de votre campagne depuis les paramètres de tracking BibSync.

2

Balise d'inscription

Créez une autre balise HTML personnalisée. Définissez le déclencheur pour qu'il se lance uniquement sur votre page de remerciement ou de confirmation.

HTML
<script>
  window.__bsq = window.__bsq || [];
  window.__bsq.push(['track', {
    orderId: {{Transaction ID}},
    amount: {{Purchase Value}}
  }]);
</script>

Remplacez {{Transaction ID}} et {{Purchase Value}} par vos variables GTM.

3

Événement dataLayer optionnel

Si votre checkout pousse déjà les données d'achat dans le dataLayer, mappez ces champs dans votre balise d'inscription.

JavaScript
dataLayer.push({
  'event': 'purchase',
  'transactionId': 'ORDER-123',
  'transactionTotal': 49.99
});

Déclenchez cet événement avant le chargement de la page de confirmation afin que GTM puisse lancer la balise d'inscription avec les valeurs finales.

4

Publier et tester

Publiez le conteneur GTM, effectuez une inscription test réelle et vérifiez que l'événement apparaît dans BibSync.

JavaScript personnalisé

Utilisez cette option si vous pouvez modifier directement vos pages d'inscription et votre flux de confirmation.

1

Script de base

Ajoutez le script de base BibSync sur chaque page d'inscription où arrive le trafic partner.

HTML
<!-- BibSync Tracking Pixel -->
<script src="https://bibsync.link/v1/pixel.js" async></script>
<script>
  window.__bsq = window.__bsq || [];
  window.__bsq.push(['init', 'YOUR_CAMPAIGN_SLUG']);
</script>

Remplacez YOUR_CAMPAIGN_SLUG par le slug de votre campagne depuis les paramètres de tracking BibSync.

2

Script d'inscription

Déclenchez l'événement d'inscription après un achat réussi sur la page de confirmation.

HTML
<script>
  window.__bsq = window.__bsq || [];
  window.__bsq.push(['track', {
    orderId: 'YOUR_ORDER_ID',
    amount: 49.99
  }]);
</script>

Remplacez YOUR_ORDER_ID et 49.99 par votre identifiant de commande réel et votre valeur d'achat.

3

Vérifier le flux

Effectuez une inscription test et confirmez que le clic et l'inscription sont visibles dans BibSync.

Webhook server-to-server

Signez le payload JSON brut avec le secret de votre campagne en HMAC-SHA256 et envoyez le digest dans l'en-tête X-BibSync-Signature.

Choisissez cette option uniquement si votre équipe peut envoyer des requêtes backend signées. C'est la configuration la plus souple, mais elle nécessite du travail d'ingénierie.

Comment cela fonctionne

  • Capturez le click ID BibSync lorsqu'un partner envoie un visiteur vers votre site.
  • Conservez ce click ID jusqu'à la fin de l'inscription.
  • Envoyez l'inscription finalisée depuis votre backend vers BibSync avec une signature HMAC.

Endpoint

HTTP
POST https://bibsync.link/api/v1/s2s

Exemple de payload

JSON
{
  "clickId": "bs_clk_abc123xyz789abc123",
  "externalOrderId": "RTS-998877",
  "amount": 25.00,
  "currency": "EUR"
}

Exemple Node.js

JavaScript
const crypto = require('crypto');
const secret = process.env.BIBSYNC_S2S_SECRET;
const body = JSON.stringify({
  clickId: req.query.bs_id,
  externalOrderId: order.id,
  amount: order.totalAmount,
  currency: 'EUR',
});
const signature = crypto
  .createHmac('sha256', secret)
  .update(body)
  .digest('hex');

await fetch('https://bibsync.link/api/v1/s2s', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-BibSync-Signature': signature,
  },
  body,
});

Exemple Python

Python
import hmac, hashlib, json, os, requests

secret = os.environ["BIBSYNC_S2S_SECRET"]
body = json.dumps({
    "clickId": request.args.get("bs_id"),
    "externalOrderId": order.id,
    "amount": order.total_amount,
    "currency": "EUR",
})
signature = hmac.new(
    secret.encode(), body.encode(), hashlib.sha256
).hexdigest()

requests.post(
    "https://bibsync.link/api/v1/s2s",
    headers={
        "Content-Type": "application/json",
        "X-BibSync-Signature": signature,
    },
    data=body,
)

FAQ et dépannage

Comment tester l'intégration ?

Utilisez un vrai lien partner, effectuez une inscription test sur votre site puis vérifiez que le clic et l'inscription apparaissent dans BibSync.

Pourquoi vois-je des partner clicks at risk ?

Cela signifie que BibSync a reçu des clics partner, mais que ces visiteurs n'ont pas encore généré d'inscription dans la fenêtre attendue.

Que se passe-t-il si le tracking passe hors ligne ?

BibSync avertit les organisateurs après 24 heures sans données et met automatiquement la campagne en pause après 48 heures jusqu'au rétablissement du tracking.

Puis-je utiliser plusieurs méthodes d'intégration ?

Utilisez une seule méthode principale par campagne pour éviter les inscriptions en double. En cas de migration, désactivez l'ancien flux avant d'activer le nouveau.

En combien de temps les événements apparaissent-ils ?

Les clics apparaissent généralement en quelques secondes. Les inscriptions devraient apparaître peu après le chargement de la page de confirmation ou l'acceptation de la requête S2S.