Integracja śledzenia

Dwa wklejenia w szablon sklepu i sieć wie, które zamówienia przyprowadził który wydawca. Zajmuje kilkanaście minut i nie wymaga niczego po stronie serwera.

Jak to działa

Wydawca wystawia u siebie link do Twojego sklepu. Kupujący, który w niego kliknie, przechodzi przez nasze przekierowanie — zapisujemy wtedy kliknięcie i oznaczamy przeglądarkę identyfikatorem.

Gdy ten sam kupujący złoży u Ciebie zamówienie, skrypt ze strony podziękowania zgłasza nam jego numer i wartość. Szukamy pasującego kliknięcia i na tej podstawie naliczamy prowizję wydawcy.

Nie potrzebujemy danych osobowych. Zgłoszenie niesie numer zamówienia, kwotę i ewentualny kod rabatowy. Imienia, adresu, telefonu ani adresu e-mail kupującego nie zbieramy i prosimy ich nie wysyłać.

1. Skrypt na każdej stronie sklepu

Wklej w sekcję <head> szablonu, tak żeby ładował się na każdej podstronie. TWOJE_MID zamień na numer, który dostałeś od opiekuna.

<script
  src="https://webeh1.com/webe.js"
  data-webe-mid="TWOJE_MID"
  async></script>

Skrypt zapamiętuje identyfikator kupującego na czas wizyty w sklepie. Dlatego musi stać na wszystkich podstronach, a nie tylko na stronie podziękowania: kupujący wchodzi z linku na kartę produktu, a zamówienie składa kilka kliknięć później.

2. Zgłoszenie zamówienia

Na stronie podziękowania za zamówienie, po załadowaniu strony:

<script>
  window.addEventListener('load', function () {
    window.__webe.order({
      orderId: 'TX-9912',   // numer zamówienia, wymagany
      total:   599.00,      // wartość brutto bez kosztów wysyłki
      dc:      'KOD20'      // kod rabatowy, opcjonalnie
    });
  });
</script>

Wartości podstawia Twój backend, tak samo jak podstawia je w podsumowaniu zamówienia obok. Kwota to liczba: bez waluty, bez spacji, z kropką jako separatorem dziesiętnym.

Numer zamówienia musi być ten sam, co u Ciebie w panelu. Po nim rozstrzygamy reklamacje i po nim rozpoznajemy powtórki, gdy kupujący odświeży stronę podziękowania. Numer tymczasowy, który zmienia się po płatności, da się podmienić — napisz do opiekuna, pokażemy jak.

Leady (model CPL)

Jeśli rozliczacie się za zgłoszenia, a nie za sprzedaż, zamiast order wywołaj lead. Reszta działa tak samo.

window.__webe.lead({
  orderId: 'ZGL-4471',   // unikalny numer zgłoszenia
  total:   0             // wartość, jeśli ją znacie
});

Własna integracja, bez naszego skryptu

Zamiast naszego skryptu możesz zgłosić zamówienie samodzielnie: wystarczy jedno żądanie GET ze strony podziękowania. Odpowiedzią jest przezroczysty obrazek, więc da się je wstawić jako <img>.

https://webeh1.com/o/neworder.js?mid=MID&refer=TX-9912&sum=599.00&type=cps

Żądanie musi wyjść z przeglądarki kupującego, nie z Twojego serwera — inaczej nie dojdzie do nas ani ciasteczko, ani identyfikator zapamiętany przez skrypt, i zamówienia nie da się powiązać z kliknięciem.

Parametry zgłoszenia

Parametr	Wymagany	Znaczenie
`mid`	tak	Numer Twojego serwisu w sieci.
`refer`	tak	Numer zamówienia, ten sam co w Twoim panelu.
`sum`	tak	Wartość brutto bez kosztów wysyłki. Liczba, kropka dziesiętna.
`type`	nie	`cps` sprzedaż (domyślnie), `cpl` lead.
`dc`	nie	Użyty kod rabatowy. Kilka kodów rozdziel dwukropkiem.
`local`	nie	Identyfikator zapamiętany przez nasz skrypt; dokleja go sam.

Sprawdzenie wdrożenia

Otwórz dowolną podstronę sklepu z narzędziami deweloperskimi (F12) i zakładką Network. Powinien się tam pojawić webe.js ze statusem 200.
Złóż zamówienie testowe. Na stronie podziękowania, w tej samej zakładce, poszukaj neworder.js. Status 200 i obrazek w odpowiedzi znaczą, że zgłoszenie do nas dotarło.
Sprawdź w adresie tego żądania, czy refer niesie prawdziwy numer zamówienia, a sum prawdziwą kwotę. Puste albo zerowe wartości to najczęstsza przyczyna braku prowizji.
Napisz do opiekuna, że wdrożenie jest gotowe. Sprawdzimy po swojej stronie, czy zamówienie się zapisało i czy dopasowało się do kliknięcia.

Najczęstsze pomyłki

Objaw	Przyczyna
Brak żądania `neworder.js`	Zdarzenie odpalone przed załadowaniem strony albo brak atrybutu `data-webe-mid` przy skrypcie.
Zamówienia bez kwoty	W `sum` poszedł tekst z walutą („599,00 zł") albo wartość koszyka sprzed podsumowania.
To samo zamówienie kilka razy	Numer zamówienia zmienia się po płatności. Powiedz opiekunowi — mamy na to osobną ścieżkę.
Zamówienia są, prowizji nie ma	Skrypt z pierwszego kroku stoi tylko na stronie podziękowania. Musi być na każdej podstronie.
Żądanie idzie, ale z serwera sklepu	Zgłoszenie musi wyjść z przeglądarki kupującego, inaczej nie niesie identyfikatora.