Tracking-Pixel

Das Tracking-Pixel ist ein 1×1-Bild auf deiner Bestellbestätigungsseite. Lädt der Browser des Kunden es, meldet es die Bestellung an cli.gs. Auf dieser Seite lernst du, wie du das Pixel einbaust, welche Parameter es kennt und warum eine Pixel-Conversion geparkt wird, bis dein Server sie bestätigt. Das Pixel ist schnell eingebaut, aber es ist ein Fallback und kein Ersatz für den Server-Postback.

Kurz gesagt:

• Eine Pixel-Conversion bewegt nie von sich aus Geld. Sie wartet auf deinen Server-Postback oder deine Freigabe von Hand.
• Setze das <img>-Tag auf die Bestätigungsseite, nur wenn ein ref-Code gespeichert ist, mit URL-kodierten Werten.
• Sende immer dieselbe orderId wie im Server-Postback. Darüber werden beide zusammengeführt.
• Für das Pixel gibt es keinen Testmodus. Teste mit dem Server-Postback und test: true.

Warum das Pixel eine Bestätigung braucht

Ein Pixel ist eine gewöhnliche URL, die jeder im Browser aufrufen kann, mit beliebigem Betrag. Könnte es allein Provisionen buchen, könnte jeder mit einem ref-Code Verkäufe erfinden. Deshalb bewegt eine Pixel-Conversion nie von sich aus Geld. Sie wird erfasst und unter Conversions als Zur Prüfung geparkt, mit dem Hinweis, dass nur das Browser-Pixel sie gemeldet hat. Dort bleibt sie, bis eines von zwei Dingen passiert:

• Dein Server-Postback für dieselbe Bestellung trifft ein. Er bestätigt die Conversion, und sein Betrag und seine Angaben ersetzen die des Pixels; oder
• du gibst sie unter Conversions von Hand frei.

Pixel sind außerdem von Natur aus unzuverlässig. Werbeblocker listen Affiliate-Pixel, manche Kunden schließen die Seite, bevor es lädt, und Browser begrenzen, was Skripte speichern dürfen. Setze das Pixel ein, solange ein Server-Postback noch nicht möglich ist. Oder nutze es zusätzlich zum Postback, damit du Verkäufe sofort im Dashboard siehst.

Das Snippet

Setze das auf die Bestellbestätigungsseite („Danke“-Seite) und fülle die Werte aus deinem Shop ein:

<!-- Order confirmation page. REF_CODE is the code you stored from ?ref=,
     ORDER_ID and TOTAL come from the order. -->
<img src="https://cli.gs/track/success.png?ref=REF_CODE&orderId=ORDER_ID&basketValue=TOTAL&currency=EUR&customerType=NEW"
     width="1" height="1" alt="" style="position:absolute;left:-9999px" />

Gib das Tag nur aus, wenn ein ref-Code gespeichert ist, und URL-kodiere jeden Wert. Die Integrationsseite zeigt dasselbe Snippet mit der Währung deines Programms, dazu eine JavaScript-Variante.

Parameter

Was das Pixel antwortet

Das Pixel antwortet immer mit einem transparenten Bild und HTTP 200, egal was passiert. So zeigt die Seite nie ein kaputtes Bild, und über dein Programm wird nichts verraten. Abgelehnte Pixel-Meldungen, die sich deinem Programm zuordnen lassen, etwa ein abgelaufener Klick oder ein unlesbarer Betrag, erscheinen unter Letzte Ablehnungen auf der Integrationsseite.

Einen Testmodus gibt es für das Pixel nicht. Teste mit dem Server-Postback und test: true.

Immer die Bestellnummer senden

Pixel-Conversion und Server-Postback werden über orderId und eventType zusammengeführt. Ohne Bestellnummer kann dein Postback eine Pixel-Meldung nicht bestätigen. Du hättest dann eine geparkte Pixel-Conversion neben der gebuchten, und wenn du beide freigibst, zahlst du doppelt.

Was das Pixel sonst prüft

• Das Pixel sollte von den Seiten deines eigenen Shops geladen werden. Ein Pixel, das von einer Domain außerhalb der erlaubten Domains des Programms feuert, zählt als Betrugssignal.
• Eine einzelne IP-Adresse kann das Pixel höchstens 300-mal pro Minute laden. Darüber hinaus werden Aufrufe ignoriert.
• Ansonsten gelten dieselben Regeln wie beim Postback: ein gültiger ref-Code dieses Programms, innerhalb des Cookie-Fensters, mit lesbarem Betrag.

Weiter

Damit dein Shop von Freigaben, Ablehnungen und Stornos erfährt, richte Postbacks an deinen Shop ein.