Wysyłanie konwersji
Gdy nastąpi sprzedaż albo rejestracja, Twój serwer wysyła ją razem z wejściem; później może zmienić jej status, np. przy zwrocie.
Wywołanie
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"
}
| Pole | |
|---|---|
hit |
Podpisane wejście z ciasteczka hitctrl (albo z wejścia po stronie serwera). |
conversionTypeCode |
Wymagane. Kod typu konwersji, np. sale. |
externalId |
ID Twojego zamówienia albo transakcji. To samo liczy się raz, więc ponowienie jest bezpieczne. |
amount.value, currency |
Kwota sprzedaży; potrzebna przy wypłatach procentowych. Inna waluta jest przeliczana po kursie dnia. |
exchangeRate |
Twój własny kurs do waluty przestrzeni roboczej, jeśli go akceptuje. |
couponCodes |
Użyte kody kuponów; partner kuponu dostaje sprzedaż przed wejściem. |
externalClientId |
Zarejestrowany przez Ciebie klient; sprzedaż jest przypisywana partnerowi wejścia tego klienta. |
country |
Kraj kupującego (dwie litery); sprzedaż jest wyceniana według niego zamiast kraju wejścia. |
customParams.advS1–advS5 |
Twoje własne wartości; mogą ich używać grupy wypłat i reguły przeciw nadużyciom. |
status |
approved, pending albo test; pomiń, a zostanie użyty status ustalony przez cel oferty. |
Wymagane jest jedno z hit, couponCodes albo externalClientId. Wywołanie działa też jako GET z tymi samymi wartościami w adresie.
Zmiana statusu później
POST https://<your workspace address>/track/conversions/status
{ "externalId": "order-1042", "status": "refunded" }
status to approved, pending, rejected albo refunded. Dodaj conversionTypeCode, jeśli jedno zamówienie ma konwersje kilku typów.
Szczytowe obciążenie
Wyślij nagłówek Prefer: respond-async: odpowiedź to od razu 202, a konwersja jest zapisywana chwilę później.
Czy to odpowiedziało na Twoje pytanie?
Sprawdzone z aplikacją 18 października 2026