Czym są wywołania zwrotne aplikacji w Post Affiliate Pro?
Dowiedz się, jak działają wywołania zwrotne aplikacji w Post Affiliate Pro. Odkryj konfigurowalne wyzwalacze zdarzeń dla sprzedaży, leadów i rejestracji partner...
8 min czytania
Dostępne w:
Post Affiliate Pro Ultimate , Post Affiliate Network
Czym są Webhooki i Callbacki?
Webhooki (nazywane również Callbackami Aplikacji lub URL-ami Postback) to automatyczne powiadomienia HTTP, które Post Affiliate Pro wysyła do zewnętrznych systemów, gdy występują określone zdarzenia. Zamiast ciągłego odpytywania o aktualizacje, Twoje połączone systemy otrzymują natychmiastowe powiadomienia w momencie, gdy coś się dzieje w Twoim programie partnerskim.
Ta funkcja jest niezbędna do:
- Integracji CRM - Automatyczne aktualizowanie bazy danych klientów przy sprzedażach
- Automatyzacji E-mail - Wyzwalanie sekwencji e-mail na podstawie działań partnerów
- Systemów Księgowych - Synchronizacja danych transakcji z Twoim oprogramowaniem finansowym
- Niestandardowych Dashboardów - Budowanie dashboardów raportowania w czasie rzeczywistym
- Śledzenia Zewnętrznego - Powiadamianie zewnętrznych platform śledzenia o konwersjach
Uruchom swój program partnerski już dziś
Skonfiguruj zaawansowane śledzenie w kilka minut. Karta kredytowa nie jest wymagana.
Typy Webhooków
Post Affiliate Pro obsługuje dwa główne typy webhooków:
Webhooki Śledzenia Sprzedaży
Te webhooki są wywoływane przez zdarzenia związane z transakcjami:
| Zdarzenie Wyzwalające | Opis |
|---|---|
| Przy Utworzeniu | Uruchamia się natychmiast po zarejestrowaniu nowej transakcji (sprzedaż, akcja, lead) |
| Przy Zatwierdzeniu | Uruchamia się gdy oczekująca transakcja jest zatwierdzana |
| Przy Odrzuceniu | Uruchamia się gdy transakcja jest odrzucana |
| Przy Zwrocie/Chargebacku | Uruchamia się gdy zwrot lub chargeback jest przetwarzany |
Możesz skonfigurować pojedynczy webhook do uruchamiania przy wielu zdarzeniach lub utworzyć oddzielne webhooki dla każdego typu zdarzenia.
Webhooki Rejestracji Partnera
Te webhooki są wywoływane przez zdarzenia rejestracji partnerów:
| Zdarzenie Wyzwalające | Opis |
|---|---|
| Przy Rejestracji | Uruchamia się natychmiast gdy nowy partner wypełni formularz rejestracyjny |
| Przy Zatwierdzeniu | Uruchamia się gdy oczekujący partner jest zatwierdzany przez sprzedawcę |
Typy Żądań
Post Affiliate Pro obsługuje trzy typy żądań HTTP dla webhooków:
Żądanie GET
Parametry są dołączane do URL jako parametry ciągu zapytania.
https://twoj-system.com/webhook?transactionid=abc123&commission=50.00&orderid=ORD-456
Żądanie POST (Form-Urlencoded)
Parametry są wysyłane w treści żądania używając standardowego kodowania formularza.
Content-Type: application/x-www-form-urlencoded
transactionid=abc123&commission=50.00&orderid=ORD-456
Żądanie POST JSON
Parametry są wysyłane jako obiekt JSON w treści żądania.
Content-Type: application/json
{"transactionid": "abc123", "commission": "50.00", "orderid": "ORD-456"}
Dołącz do naszego newslettera
Bądź pierwszym, który dowie się o nowych funkcjach i aktualizacjach produktu.
Dostępne Zmienne dla Webhooków Sprzedaży
Możesz używać zmiennych dynamicznych w swoich URL-ach webhooków, które są automatycznie zastępowane rzeczywistymi wartościami. Użyj formatu ${#nazwazminnej#} aby dołączyć zmienną.
Dane Transakcji
| Zmienna | Opis |
|---|---|
${#transactionid#} | Unikalny identyfikator transakcji |
${#visitorid#} | ID odwiedzającego (ciasteczko śledzenia) |
${#commission#} | Kwota prowizji |
${#totalcost#} | Całkowita wartość zamówienia |
${#fixedcost#} | Kwota stałego kosztu |
${#orderid#} | ID zamówienia z Twojego systemu e-commerce |
${#productid#} | ID produktu |
${#dateinserted#} | Data i godzina utworzenia transakcji |
${#dateapproved#} | Data i godzina zatwierdzenia transakcji |
${#tier#} | Poziom prowizji |
${#status#} | Status transakcji (Zatwierdzona, Oczekująca, Odrzucona) |
${#statuscode#} | Kod statusu (A, P, D) |
${#type#} | Typ transakcji (Sprzedaż, Akcja itp.) |
Dane Kampanii i Banera
| Zmienna | Opis |
|---|---|
${#campaignid#} | Identyfikator kampanii |
${#campaignname#} | Nazwa kampanii |
${#bannerid#} | Identyfikator banera |
${#channel#} | Nazwa kanału |
${#channel_code#} | Kod kanału |
${#coupon_code#} | Użyty kod kuponu |
Dane Partnera
| Zmienna | Opis |
|---|---|
${#userid#} | ID użytkownika partnera |
${#refid#} | ID polecenia partnera |
Dane Kliknięcia
| Zmienna | Opis |
|---|---|
${#firstclicktime#} | Znacznik czasu pierwszego kliknięcia |
${#firstclickreferer#} | URL referrera pierwszego kliknięcia |
${#firstclickip#} | Adres IP pierwszego kliknięcia |
${#firstclickdata1#} | Niestandardowe dane 1 pierwszego kliknięcia |
${#firstclickdata2#} | Niestandardowe dane 2 pierwszego kliknięcia |
${#lastclicktime#} | Znacznik czasu ostatniego kliknięcia |
${#lastclickreferer#} | URL referrera ostatniego kliknięcia |
${#lastclickip#} | Adres IP ostatniego kliknięcia |
${#lastclickdata1#} | Niestandardowe dane 1 ostatniego kliknięcia |
${#lastclickdata2#} | Niestandardowe dane 2 ostatniego kliknięcia |
Niestandardowe Dane Transakcji
| Zmienna | Opis |
|---|---|
${#saledata1#} | Niestandardowe pole danych transakcji 1 |
${#saledata2#} | Niestandardowe pole danych transakcji 2 |
${#saledata3#} | Niestandardowe pole danych transakcji 3 |
${#saledata4#} | Niestandardowe pole danych transakcji 4 |
${#saledata5#} | Niestandardowe pole danych transakcji 5 |
Dane Geograficzne i Techniczne
| Zmienna | Opis |
|---|---|
${#ip#} | Adres IP klienta |
${#countrycode#} | Kod kraju na podstawie IP |
${#refererurl#} | URL referrera |
Dane Walutowe
| Zmienna | Opis |
|---|---|
${#originalcurrency#} | Nazwa oryginalnej waluty |
${#originalcurrencyvalue#} | Wartość oryginalnej waluty |
${#originalcurrencyrate#} | Użyty kurs wymiany |
Notatki
| Zmienna | Opis |
|---|---|
${#merchantnote#} | Notatka widoczna dla partnera |
${#systemnote#} | Notatka widoczna tylko dla sprzedawcy |
${#actionName#} | Nazwa typu prowizji za akcję |
${#actionCode#} | Kod typu prowizji za akcję |
Dostępne Zmienne dla Webhooków Rejestracji
Dla webhooków rejestracji partnerów możesz używać zmiennych profilu partnera:
| Zmienna | Opis |
|---|---|
${#username#} | E-mail/nazwa użytkownika partnera |
${#firstname#} | Imię partnera |
${#lastname#} | Nazwisko partnera |
${#name#} | Pełne imię i nazwisko |
${#userId#} | ID użytkownika partnera |
| Niestandardowe pola | Dowolne niestandardowe pole profilu po jego kodzie |
Obsługa Wielopoziomowa
Domyślnie webhooki są wykonywane tylko dla prowizji poziomu 1 (bezpośrednich). Możesz włączyć opcję “Wykonaj dla każdego poziomu” aby wyzwalać webhooki dla wszystkich poziomów w wielopoziomowych strukturach prowizji.
Jest to przydatne gdy:
- Musisz śledzić prowizje na wszystkich poziomach swojej hierarchii partnerskiej
- Twój zewnętrzny system musi wiedzieć o zarobkach sub-partnerów
- Budujesz kompleksowe raportowanie obejmujące wszystkie poziomy prowizji
Opcje Filtrowania Webhooków
Możesz skonfigurować webhooki, aby były bardziej specyficzne:
Według Typu Prowizji
Ogranicz webhook do określonego typu prowizji (np. tylko dla prowizji za akcję “Sprzedaż Premium”).
Według Partnera
Twórz webhooki, które uruchamiają się tylko dla określonego partnera. Jest to przydatne dla:
- Partnerów używających własnych systemów śledzenia
- Specjalnych integracji dla najlepszych partnerów
- Testowania webhooków z jednym partnerem przed wdrożeniem
Według Konta (Tryb Sieciowy)
W Post Affiliate Network możesz tworzyć webhooki specyficzne dla konta.
Log i Monitorowanie Webhooków
Post Affiliate Pro utrzymuje kompleksowy log wszystkich wykonań webhooków, dostępny w panelu sprzedawcy w Narzędzia > Log Callbacków.
- ID Logu - Unikalny identyfikator każdego wykonania webhooka
- ID Callbacka - Która konfiguracja webhooka została użyta
- URL Żądania - Pełny URL, który został wywołany (ze zastąpionymi zmiennymi)
- Data Utworzenia - Kiedy webhook został dodany do kolejki
- Ostatnia Próba - Kiedy wykonano ostatnią próbę wykonania
- Numer Próby - Ile razy system próbował wykonać
- Status - Oczekujący, Wysłany lub Błąd
- Komunikat Błędu - Szczegóły jeśli webhook nie powiódł się
Automatyczne Ponawianie
Jeśli webhook nie powiedzie się (np. Twój serwer jest tymczasowo niedostępny), Post Affiliate Pro automatycznie ponowi żądanie. Zapewnia to niezawodne dostarczanie nawet podczas tymczasowych awarii.
Retencja Logów
Logi webhooków są automatycznie czyszczone po konfigurowalnej liczbie dni (domyślnie: 60 dni). Możesz dostosować to w Konfiguracja > Funkcje > Callbacki Aplikacji.
Zarządzanie Webhookami
Przepływ Zatwierdzania
Domyślnie webhooki utworzone przez partnerów wymagają zatwierdzenia sprzedawcy przed aktywacją. Sprzedawcy mogą:
- Włączyć automatyczne zatwierdzanie - Automatycznie zatwierdzaj wszystkie nowe webhooki
- Ręcznie przeglądać - Zatwierdzaj lub odrzucaj każdy webhook indywidualnie
Zarządzanie Statusem
Webhooki mają trzy możliwe statusy:
- Zatwierdzony - Aktywny i będzie wykonywany po wyzwoleniu
- Oczekujący - Oczekuje na zatwierdzenie sprzedawcy
- Odrzucony - Odrzucony i nie będzie wykonywany
Sprzedawcy mogą zmienić status webhooka w dowolnym momencie z ekranu zarządzania webhookami.
Powiadomienia E-mail
Post Affiliate Pro może wysyłać powiadomienia e-mail o zdarzeniach związanych z webhookami:
Powiadomienia Sprzedawcy
- Nowy webhook utworzony przez partnera
Powiadomienia Partnera (Opcjonalne)
- Status webhooka zmieniony (zatwierdzony/odrzucony)
- Webhook zmodyfikowany przez sprzedawcę
- Webhook usunięty przez sprzedawcę
Te powiadomienia można włączyć lub wyłączyć w Konfiguracja > Powiadomienia E-mail.
Przykłady Zastosowań
1. Integracja CRM
Wyślij dane nowej sprzedaży do swojego CRM gdy transakcja jest zatwierdzana:
https://crm.przyklad.com/api/sales?customer_order=${#orderid#}&value=${#totalcost#}&affiliate=${#refid#}
2. Powiadomienie Slack
Powiadom swój kanał zespołu gdy nowy partner się rejestruje:
https://hooks.slack.com/services/xxx/yyy?text=Nowy+partner:+${#firstname#}+${#lastname#}
3. Wyzwalacz Platformy E-mail
Dodaj klientów do sekwencji e-mail po zakupie:
POST https://email.przyklad.com/api/subscribers
Body: {"email": "${#saledata1#}", "purchase_value": "${#totalcost#}"}
4. Synchronizacja Oprogramowania Księgowego
Rejestruj płatności prowizji w swoim systemie księgowym:
https://ksiegowosc.przyklad.com/webhook?affiliate_id=${#userid#}&commission=${#commission#}&order=${#orderid#}
Jak Skonfigurować Webhook
- Zaloguj się do swojego Panelu Sprzedawcy
- Przejdź do Konfiguracja > Funkcje
- Aktywuj funkcję Callbacki Aplikacji
- Przejdź do Kampanie > [Wybierz Kampanię] > Callbacki lub globalnego menedżera callbacków
- Kliknij Dodaj Nowy Callback
- Skonfiguruj:
- Nazwa - Opisowa nazwa dla webhooka
- Typ - Śledzenie Sprzedaży lub Rejestracja Partnera
- Wykonanie - Kiedy wyzwalać (przy utworzeniu, zatwierdzeniu, odrzuceniu, zwrocie)
- Typ Żądania - GET, POST lub POST JSON
- URL - Twój endpoint ze zmiennymi
- Wykonaj dla każdego poziomu - Tak/Nie
- Zapisz webhook
Kwestie Bezpieczeństwa
- Używaj endpointów HTTPS dla bezpiecznej transmisji danych
- Rozważ dodanie tajnego parametru do weryfikacji źródła webhooka
- Implementuj ograniczanie szybkości na swoim endpoincie odbierającym
- Waliduj przychodzące dane przed przetworzeniem
- Zachowuj logi webhooków do celów audytu
Powiązane Funkcje
- Śledzenie S2S - Śledzenie serwer-serwer dla dokładnych konwersji
- API - Pełny programowy dostęp do Post Affiliate Pro
- API v3 - Nowoczesne RESTful API z OAuth 2.0
