Risorse
Sfoglia le guide
Guida all'integrazione tracking
Collega la tua piattaforma di registrazione a BibSync per tracciare le registrazioni generate dai partner. Scegli il metodo più adatto alla tua configurazione.
Google Tag Manager
Se il tuo sito di registrazione usa GTM, questo è il modo più rapido per integrare BibSync. Non servono modifiche al codice del sito, basta aggiungere due tag nella console GTM.
Tag base
Crea un tag HTML personalizzato. Imposta il trigger su Tutte le pagine.
<script src="https://bibsync.link/v1/pixel.js" async></script>
<script>
window.__bsq = window.__bsq || [];
window.__bsq.push(['init', 'YOUR_CAMPAIGN_SLUG']);
</script>Sostituisci YOUR_CAMPAIGN_SLUG con lo slug della tua campagna nelle impostazioni tracking di BibSync.
Tag di registrazione
Crea un altro tag HTML personalizzato. Imposta il trigger in modo che si attivi solo nella pagina di ringraziamento o conferma.
<script>
window.__bsq = window.__bsq || [];
window.__bsq.push(['track', {
orderId: {{Transaction ID}},
amount: {{Purchase Value}}
}]);
</script>Sostituisci {{Transaction ID}} e {{Purchase Value}} con le tue variabili GTM.
Evento dataLayer opzionale
Se il tuo checkout invia già i dati di acquisto nel dataLayer, mappa quei campi dentro il tag di registrazione.
dataLayer.push({
'event': 'purchase',
'transactionId': 'ORDER-123',
'transactionTotal': 49.99
});Invia questo evento prima del caricamento della pagina di conferma così GTM potrà attivare il tag di registrazione con i valori finali.
Pubblica e testa
Pubblica il container GTM, completa una registrazione di prova reale e conferma che l'evento compaia in BibSync.
JavaScript personalizzato
Usa questa opzione se puoi modificare direttamente le pagine di registrazione e il flusso di conferma.
Script base
Aggiungi lo script base di BibSync a ogni pagina di registrazione su cui arriva traffico partner.
<!-- 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>Sostituisci YOUR_CAMPAIGN_SLUG con lo slug della tua campagna nelle impostazioni tracking di BibSync.
Script di registrazione
Attiva l'evento di registrazione dopo un acquisto riuscito nella pagina di conferma.
<script>
window.__bsq = window.__bsq || [];
window.__bsq.push(['track', {
orderId: 'YOUR_ORDER_ID',
amount: 49.99
}]);
</script>Sostituisci YOUR_ORDER_ID e 49.99 con il tuo ID ordine reale e il valore di acquisto.
Verifica il flusso
Esegui una registrazione di prova e conferma che clic e registrazione siano visibili in BibSync.
Webhook server-to-server
Firma il payload JSON grezzo con il segreto della campagna usando HMAC-SHA256 e invia il digest nell'header X-BibSync-Signature.
Scegli questa opzione solo se il tuo team può inviare richieste backend firmate. È la configurazione più flessibile, ma richiede lavoro tecnico.
Come funziona
- Cattura il click ID di BibSync quando un partner invia un visitatore al tuo sito.
- Conserva quel click ID fino al completamento della registrazione.
- Invia la registrazione completata dal tuo backend a BibSync con una firma HMAC.
Endpoint
POST https://bibsync.link/api/v1/s2sEsempio payload
{
"clickId": "bs_clk_abc123xyz789abc123",
"externalOrderId": "RTS-998877",
"amount": 25.00,
"currency": "EUR"
}Esempio Node.js
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,
});Esempio 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 e risoluzione problemi
Come posso testare l'integrazione?
Usa un vero link partner, completa una registrazione di prova sul tuo sito e poi verifica che clic e registrazione compaiano in BibSync.
Perché vedo partner clicks at risk?
Significa che BibSync ha ricevuto clic dai partner, ma quei visitatori non hanno ancora prodotto una registrazione nella finestra prevista.
Cosa succede se il tracking va offline?
BibSync avvisa gli organizzatori dopo 24 ore senza dati e mette automaticamente in pausa la campagna dopo 48 ore finché il tracking non viene ripristinato.
Posso usare più di un metodo di integrazione?
Usa un solo metodo principale per campagna per evitare registrazioni duplicate. Se stai migrando, disattiva il vecchio flusso prima di abilitare quello nuovo.
Quanto tempo impiegano gli eventi ad apparire?
I clic di solito compaiono in pochi secondi. Le registrazioni dovrebbero apparire poco dopo il caricamento della pagina di conferma o l'accettazione della richiesta S2S.