BibSync

Ressourcen

Leitfäden durchsuchen

Auf dieser Seite
Veranstalter
Marketing & Wachstum8 Min.

Tracking-Integrationsleitfaden

Verbinde deine Registrierungsplattform mit BibSync, um partnergetriebene Registrierungen zu erfassen. Wähle die Methode, die am besten zu deinem Setup passt.

Google Tag Manager

Wenn deine Registrierungsseite GTM verwendet, ist das der schnellste Integrationsweg. Auf deiner Website sind keine Codeänderungen nötig, du musst nur zwei Tags in der GTM-Konsole anlegen.

Empfohlen
1

Basis-Tag

Erstelle ein benutzerdefiniertes HTML-Tag. Setze den Trigger auf Alle Seiten.

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

Ersetze YOUR_CAMPAIGN_SLUG durch den Kampagnen-Slug aus den BibSync-Tracking-Einstellungen.

2

Registrierungs-Tag

Erstelle ein weiteres benutzerdefiniertes HTML-Tag. Setze den Trigger so, dass es nur auf deiner Danke- oder Bestätigungsseite ausgelöst wird.

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

Ersetze {{Transaction ID}} und {{Purchase Value}} durch deine GTM-Variablen.

3

Optionales dataLayer-Event

Wenn dein Checkout bereits Kaufdaten in den dataLayer pusht, mappe diese Felder in dein Registrierungs-Tag.

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

Sende dieses Event, bevor die Bestätigungsseite lädt, damit GTM das Registrierungs-Tag mit den finalen Werten auslösen kann.

4

Veröffentlichen und testen

Veröffentliche den GTM-Container, führe eine echte Testregistrierung durch und bestätige, dass das Event in BibSync erscheint.

Benutzerdefiniertes JavaScript

Nutze diese Option, wenn du deine Registrierungsseiten und den Bestätigungsfluss direkt bearbeiten kannst.

1

Basis-Skript

Füge das BibSync-Basis-Skript auf jeder Registrierungsseite ein, auf der Partner-Traffic landet.

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>

Ersetze YOUR_CAMPAIGN_SLUG durch den Kampagnen-Slug aus den BibSync-Tracking-Einstellungen.

2

Registrierungs-Skript

Löse das Registrierungs-Event nach einem erfolgreichen Kauf auf der Bestätigungsseite aus.

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

Ersetze YOUR_ORDER_ID und 49.99 durch deine echte Bestell-ID und den Kaufwert.

3

Ablauf verifizieren

Führe eine Testregistrierung durch und bestätige, dass Klick und Registrierung in BibSync sichtbar sind.

Server-to-Server-Webhook

Signiere den rohen JSON-Payload mit deinem Kampagnen-Secret per HMAC-SHA256 und sende den Digest im Header X-BibSync-Signature.

Wähle diese Option nur, wenn dein Team signierte Backend-Anfragen senden kann. Sie ist am flexibelsten, erfordert aber technische Arbeit.

So funktioniert es

  • Erfasse die BibSync-Click-ID, wenn ein Partner einen Besucher auf deine Seite schickt.
  • Speichere diese Click-ID, bis die Registrierung abgeschlossen ist.
  • Sende die abgeschlossene Registrierung mit einer HMAC-Signatur von deinem Backend an BibSync.

Endpoint

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

Payload-Beispiel

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

Node.js-Beispiel

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,
});

Python-Beispiel

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 und Fehlerbehebung

Wie teste ich die Integration?

Nutze einen echten Partner-Link, führe eine Testregistrierung auf deiner Seite durch und prüfe anschließend, ob Klick und Registrierung in BibSync erscheinen.

Warum sehe ich partner clicks at risk?

Das bedeutet, dass BibSync Partner-Klicks empfangen hat, diese Besucher aber noch keine Registrierung innerhalb des erwarteten Fensters erzeugt haben.

Was passiert, wenn das Tracking offline geht?

BibSync warnt Veranstalter nach 24 Stunden ohne Daten und pausiert die Kampagne nach 48 Stunden automatisch, bis das Tracking wiederhergestellt ist.

Kann ich mehr als eine Integrationsmethode verwenden?

Nutze pro Kampagne eine primäre Methode, um doppelte Registrierungen zu vermeiden. Wenn du migrierst, deaktiviere den alten Ablauf, bevor du den neuen aktivierst.

Wie schnell sollten Events erscheinen?

Klicks erscheinen normalerweise innerhalb von Sekunden. Registrierungen sollten kurz nach dem Laden der Bestätigungsseite oder nach Annahme des S2S-Requests erscheinen.