WebePartners — Dokumentacja integracji

Wprowadzenie #

Tracking działa poprzez lekki snippet JavaScript (webe.js) wczytywany na każdej stronie sklepu. Snippet automatycznie identyfikuje użytkownika który trafił przez link afiliacyjny i rejestruje zamówienie gdy dojdzie do zakupu.

Do działania potrzebujesz ID serwisu (MID) — otrzymasz go od opiekuna WebePartners.

1 Instalacja snippetu #

Wklej poniższy kod w sekcji <head> na każdej stronie sklepu. Zastąp TWOJE_MID swoim ID serwisu.

html

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

Atrybut data-webe-mid identyfikuje Twój serwis — snippet odczytuje go automatycznie. Atrybut async zapewnia że snippet ładuje się nieblokująco i nie wpływa na wydajność strony.

2 Event zamówienia #

Na stronie podziękowania za zamówienie wywołaj funkcję window.__webe.order(). Snippet musi być już załadowany, dlatego używamy zdarzenia window.load.

html

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

Parametry

Parametr	Typ	Wymagany	Opis
`orderId`	string	TAK	Numer lub ID zamówienia ze sklepu
`total`	number	TAK	Wartość brutto zamówienia bez kosztów wysyłki
`dc`	string	nie	Użyty kod rabatowy

⚠ Wartości orderId i total muszą być dynamicznie podstawiane przez backend sklepu — nie wpisuj ich na stałe w szablonie.

WooCommerce #

Dodaj poniższy kod do pliku functions.php aktywnego motywu lub wtyczki.

functions.php

php

add_action('woocommerce_thankyou', function () {
   = wc_get_order();
  ?>
  <script>
  window.addEventListener('load', async function () {
    await window.__webe.order({
      orderId: '<?= esc_js(->get_order_number()) ?>',
      total:   <?= ->get_total() ?>,
      dc:      '<?= esc_js(implode(',', ->get_coupon_codes())) ?>',
    });
  });
  </script>
  <?php
});

PrestaShop #

Wklej snippet w szablonie strony podziękowania order-confirmation.tpl.

order-confirmation.tpl

smarty

<script>
window.addEventListener('load', async function () {
  await window.__webe.order({
    orderId: '{.reference}',
    total:   {.total_paid},
    dc:      '{.discount_name|default:""}',
  });
});
</script>

Shoper / inne platformy #

Wklej snippet JS w sekcji „Kod na stronie podziękowania" w ustawieniach sklepu, podstawiając odpowiednie zmienne szablonu.

Parametr	Shoper	IdoSell
`orderId`	`{order.id}`	`{order_id}`
`total`	`{order.total}`	`{order_total}`
`dc`	`{order.discount_code}`	`{discount_code}`

Dla innych platform skonsultuj dokumentację — szukaj zmiennych odpowiadających numerowi zamówienia i wartości koszyka.

Testowanie #

Po wdrożeniu złóż testowe zamówienie i otwórz DevTools → zakładka Network. Na stronie podziękowania powinien pojawić się request do:

https://order.webep1.com/o/neworder.js?mid=TWOJE_MID&refer=NR_ZAMOWIENIA&sum=WARTOSC

Status 200 = zamówienie zarejestrowane poprawnie

Jeśli request nie pojawia się — upewnij się że snippet jest wczytany w sekcji <head> i że TWOJE_MID zostało zastąpione właściwym ID serwisu.