Conversion-Pixel
Verfolgen Sie Conversions auf Zielseiten, die Sie nicht kontrollieren, zugeordnet zum ursprünglichen Klick und zur A/B-Variante.
A/B-Tests bei Kurzlinks können Besucher auf eine Zielseite leiten, die Sie nicht kontrollieren — einen Shop, einen Landingpage-Builder, die Website eines Partners. Styrar misst den Klick und welche Variante einem Besucher angezeigt wurde, hat aber keine Möglichkeit zu wissen, ob dieser Besucher nach dem Redirect konvertiert ist.
Das Conversion-Pixel schließt diese Lücke. Es ist ein kleines Skript, das Sie auf der Zielseite einbinden und das Conversions an Styrar zurückmeldet, korreliert zum genauen Klick (und zur A/B-Variante), der den Besucher dorthin geschickt hat.
So funktioniert es
- Wenn ein Kurzlink einen Besucher weiterleitet, hängt Styrar ein einmaliges
styrar_ck-Token an die Ziel-URL an. - Das Pixel-Skript auf dieser Seite liest das Token aus der URL (oder aus
localStorage, damit es bei weiterer Navigation auf Ihrer Website erhalten bleibt) und hält es bereit, um es mit jedem Ereignis zu senden. - Sie rufen
window.styrar.track(eventName, data)auf — oder fügen eindata-styrar-track-Attribut hinzu —, wenn ein Besucher etwas Zählenswertes tut (sich registriert, zur Kasse geht, eine Testphase startet). - Styrar löst das Token zurück zum ursprünglichen Link und zur A/B-Variante auf, und die Conversion erscheint im Experiment-Panel dieses Links.
Es gibt keine Account-ID, Site-ID oder API-Schlüssel zu konfigurieren. Das Token selbst ist das Einzige, was ein Ereignis mit Ihrem Arbeitsbereich verknüpft, und es ist auf einen einzelnen Klick beschränkt.
Conversion-Pixel einrichten
1. Ihr Einbettungs-Snippet finden
Öffnen Sie im Dashboard das Panel Advanced → A/B test des Kurzlinks und starten (oder konfigurieren) Sie ein Experiment. Das Panel zeigt eine Karte „Track conversions on the destination page" mit einem fertigen Snippet zum Kopieren:
<script src="https://api.styrar.com/v1/pixel/styrar.js" async></script>
<!-- mark a conversion -->
<button data-styrar-track="signup">Sign up</button>
<!-- or call it from your own code -->
<script>window.styrar && window.styrar.track('signup', { value: 19.99 })</script>
2. Das Script-Tag auf Ihrer Zielseite einbinden
Fügen Sie das Tag <script src="…/v1/pixel/styrar.js"> auf der Seite ein, auf der Besucher nach dem Kurzlink-Redirect landen — im <head> oder kurz vor </body>. Das funktioniert auf jeder Plattform (Shopify, Webflow, eine statische Seite, Ihre eigene App), weil das Pixel und sein Tracking-Endpunkt eine offene, cookie-freie CORS-Richtlinie verwenden.
3. Eine Conversion markieren
Wählen Sie, was zu Ihrer Seite passt:
Deklarativ, ohne eigenes JavaScript:
<button data-styrar-track="signup">Sign up</button>
<form data-styrar-track="checkout_complete">…</form>
Ein click löst das Ereignis bei den meisten Elementen aus; bei einem <form> löst es stattdessen bei submit aus.
Aus eigenem Code, sobald das Skript geladen wurde:
<script>
window.styrar && window.styrar.track('purchase', { value: 49.99 })
</script>
4. Bestätigen, dass es funktioniert
Lösen Sie die Conversion auf der Zielseite aus und öffnen Sie dann das A/B-Test-Panel des Links — Conversion-Anzahl und -Rate der Variante aktualisieren sich, sobald das Ereignis eintrifft.
Benutzerdefinierte Conversion-Werte
window.styrar.track(eventName, data) akzeptiert einen beliebigen Ereignisnamen und ein optionales data-Objekt:
<script>
window.styrar.track('purchase', {
value: 49.99, // numeric — stored as the event's value
plan: 'pro_annual', // any other field is stored alongside the event
currency: 'USD',
})
</script>
| Feld | Typ | Verhalten |
|---|---|---|
eventName | string | Erforderlich. Bis zu 64 Zeichen — verwenden Sie, was zu Ihrem Funnel passt: signup, add_to_cart, purchase usw. |
value | number | Wird nur gespeichert, wenn es sich um eine JS-number handelt (z. B. Bestellumsatz). Alles andere wird ignoriert. |
jedes andere Feld in data | beliebiger JSON-Wert | Wird zusammen mit dem Ereignis gespeichert (bis zu 4 KB serialisiert). Größere Payloads werden verworfen, nicht abgeschnitten. |
Es gibt kein Schema, das Sie vorab registrieren müssen — rufen Sie track() mit der Struktur auf, die für Ihre Seite Sinn ergibt, und sie wird mit dem Ereignis gespeichert.
Conversions von Ihrem Server melden
Wenn die Conversion serverseitig passiert (zum Beispiel ein Webhook Ihres Zahlungsanbieters) statt im Browser, lesen Sie den styrar_ck-Parameter aus der ursprünglichen Anfrage und senden Sie ihn direkt:
Content-Type: application/json
{
"clickToken": "the styrar_ck value",
"eventName": "purchase",
"value": 49.99
}{
"ok": true
}Dies ist dieselbe unauthentifizierte Anfrage, die das Browser-Pixel stellt. Es gibt keinen API-Schlüssel — der clickToken ist auf eine einmalige Nutzung pro Klick beschränkt und nicht enumerierbar, sodass er gleichzeitig als Berechtigungsnachweis dient.
API-Referenz
GET /v1/pixel/styrar.js # the embeddable script, no auth required
POST /v1/pixel/track # records a conversion event, no auth required
POST /v1/pixel/track-Body:
| Feld | Erforderlich | Beschreibung |
|---|---|---|
clickToken | Ja | Der styrar_ck-Wert aus der Ziel-URL oder aus localStorage |
eventName | Ja | Bis zu 64 Zeichen |
value | Nein | Zahl, z. B. Bestellwert |
eventData | Nein | Beliebiges JSON-Objekt, bis zu 4 KB serialisiert |
pageUrl | Nein | Bis zu 2048 Zeichen; das Skript sendet automatisch window.location.href |
Der Endpunkt antwortet immer mit 200 { "ok": true } — auch bei einem nicht erkannten oder abgelaufenen clickToken —, damit das Pixel auf einer Seite, die Sie nicht vollständig kontrollieren, niemals einen Fehler anzeigt.
Datenschutz und Sicherheit
- Das Pixel sendet nur das Click-Token, den Ereignisnamen/-wert/die Daten, die Sie übergeben, und die aktuelle Seiten-URL. Keine Cookies, kein Fingerprinting und keine seitenübergreifenden Identifikatoren sind beteiligt.
/v1/pixel/trackist pro IP ratenbegrenzt (120 Anfragen/Minute), um Missbrauch abzufangen, ohne normalen Traffic zu beeinträchtigen.clickTokenist ein zufälliger, auf einmalige Nutzung beschränkter Identifikator — er lässt sich nicht aus dem Kurzcode eines Links oder einem anderen öffentlichen Wert ableiten.
Limits
- Conversion-Tracking erfordert, dass ein A/B-Test für den Link konfiguriert ist; die Conversion wird der Variante zugeordnet, die dem Besucher zum Klickzeitpunkt angezeigt wurde.
- Es gibt kein automatisches Pageview-Tracking — das Pixel meldet nur Ereignisse, die Sie explizit auslösen, um Rauschen und Anfragevolumen gering zu halten.
- Noch kein Bulk-Export- oder Löschendpunkt für Conversion-Ereignisse; melden Sie sich, wenn Sie Daten für einen bestimmten Arbeitsbereich entfernt haben möchten.
Verwandte Themen
- Webhooks — benachrichtigt werden, wenn ein A/B-Test über
link.experiment.completedabgeschlossen wird - Kurzlinks und QR-Codes im Hilfe-Center
- Bio-Page-Tracker — Google Analytics, Meta, GTM und mehr auf Ihrer Bio-Page
- Dieses Pixel pro Plattform installieren: Shopify · WordPress · Wix · Framer · Serverseitig