Blog / Tracking

Konfiguracja S2S postback: 5-minutowy przewodnik dla afiliantów

Od zera do śledzenia prawdziwych konwersji: bez SDK, bez piksela – tylko postback URL server-to-server i odpowiednie makra.

Czym jest S2S postback

Postback server-to-server to zwykłe żądanie HTTP, które sieć afiliacyjna wysyła do trackera w momencie wystąpienia konwersji. W przeglądarce odwiedzającego nie uruchamia się żaden JavaScript, więc blokery reklam, zasady dotyczące cookies ani szybkość strony nie mają na to wpływu. Dlatego właśnie jest to domyślna metoda zliczania konwersji w marketingu afiliacyjnym.

Jak podróżuje click ID

  1. Odwiedzający klika Twoją reklamę i trafia na Twój link śledzący. Tracker rejestruje kliknięcie i nadaje mu unikalny click ID.
  2. Tracker przekierowuje odwiedzającego do oferty i przekazuje click ID dalej, na przykład jako ?sub_id=….
  3. Sieć zapisuje tę wartość wraz z danymi odwiedzającego. Gdy odwiedzający dokona konwersji, sieć wywołuje Twój postback URL z tą samą wartością.
  4. Tracker dopasowuje click ID do pierwotnego kliknięcia i przypisuje konwersję oraz wypłatę do kampanii, streamu, landing page'a i oferty, które ją wygenerowały.
Jeśli click ID nie dotrze do sieci, żaden postback nie zostanie dopasowany. Dziewięć na dziesięć zgłoszeń dotyczących „brakujących konwersji" sprowadza się właśnie do tego kroku.

Konfiguracja w XPNSR Tracker

1. Przekaż click ID do oferty

Ustaw parametr przekazywania Click ID kampanii (na przykład clickid), a tracker dołączy go do każdego URL oferty — albo wstaw makro do URL oferty samodzielnie:

https://offer.example/landing?sub_id={click_id}&country={country_code}

Użyj nazwy parametru, której oczekuje Twoja sieć: sub_id, aff_sub, s2 i tak dalej. 331 presetów sieci afiliacyjnych w trackerze już je zna.

2. Podaj sieci swój postback URL

https://your-tracking-domain/api/postback?click_id={clickid}&revenue={payout}&status=lead

Zastąp wartości w nawiasach klamrowych własnymi makrami sieci. W panelu sieci to pole jest zazwyczaj nazywane Postback, S2S lub Server callback.

ParametrZnaczenie
click_id lub subidClick ID wygenerowany przez tracker (wymagany)
revenue or payoutWypłata za konwersję
statuslead, sale or rejected, mapowane do Twoich typów konwersji
currencyWaluta wypłaty, jeśli inna niż USD
tidID transakcji, dla kilku konwersji na jeden klik

Zabezpieczanie postbacka

Każdy, kto zna URL, mógłby wysyłać fałszywe konwersje. Każda kampania ma sekret postbacka: dodaj &token=YOUR_SECRET do URL (lub wyślij go jako nagłówek X-Postback-Token) i włącz opcję Wymagaj tokena. Możesz też ograniczyć postbacki do adresów IP sieci. Duplikaty postbacków dla tej samej konwersji są ignorowane.

Testowanie i rozwiązywanie problemów

  1. Otwórz własny link śledzący i wykonaj testową konwersję albo skorzystaj z testowego postbacka sieci.
  2. Otwórz Log kliknięć w trackerze i znajdź swoje kliknięcie – konwersja pojawi się na nim w ciągu kilku sekund.
  • Nic nie dociera: sprawdź URL w sieci pod kątem literówek i upewnij się, że nazwy makr dokładnie odpowiadają dokumentacji sieci.
  • Dociera, ale nie pasuje: click ID nie został przekazany do oferty. Otwórz URL oferty z testowego kliknięcia i poszukaj go tam.
  • Błędne kwoty: wysyłaj wypłatę jako zwykłą liczbę, bez znaku waluty; użyj currency dla wypłat innych niż USD.
  • Błędy 401: token jest brakujący lub nieprawidłowy, a opcja Wymagaj tokena jest włączona.

Wypróbuj na własnym ruchu.

XPNSR Tracker: nieograniczone kliknięcia w każdym planie, 7-dniowy trial w planach Start i Pro.