Przejdź do treści
DOTWICK

Postback z serwera

POST/v1/conversions

Kiedy tego użyć

Użyj postbacku dla zamówienia, które Twój serwer potwierdza później: webhook płatności, zamówienie telefoniczne, etap w CRM. Twoja strona zachowuje dw_sid z adresu docelowego, w swojej sesji lub w ciasteczku _dw_sid ustawianym przez piksel, i przekazuje go przy tworzeniu zamówienia. Wymaga planu ze śledzeniem konwersji.

Uwierzytelnij się sekretem postbacku strony (Authorization: Bearer dwps_…, pokazywany raz przy tworzeniu lub rotacji) albo kluczem API z zakresem conversions:write.

Treść żądania

clickIdstringwymaganeWartość dw_sid z adresu docelowego, dokładnie tak, jak przyszła.
eventstringwymaganeNazwa zdarzenia: jedno z purchase, lead, signup albo cel, który utworzono. Małe litery, cyfry i podkreślenia.
valuenumberopcjonalneKwota, jako liczba. Zwrot to kwota ujemna.
currencystringopcjonalneKod ISO 4217, np. USD. Wymagany, gdy jest wartość. Kwoty nigdy nie są przeliczane między walutami.
orderIdstringopcjonalneNumer zamówienia, do 64 znaków. Ponowne wysłanie tego samego jest ignorowane.
occurredAtstringopcjonalneKiedy to się stało, jako czas ISO 8601. Teraz, gdy brak. Musi mieścić się w oknie atrybucji.
metadataobjectopcjonalneDo 10 krótkich wartości tekstowych. Klucz lub wartość przypominająca dane osobowe jest odrzucana.

Wyślij go

przykładPOST /v1/conversions
curl -X POST https://api.dotwick.com/v1/conversions \  -H "Authorization: Bearer dwps_YOUR_POSTBACK_SECRET" \  -H "Content-Type: application/json" \  -d '{    "clickId": "v1.k3m9x2q7c4v1b6n8.a1b2c3d4e5f6.ffk.Hk2LmN0pQ4r",    "event": "purchase",    "value": 49.5,    "currency": "USD",    "orderId": "ORD-1001"  }'

Odpowiedź

Wywołanie odpowiada, zanim konwersja zostanie przypisana. Reszta dzieje się w tle: identyfikator kliknięcia należący do innego obszaru roboczego jest odrzucany, identyfikator spoza okna jest zachowywany jako nieprzypisany, a powtórzenie tego samego orderId jest ignorowane.

202 Accepted
{  "status": "queued"}

Błędy

400validation_failedŹle sformatowany identyfikator kliknięcia, wartość bez waluty, nieznane pole albo metadane z danymi osobowymi.
401unauthorizedSekret postbacku lub klucz API jest nieznany.
403feature_not_in_planPlan obszaru roboczego nie obejmuje śledzenia konwersji.
429rate_limitedZbyt wiele żądań; poczekaj na Retry-After.

Bez danych osobowych

  • Treść jest ścisła: pole, którego nie ma powyżej, w tym adres e-mail lub numer telefonu, powoduje niepowodzenie całego żądania.
  • Klucze metadanych, takie jak email, phone, name i address, są odrzucane, podobnie jak wartość przypominająca adres e-mail lub numer telefonu.