Entwickler

Eine Conversion senden

Wenn ein Verkauf oder eine Anmeldung passiert, sendet Ihr Server sie mit dem Hit; später kann er ihren Status ändern, zum Beispiel bei einer Erstattung.

Der Aufruf

POST https://<your workspace address>/track/conversions
x-api-key: your API key
Content-Type: application/json

{
  "hit": "h1.…",
  "conversionTypeCode": "sale",
  "externalId": "order-1042",
  "amount": { "value": 49.90 },
  "currency": "EUR"
}

Feld
`hit`	Der signierte Hit aus dem Cookie `hitctrl` (oder aus einem serverseitigen Hit).
`conversionTypeCode`	Pflicht. Der Code des Conversion-Typs, zum Beispiel `sale`.
`externalId`	Ihre Bestell- oder Transaktions-ID. Dieselbe zählt einmal, ein Wiederholen ist also sicher.
`amount.value`, `currency`	Der Verkaufsbetrag; nötig für Prozent-Auszahlungen. Eine andere Währung wird zum Tageskurs umgerechnet.
`exchangeRate`	Ihr eigener Kurs zur Workspace-Währung, wenn Ihr Workspace ihn akzeptiert.
`couponCodes`	Verwendete Gutscheincodes; der Partner eines Gutscheins bekommt den Verkauf vor dem Hit.
`externalClientId`	Ein Kunde, den Sie registriert haben; der Verkauf zählt für den Partner des Hits dieses Kunden.
`country`	Das Land des Käufers (zwei Buchstaben); bepreist den Verkauf danach statt nach dem Land des Hits.
`customParams.advS1`–`advS5`	Ihre eigenen Werte; Auszahlungsgruppen und Betrugsregeln können sie nutzen.
`status`	`approved`, `pending` oder `test`; weglassen für das, was das Ziel des Angebots festlegt.

Eines von hit, couponCodes oder externalClientId ist Pflicht. Der Aufruf funktioniert auch als GET mit denselben Werten in der Adresse.

Später einen Status ändern

POST https://<your workspace address>/track/conversions/status
{ "externalId": "order-1042", "status": "refunded" }

status ist approved, pending, rejected oder refunded. Fügen Sie conversionTypeCode hinzu, wenn eine Bestellung Conversions mehrerer Typen hat.

Viel los

Senden Sie den Header Prefer: respond-async: Die Antwort ist sofort 202, und die Conversion wird einen Moment später erfasst.

Hat das Ihre Frage beantwortet?

Am 18. Oktober 2026 mit der App abgeglichen