Jak skonfigurować postback i integrację API w MyLead?

Integracja przez postback to metoda przekazywania danych o konwersjach między platformą MyLead a systemem wydawcy w czasie rzeczywistym, oparta na komunikacji server-to-server. Konfiguracja odbywa się w zakładce Dla webmastera, gdzie definiujesz status leada wywołujący postback oraz Postback URL z parametrami clickid i affid. API działa zamiennie, odpytując serwer okresowo.

Z tego przewodnika dowiesz się, jak zbudować adres postback URL, zmapować parametry MyLead i przygotować link trackujący do śledzenia leadów pod-wydawców. Skupiamy się na praktycznej konfiguracji.

Z tego artykułu dowiesz się:

• jak skonfigurować postback w panelu MyLead krok po kroku,

• jakie statusy leada wywołują postback i kiedy ich używać,

• jak zbudować poprawny adres postback URL z parametrami,

• czym różni się integracja przez postback od interfejsu API.

Jak skonfigurować postback w panelu MyLead?

Konfiguracja postback zaczyna się w zakładce Dla webmastera → Postback, która zawiera listę parametrów przekazywanych wydawcy. Przycisk Dodaj nowy Postback URL otwiera okno z dwoma polami: statusem leada wywołującym postback oraz adresem Postback URL. Najczęściej używane parametry to clickid (przez [ml_sub1]) i affid (przez [ml_sub2]), niezbędne do przypisywania leadów pod-wydawcom.

Pole statusu określa, przy jakiej zmianie statusu leada w panelu MyLead uruchamia się postback. Dostępnych jest pięć wariantów:

• Dowolny — postback wywołuje się przy każdej zmianie statusu (opcja stosowana najczęściej).

• Do wypłaty — aktywuje się, gdy lead uzyska pełną akceptację pozwalającą na wypłatę.

• Zaakceptowany — uruchamia się, gdy lead zostanie wstępnie zaakceptowany i czeka na decyzję reklamodawcy.

• Oczekujący — wyzwala się, gdy lead jest poprawnie wykonany, ale jeszcze nieprzeanalizowany (głównie oferty CPS).

• Odrzucony — następuje, gdy lead zmienia status na odrzucony.

Z postbacku korzystają zwłaszcza wydawcy będący subsieciami afiliacyjnymi, którzy rozliczają własnych pod-wydawców. Pełny wykaz parametrów opisuje rozdział Postbacki w kompletnym poradniku MyLead.

Jak zbudować poprawny adres postback URL?

Adres postback URL powstaje przez dodanie parametrów śledzących do podstawowego adresu platformy trackingowej. Po adresie platformy umieszcza się znak ?, a po nim parametr MyLead przypisany do parametru wydawcy, z zachowaniem nawiasów kwadratowych — na przykład clickid=[ml_sub1]. Kolejne parametry rozdziela znak &, np. &affid=[ml_sub2]&transaction=[transaction_id]. Dzięki temu system przekazuje komplet danych o każdej konwersji.

Pamiętaj o przekazaniu stawki leada. W zależności od systemu obsługującego postback użyj parametru [payout_decimal], który zwraca wartość zmiennoprzecinkową (np. 4.00), lub [payout] zwracający kwotę w groszach (np. 400). Przy statusie Dowolny dodaj parametr [status] — bez niego statystyki zliczają się nieprawidłowo.

Jeśli korzystasz z zewnętrznego narzędzia, najpierw musisz dodać MyLead jako sieć afiliacyjną do trackera, aby parametry mapowały się poprawnie.

Jak przygotować link trackujący pod postback?

Link trackujący bazuje na linku, którego wydawca używa do promowania oferty MyLead. Poprawne przekazywanie statystyk wymaga zmapowania parametrów tego linku do parametrów postbacku. Do linku promocyjnego dołącza się parametry ml_sub1–ml_sub5 z wartościami clickid oraz identyfikatora pod-wydawcy. Mapowanie gwarantuje, że każda konwersja trafia do właściwego pod-wydawcy.

Przykład poprawnie skonfigurowanego linku: leadmy.pl/p/XXXX/yyyy/1111?ml_sub1=wartoscclickid&ml_sub2=wartoscpodwydawcy. Wartości parametrów ml_sub1–ml_sub5 podejrzysz w wygenerowanych leadach w zakładce Statystyki → Leady — to przydatne przy weryfikacji działania postbacku.

Jeśli dopiero konfigurujesz tracker, ustaw najpierw jego podstawowe parametry, zanim zmapujesz link promocyjny.

Czym różni się integracja przez postback od API?

Postback i API to dwa modele przekazywania danych o leadach. Postback działa w trybie push: po każdej zmianie statusu MyLead natychmiast wysyła powiadomienie na Twój adres, co umożliwia tracking w czasie rzeczywistym. Interfejs API działa w trybie pull — to Twój system okresowo odpytuje serwer MyLead o aktualne statystyki. Postback wybierają najczęściej wydawcy będący sieciami afiliacyjnymi.

Postback sprawdza się, gdy zależy Ci na natychmiastowej aktualizacji statystyk i automatycznym rozliczaniu pod-wydawców. Więcej zastosowań opisuje artykuł Postback w marketingu afiliacyjnym. Skonfiguruj swój pierwszy postback w panelu MyLead i śledź leady w czasie rzeczywistym.

Kluczowe wnioski

• Postback przekazuje dane o konwersjach w czasie rzeczywistym (push), a API odpytuje serwer okresowo (pull).

• Konfigurację rozpoczynasz w zakładce Dla webmastera → Postback, korzystając z przycisku Dodaj nowy Postback URL.

• Najczęściej używane parametry to clickid ([ml_sub1]) i affid ([ml_sub2]) — kluczowe przy rozliczaniu pod-wydawców.

• Przy statusie Dowolny zawsze dodawaj parametr [status], a stawkę przekazuj przez [payout_decimal] lub [payout].

• Link trackujący wymaga zmapowanych parametrów ml_sub1–ml_sub5, które zweryfikujesz w zakładce Statystyki → Leady.

FAQ

1. Czym jest postback w MyLead?

Postback to mechanizm server-to-server, który po zmianie statusu leada automatycznie wysyła dane o konwersji na adres URL wydawcy. Umożliwia tracking leadów w czasie rzeczywistym, bez polegania na cookies.

2. Jakich parametrów użyć do clickid i affid?

Do clickid przypisz parametr [ml_sub1], a do affid [ml_sub2]. To podstawowe parametry niezbędne do prawidłowego przypisywania leadów pod-wydawcom.

3. Kiedy dodać parametr [status] do postbacku?

Parametr [status] dodaj zawsze przy wyborze statusu Dowolny. Bez niego pojawiają się komplikacje w zliczaniu statystyk.

4. Gdzie sprawdzić wartości parametrów ml_sub?

Wartości ml_sub1–ml_sub5 podejrzysz w wygenerowanych leadach w zakładce Statystyki → Leady. To ułatwia weryfikację poprawnego działania postbacku.

Podsumowanie

Integracja przez postback w MyLead to najszybszy sposób przekazywania danych o konwersjach w czasie rzeczywistym. Skonfiguruj zakładkę Dla webmastera → Postback, zmapuj parametry clickid i affid oraz przygotuj link trackujący, a uzyskasz pełną kontrolę nad statystykami pod-wydawców. API pozostaje alternatywą dla okresowego pobierania danych.