Überblick Integration

cli.gs zahlt nur Provision für Verkäufe, die dein Shop meldet. Auf dieser Seite siehst du, wie ein Verkauf vom Publisher-Link zur gebuchten Provision kommt, wo du deinen API-Schlüssel bekommst und in welcher Reihenfolge du die Integration baust. Die meiste Arbeit passiert auf deinem Server: ein paar Zeilen auf der Landingpage und ein HTTP-Aufruf, wenn eine Bestellung eingeht.

Kurz gesagt:

• Ein Besucher kommt mit ?ref=... in der URL an. Dein Shop behält diesen ref-Code bis zur Bestellung.
• Dein Server meldet die Bestellung an POST /api/v1/track/conversion, authentifiziert mit deinem API-Schlüssel.
• Nur der Server-Postback bucht eine Provision. Das Tracking-Pixel ist ein Fallback.
• Jedes Programm hat seinen eigenen API-Schlüssel. Er bleibt auf dem Server, nie im Browser.
• Baue in dieser Reihenfolge: ref-Code erfassen, Conversions melden, Anfragen signieren, Rückgaben melden, testen.

So läuft ein Verkauf ab

1. Ein Besucher klickt auf den Link eines Publishers, zum Beispiel https://cli.gs/@mara/demoshop.
2. cli.gs erfasst den Klick. Dann leitet es den Besucher auf deine Ziel-URL weiter und hängt einen Referenzcode an: https://shop.example.com/?ref=01J9Z4K6V0QX8M2N3P5R7S9T1WABCD.
3. Dein Shop liest ref aus der URL und behält ihn in einem Cookie oder in der Session bis zum Checkout.
4. Wenn die Bestellung aufgegeben oder bezahlt ist, sendet dein Server den ref-Code, deine Bestellnummer und den Betrag an POST https://cli.gs/api/v1/track/conversion. Die Anfrage ist mit deinem API-Schlüssel authentifiziert.
5. Wir prüfen den Code, wenden deine Provisionsregeln an und erfassen die Conversion. Danach durchläuft sie das Freigabefenster und die Haltefrist, die du für das Programm festgelegt hast. Beide Begriffe erklärt So funktioniert cli.gs.
6. Schickt der Kunde die Ware zurück, meldet dein Server einen Storno. Die Provision geht zurück.

Der ref-Code ist die Zuordnung. Er steht für den Klick und damit für Publisher und Programm. Es zählt der letzte Klick. Geht der Code zwischen Schritt 2 und Schritt 4 verloren, lässt sich der Verkauf niemandem zuordnen. Das kann auch nachträglich niemand reparieren.

Zwei Wege zu melden

Der Server-Postback ist der Kanal, den du bauen solltest. Werbeblocker können ihn nicht verhindern, Speichergrenzen im Browser betreffen ihn nicht, und dein Server kann ihn wiederholen.

Das Tracking-Pixel ist nur ein Fallback. Jeder könnte seine URL mit beliebigem Betrag aufrufen. Deshalb wird eine Pixel-Conversion geparkt, bis ein Postback für dieselbe Bestellung sie bestätigt oder du sie von Hand freigibst. Mehr dazu unter Tracking-Pixel.

Dein API-Schlüssel

Dein Server braucht den Schlüssel, bevor er etwas melden kann. Jedes Programm hat seinen eigenen Schlüssel.

1. Öffne Partnerprogramme und wähle das Programm.
2. Klicke auf Integration.
3. Klicke im ersten Abschnitt, API-Schlüssel, auf Schlüssel erzeugen. Der Button funktioniert, sobald du das Programm zur Prüfung eingereicht hast.
4. Kopiere den Schlüssel direkt in die Konfiguration oder den Secret-Speicher deines Shops.

Was du bekommst

• Der Schlüssel beginnt mit cligs_sk_ und wird genau einmal angezeigt. Wir speichern nur seinen Hash und können ihn dir nicht erneut zeigen.
• Mit dem ersten Schlüssel erhältst du außerdem ein Signatur-Secret für signierte Anfragen. Auch das wird nur dieses eine Mal angezeigt.

Wenn ein Schlüssel verloren oder womöglich geleakt ist

Klicke auf Neuen Schlüssel erzeugen. Der alte Schlüssel funktioniert noch 24 Stunden. So kannst du den neuen einspielen, ohne Conversions zu verlieren. Das Signatur-Secret bleibt gleich.

Ein Schlüssel akzeptiert nur ref-Codes aus Klicks auf sein eigenes Programm. Ein Code eines anderen Programms wird mit REF_PROGRAM_MISMATCH abgelehnt.

In dieser Reihenfolge bauen

Arbeite die Seiten dieses Bereichs der Reihe nach durch:

1. ref-Code erfassen auf deinen Landingpages und bis zur Bestellung behalten.
2. Conversions melden von deinem Server, sobald eine Bestellung eingeht.
3. Anfragen signieren und dann Unsignierte Anfragen ablehnen einschalten.
4. Rückgaben und Stornos melden, damit du nicht für zurückgeschickte Ware zahlst.
5. Optional das Tracking-Pixel und eine Status-Rückmeldung einrichten. Die Rückmeldung informiert deinen Shop über Freigaben und Ablehnungen.
6. Alles testen mit test: true, bevor echter Traffic kommt.

Zwei Abschnitte der Integrationsseite helfen dir dabei. Parameter listet alle Felder, und die Codebeispiele dort enthalten schon die Werte deines Programms. Integrationsstatus zeigt, ob der ref-Code die Weiterleitungen deines Shops übersteht und ob Meldungen abgelehnt werden.

Weiter

Beginne mit ref-Code erfassen. An diesem Schritt scheitern die meisten Integrationen, und ohne ihn funktioniert nichts anderes.