Conversions und Umsatz

Conversion-Tracking schließt den Kreis zwischen einem Klick und dem Geld, das er erzeugt hat. Der Redirector vergibt bei jeder Weiterleitung eine signierte Kennung; Ihr Server oder Ihre Dankeseite schickt sie mit einer Bestellung zurück; und jede Aufschlüsselung, die Sie ohnehin lesen, gewinnt eine Umsatzspalte.

Conversions sind eine kostenpflichtige Funktion. Enthält der Tarif sie nicht, vergibt der Redirector gar keine Kennungen mehr, und beide Eingangswege lehnen Conversions mit einer Tarifbeschränkung ab.

Die Klick-Kennung

Bei jeder Weiterleitung vergibt der Worker ein Token und:

• hängt es unter einem Parameternamen Ihrer Wahl an die Zieladresse an (standardmäßig lp_cid);
• schreibt es in ein First-Party-Cookie auf Ihrer Weiterleitungsdomain, 90 Tage gültig.

Das Cookie ist es, was die Attribution in Browsern überstehen lässt, die nichts von Dritten mehr annehmen — es wird von Ihrer eigenen Domain gesetzt, nicht von unserer.

Das Token ist signiert und an den Mandanten gebunden: Die Kennungen von Workspace und Partner sind Teil der signierten Nutzlast, sodass ein Token, das am Link eines Kunden vergeben wurde, im Workspace eines anderen Kunden genauso abgelehnt wird wie eine Fälschung. Es trägt keine personenbezogenen Daten — den Zeitpunkt des Klicks, den Link, die Split-Variante, das Land, die Geräteklasse, die Traffic-Quelle und eine Markierung für verdächtigen Traffic.

Sowohl der Parametername als auch der Ein-/Ausschalter liegen unter Conversions → Einstellungen. Eine Änderung an einem von beiden schreibt die gecachte Konfiguration jedes Links sofort neu.

Das Attributionsfenster

Eine Conversion, die später als das Fenster eintrifft, wird mit attribution_expired abgelehnt — einem eigenen Code, verschieden von invalid_click_id, sodass eine Integration „zu spät“ von „kaputte Kennung“ unterscheiden kann, ohne zu raten. Das Fenster ist eine Einstellung je Workspace.

Ziele

Ein Ziel ist ein benanntes Ergebnis: purchase, signup, trial. Ziele können einen Standardwert und eine Währung tragen, die genutzt werden, wenn eine Conversion ohne Betrag ankommt. Ein Ziel, auf das sich eine Conversion bezieht und das es noch nicht gibt, wird bei der ersten Verwendung angelegt — eine Integration muss also nicht an zwei Stellen eingerichtet werden.

Conversions senden

Von Ihrem Server

curl -X POST https://api.linkprofit.com/v1/conversions \
  -H "Authorization: Bearer lp_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-10241" \
  -d '{
    "click_id": "1.eyJ1aWQiOiJ...",
    "goal": "purchase",
    "order_id": "10241",
    "amount_cents": 4999,
    "currency": "usd"
  }'

Der Schlüssel braucht den Scope conversions:write. Beträge sind ganze Mindesteinheiten — Cent, Pence, Kopeken. Ein Betrag von 49.99 wird unter Nennung des Feldes abgelehnt statt still gerundet, denn eine mitten in einem Zahlungsweg erfundene Rundungsregel ist die Art, wie Umsatzberichte leise aufhören, zu den Rechnungen zu passen.

Aus dem Browser

Der Worker liefert ein kleines Skript von Ihrer eigenen Weiterleitungsdomain aus:

<script src="https://go.example.com/cv.js" defer></script>
<script>
  window.lpConversion({ goal: 'purchase', orderId: '10241', amountCents: 4999, currency: 'usd' });
</script>

Das Skript liest die Kennung aus der URL oder aus dem First-Party-Cookie. In der ganzen Kette gibt es keinen fremden Host, was zugleich eine Datenschutz- und eine White-Label-Eigenschaft ist: Die Seite Ihres Kunden lädt nichts, was die Plattform erwähnt.

Duplikate

Die Deduplizierung ist ein einziges atomares Insert, kein Lesen mit anschließendem Schreiben. Wiederholte Zustellungen derselben order_id erzeugen eine Conversion und geben sie als Duplikat markiert zurück — und genau das macht den erneuten Versuch eines fehlgeschlagenen Webhooks sicher statt gefährlich.

Verdächtige Conversions

Das Urteil des Klassifikators reist im Token mit, sodass eine Conversion, die einem Rechenzentrum oder einem Proxy zugerechnet wird, beim Erfassen als verdächtig markiert wird. Sie erscheint in Berichten als eigenes Segment, statt gelöscht oder still untergemischt zu werden. „Zweihundert Conversions“ und „zweihundert Conversions, vierzig davon aus einem einzigen Hosting-Bereich innerhalb einer Stunde“ sind verschiedene Tatsachen.

Wohin Conversions als Nächstes gehen

• Ein signiertes Webhook-Event conversion.created wird über die übliche Webhook-Maschinerie ausgegeben: Queue, Signatur, Wiederholungsplan, Nachhol-Cron.
• Eingerichtete Werbe-Integrationen erhalten die Conversion über eine Zustell-Queue mit einem Versuchszähler, der vor dem ausgehenden Aufruf erhöht wird, einem dokumentierten Backoff und einer Abbruchmarkierung statt endloser Wiederholungen.

Monatliches Kontingent

Ein Tarif kann die Zahl der pro Kalendermonat angenommenen Conversions deckeln, gezählt in UTC. Jenseits des Deckels antwortet die Annahme mit quota_exceeded — einem eigenen Code, verschieden von einer Tarifbeschränkung, sodass der Unterschied zwischen „nicht in Ihrem Tarif“ und „diesen Monat aufgebraucht“ ohne Support-Ticket sichtbar ist.