PS PrestaShop Początkujący

DataFirefly Affiliate Program: program partnerski dla PrestaShop

Instalacja, konfiguracja i obsługa programu partnerskiego: pulpit, śledzenie linków, prowizje z okresem weryfikacji, reguły i symulator, zestawienia SEPA lub PayPal, strefa partnera i materiały promocyjne.

Zaktualizowano Wersja modułu 2.0.0

Instalacja i aktualizacja

Zainstaluj moduł w Moduły > Menedżer modułów > Załaduj moduł, przesyłając plik ZIP. Ten sam plik ZIP działa w PrestaShop 1.7.8, 8 i 9.

Podczas instalacji moduł tworzy swoje tabele i ustawienia domyślne oraz dodaje menu Sprzedaż > Afiliacja z siedmioma pozycjami: Pulpit, Partnerzy, Prowizje, Zestawienia i wypłaty, Reguły prowizji, Materiały promocyjne i Ustawienia. Wspólne menu u góry każdej strony pozwala przechodzić między nimi.

Aby przejść z wersji 1.0.0 lub 1.1.0 na 2.0.0, po prostu prześlij nowy plik ZIP. Skrypt aktualizacji zachowuje partnerów, linki, kliknięcia, prowizje, zestawienia, reguły i ustawienia oraz dodaje nowe elementy:

  • zapisane wcześniej numery IBAN są szyfrowane;
  • prowizje, których termin jeszcze nie minął, przechodzą do etapu „okres weryfikacji”;
  • nowe ustawienia otrzymują wartości domyślne.

Przed uruchomieniem programu sprawdź w Ustawieniach status lub statusy zamówienia potwierdzające płatność, okres weryfikacji i minimalną wypłatę. Pulpit pokazuje następnie kontrolę konfiguracji, która wskazuje, czego brakuje.

Pulpit

Pulpit programu partnerskiego: kliknięcia, przypisane zamówienia, wygenerowany obrót, prowizje do wypłaty i zadania
Pulpit programu partnerskiego: kliknięcia, przypisane zamówienia, wygenerowany obrót, prowizje do wypłaty i zadania

Pulpit podsumowuje aktywność z ostatnich 7 dni, 30 dni, 90 dni lub 12 miesięcy:

  • Wskaźniki: kliknięcia i unikalni odwiedzający, przypisane zamówienia i konwersja kliknięć, wygenerowany przychód (podstawa prowizji od zamówień, bez kosztów wysyłki), zarobione prowizje i ich udział w przychodzie, prowizje do wypłaty, aktywni partnerzy, zamówienia odrzucone jako zamówienia własne lub podwójnie nagradzane.
  • Wykres kliknięć i przychodu według dni lub, dla 12 miesięcy, według miesięcy.
  • Gdzie są prowizje: oczekujące na płatność za zamówienie, w okresie weryfikacji, do wypłaty, w zestawieniach do opłacenia, opłacone.
  • Do zrobienia: zgłoszenia do rozpatrzenia, oczekujące prowizje, zestawienia do utworzenia lub opłacenia, partnerzy bez danych do wypłaty – każda pozycja z przyciskiem otwierającym właściwą listę.
  • Kontrola konfiguracji, najlepsi partnerzy, najczęściej klikane linki i najnowsze prowizje.

Śledzenie i atrybucja

Linki śledzące

Każdy partner ma kod. Przenoszą go dwa rodzaje linków:

  • parametr śledzenia dodany do dowolnego adresu sklepu: ?aff=CODE. Nazwę parametru można zmienić w ustawieniach;
  • krótkie linki /go/…, które partner tworzy w swojej strefie. Przekierowują one na wybraną stronę i zliczają kliknięcia oraz zamówienia dla każdego linku. Akceptowane są tylko adresy sklepu: link nigdy nie może prowadzić do innej witryny.

Po kliknięciu cookie dfaff_ref zapisuje partnera. Jest ono podpisane (odwiedzający nie może go zmienić), ma atrybuty HttpOnly i SameSite=Lax, a jego ważność ustawia się w ustawieniach lub dla każdego partnera. Atrybucja jest też kopiowana do koszyka, co obejmuje płatności potwierdzane później przez bank.

Nigdy nie są liczone:

  • roboty i podglądy linków w serwisach społecznościowych i komunikatorach;
  • wstępne pobieranie przez przeglądarkę i żądania HEAD;
  • kliknięcia samego partnera;
  • odświeżenia i powtórne kliknięcia tego samego odwiedzającego w ten sam link w wybranym czasie (domyślnie 30 minut).
Ustawienia śledzenia: parametr URL, czas życia cookie, ostatnie lub pierwsze kliknięcie, powtórne kliknięcia i oczekiwanie na zgodę
Ustawienia śledzenia: parametr URL, czas życia cookie, ostatnie lub pierwsze kliknięcie, powtórne kliknięcia i oczekiwanie na zgodę

Ustawienie Cookie atrybucji i zgoda oferuje dwa sposoby działania:

  • Zapisuj cookie przy każdej śledzonej wizycie;
  • Czekaj na zgodę odwiedzającego: cookie jest zapisywane tylko wtedy, gdy cookie twojego banera zgody istnieje i zawiera podany tekst, na przykład tarteaucitron i dfaffiliate=true. Bez zgody kliknięcie jest nadal liczone w statystykach, ale zamówienie może przypisać tylko kod rabatowy partnera.

Status tego cookie w świetle przepisów zależy od twojego kraju i sposobu użycia: skonsultuj go ze swoim doradcą. Moduł nie gwarantuje zgodności z przepisami.

Kolejność przypisywania zamówienia

  1. Osobisty kod rabatowy partnera użyty w zamówieniu, nawet bez kliknięcia.
  2. Link lub cookie.
  3. Klient pozyskany wcześniej przez tego partnera, jeśli prowizje od powracających klientów są włączone.

Model atrybucji rozstrzyga przypadek, gdy odwiedzający kliknie linki dwóch partnerów: ostatnie kliknięcie (domyślnie) – wygrywa ostatnio odwiedzony partner; pierwsze kliknięcie – pierwszy partner zachowuje sprzedaż do wygaśnięcia cookie.

Prowizje

Cykl prowizji

Prowizje według etapu: oczekiwanie na płatność, okres weryfikacji do daty, do wypłaty, wypłacone lub odrzucone
Prowizje według etapu: oczekiwanie na płatność, okres weryfikacji do daty, do wypłaty, wypłacone lub odrzucone
  1. Oczekuje na płatność za zamówienie: zamówienie zostało złożone. Zamówienie opłacane przelewem lub czekiem pozostaje na tym etapie, dopóki nie potwierdzisz płatności.
  2. Okres weryfikacji: zamówienie osiąga status potwierdzający płatność. Prowizja czeka wybraną liczbę dni (domyślnie 30), aby objąć termin odstąpienia od umowy i zwroty. Wyświetlana jest data zakończenia.
  3. Do wypłaty: okres minął, prowizja trafi do następnego zestawienia.
  4. W zestawieniu, a następnie Opłacone, gdy oznaczysz zestawienie jako opłacone.

Okresy weryfikacji kończą się automatycznie: przez zadanie cron, jeśli go używasz, a w przeciwnym razie przy otwarciu panelu administracyjnego modułu lub strefy partnera.

Przypadki szczególne:

  • Zamówienie anulowane lub zwrócone: prowizja jest odrzucana, dopóki nie została wypłacona. Jeśli zamówienie zostanie następnie ponownie opłacone, prowizja wraca z nowym okresem weryfikacji.
  • Częściowy zwrot (korekta): prowizja jest obniżana proporcjonalnie do zwróconych produktów.
  • Po wypłacie: moduł nie zmienia już wypłaconej prowizji, tylko tworzy korektę ujemną, odliczaną od następnego zestawienia. Kolejna zmiana statusu nie tworzy nowego potrącenia.
  • Jedna prowizja na zamówienie: ponowne otwarcie strony potwierdzenia, otrzymanie dwóch powiadomień o płatności lub kilkukrotne przejście przez ten sam status nigdy nie tworzy duplikatu (blokada i unikalny klucz w bazie danych).

Na liście prowizji akcja grupowa Zatwierdź teraz (kończy okres weryfikacji) kończy okres weryfikacji wybranych prowizji. Odrzuca ona zamówienia, które nie są jeszcze opłacone, i podaje ich numery referencyjne.

Obliczanie

  • Podstawa: produkty netto lub brutto (do wyboru), nigdy koszty wysyłki.
  • Kupony: odliczane proporcjonalnie na każdej pozycji, jeśli opcja jest włączona. Kupon na darmową wysyłkę nie jest odliczany.
  • Waluty: zamówienia złożone w innej walucie są przeliczane po kursie zapisanym w zamówieniu.
  • Zaokrąglenie: tylko raz na zamówienie, z dokładnością do 0,01.
  • Kwota stała: jedna prowizja na zamówienie, tylko jedna także wtedy, gdy PrestaShop dzieli koszyk na kilka zamówień.
  • Powracający klienci: przez wybraną liczbę dni kolejne zamówienia pozyskanego klienta dają prowizję według stawki partnera lub osobnej stawki.

Żadna kwota nie pochodzi z przeglądarki: wszystko jest przeliczane na podstawie zamówienia zapisanego przez PrestaShop.

Reguły prowizji i symulator

Symulator reguł: zamówienie odtworzone pozycja po pozycji, zastosowana stawka i obowiązująca reguła
Symulator reguł: zamówienie odtworzone pozycja po pozycji, zastosowana stawka i obowiązująca reguła

Reguła ustala stawkę dla kategorii lub produktu, dla wszystkich partnerów lub dla jednego. Dla każdej pozycji zamówienia obowiązuje następująca kolejność:

  1. reguła produktu;
  2. reguła kategorii domyślnej produktu;
  3. najkorzystniejsza reguła pozostałych kategorii;
  4. stawka partnera lub programu.

Reguła przypisana do jednego partnera ma pierwszeństwo przed taką samą regułą dla wszystkich. Reguła może zastępować stawkę (reguła 0% wyklucza produkty) lub dodawać się do niej: partner ze stawką 10% i regułą „+2” otrzymuje 12%, maksymalnie 100%. Reguły nie dotyczą kwot stałych.

Symulator u góry strony reguł odpowiada na pytanie „jaka stawka obowiązuje i dlaczego?” dla produktu i partnera albo odtwarza istniejące zamówienie pozycja po pozycji, niczego nie tworząc.

Prowizje ręczne

Dodaj prowizję ręczną uznaje lub obciąża konto partnera (kwota ujemna oznacza potrącenie), z notatką widoczną w jego strefie.

Oszustwa i podwójne nagrody

Nadużycia i wypłaty: porównanie adresów, współistnienie z programem poleceń, minimalna wypłata i plik SEPA
Nadużycia i wypłaty: porównanie adresów, współistnienie z programem poleceń, minimalna wypłata i plik SEPA
  • Zamówienie złożone z tego samego konta klienta, z tym samym adresem e-mail lub – jeśli opcja jest włączona – dostarczane albo fakturowane na adres partnera jest zapisywane jako Odrzucony, z powodem czytelnym dla sprzedawcy i partnera.
  • Gdy moduł DataFirefly Loyalty & Referral jest aktywny, zamówienie, które już nagradza polecającego, nie daje prowizji partnerskiej (ustawienie można zmienić). Dane modułu poleceń są tylko odczytywane, nigdy nie są zmieniane. Oba moduły używają różnych parametrów URL i różnych cookie.
  • Tylko nowi klienci i Minimalna kwota zamówienia uzupełniają te zabezpieczenia.

Partnerzy

Zgłoszenia

Publiczna strona programu partnerskiego: prezentacja, warunki, kroki i odpowiedzi na pytania
Publiczna strona programu partnerskiego: prezentacja, warunki, kroki i odpowiedzi na pytania

Publiczna strona programu przedstawia twoje warunki (stawka, ważność cookie, okres weryfikacji, minimalna wypłata), kolejne kroki oraz najczęściej zadawane pytania generowane na podstawie twoich ustawień. Tekst prezentacji można edytować w każdym języku.

Formularz zgłoszenia: strona lub kanał, odbiorcy i akceptacja warunków, następnie weryfikowany przez sprzedawcę
Formularz zgłoszenia: strona lub kanał, odbiorcy i akceptacja warunków, następnie weryfikowany przez sprzedawcę

Kandydat musi być zalogowany na konto klienta. Podaje, gdzie publikuje, i opisuje swoich odbiorców. Jeśli wybrano stronę CMS z regulaminem, musi go zaakceptować. Domyślnie każde zgłoszenie czeka na twoje zatwierdzenie, a na adres powiadomień wysyłany jest e-mail.

Lista i karta partnera

Lista partnerów: kod, kanał, status, kliknięcia, zamówienia i salda, zbiorcze zatwierdzanie zgłoszeń
Lista partnerów: kod, kanał, status, kliknięcia, zamówienia i salda, zbiorcze zatwierdzanie zgłoszeń

Lista pokazuje kod, kanał, status, kliknięcia, zamówienia i salda. Akcje grupowe zatwierdzają, odrzucają lub zawieszają kilka zgłoszeń naraz. Eksport CSV neutralizuje komórki, które arkusz kalkulacyjny mógłby odczytać jako formuły.

Pełna karta partnera: wskaźniki, saldo według etapu, warunki, zamaskowany IBAN, linki, prowizje, zestawienia i dane osobowe
Pełna karta partnera: wskaźniki, saldo według etapu, warunki, zamaskowany IBAN, linki, prowizje, zestawienia i dane osobowe

Karta partnera zbiera na jednej stronie:

  • profil z przyciskami Zatwierdź, Odrzuć, Zawieś i Edytuj;
  • wskaźniki i saldo według etapów;
  • warunki (stawka, własne reguły, cookie, kod rabatowy) i link śledzący;
  • dane do wypłaty z zamaskowanym numerem IBAN;
  • zgłoszenie;
  • linki z ostatnich 30 dni, najnowsze prowizje i zestawienia.

Blok Dane osobowe eksportuje w formacie JSON dane, które moduł przechowuje o partnerze. Pozwala też go zanonimizować: imię i nazwisko, e-mail, witryna, dane do wypłaty, linki i kliknięcia są usuwane, a prowizje i zestawienia pozostają na potrzeby twojej księgowości.

W formularzu edycji numer IBAN nigdy nie jest ponownie wyświetlany jawnie: pozostaw pole puste, aby zachować zapisany numer, lub wpisz nowy.

Co widzi partner

Panel partnera: salda w weryfikacji, do wypłaty i wypłacone, link śledzący, statystyki z 30 dni i warunki
Panel partnera: salda w weryfikacji, do wypłaty i wypłacone, link śledzący, statystyki z 30 dni i warunki

Strefa partnera otwiera się nagłówkiem z jego kodem, stawką i saldami (w weryfikacji, do wypłaty, opłacone), a pod nim jest sześć zakładek. Działa z motywami Classic i Hummingbird.

  • Przegląd: generator linków, wskaźniki, wykres z ostatnich 30 dni, warunki i ostatnie linki.
  • Generator linków: tworzenie krótkiego linku do dowolnej strony sklepu, lista linków z kliknięciami i zamówieniami, kopiowanie i usuwanie.
  • Statystyki: kliknięcia, zamówienia, konwersja, sprzedaż i prowizje w okresie od 7 dni do 12 miesięcy, źródła kliknięć i wyniki poszczególnych linków.
  • Prowizje: etap każdej prowizji, przewidywana data wypłaty, zamaskowany numer referencyjny zamówienia. Nie są wyświetlane żadne dane klienta.
  • Wypłaty: miesięczne zestawienia do wglądu i wydruku, wybór przelewu SEPA lub PayPal, IBAN sprawdzany na podstawie cyfr kontrolnych, szyfrowany i wyświetlany w formie zamaskowanej, e-maile o sprzedaży.
  • Materiały promocyjne: gotowe banery i teksty z już wstawionym linkiem śledzącym partnera.
Generator linków: krótki link do dowolnej strony sklepu, kliknięcia i zamówienia dla każdego linku
Generator linków: krótki link do dowolnej strony sklepu, kliknięcia i zamówienia dla każdego linku
Statystyki partnera: kliknięcia, zamówienia, konwersja, sprzedaż według okresu, źródła i linku
Statystyki partnera: kliknięcia, zamówienia, konwersja, sprzedaż według okresu, źródła i linku
Historia prowizji: etapy od płatności do wypłaty, zamaskowany numer zamówienia, brak danych klienta
Historia prowizji: etapy od płatności do wypłaty, zamaskowany numer zamówienia, brak danych klienta
Wypłaty partnera: miesięczne zestawienia, przelew SEPA lub PayPal, IBAN zaszyfrowany i pokazany w formie zamaskowanej
Wypłaty partnera: miesięczne zestawienia, przelew SEPA lub PayPal, IBAN zaszyfrowany i pokazany w formie zamaskowanej

Partner widzi tylko własne dane: jego linki, prowizje i zestawienia są sprawdzane przy każdym wyświetleniu, a formularze są chronione tokenem.

Materiały promocyjne

Materiały promocyjne: banery i teksty dla partnerów, z podglądem, rozmiarem i stroną docelową
Materiały promocyjne: banery i teksty dla partnerów, z podglądem, rozmiarem i stroną docelową

W sekcji Materiały promocyjne dodaj banery (JPG, PNG, GIF lub WebP, maksymalnie 2 MB) i gotowe teksty, z nazwą i tekstem alternatywnym w każdym języku oraz stroną sklepu, do której prowadzą. Kolejność ustawia się metodą przeciągnij i upuść.

Materiały promocyjne dla partnerów: banery i tekst z wbudowanym linkiem śledzącym, kopiowane jednym kliknięciem
Materiały promocyjne dla partnerów: banery i tekst z wbudowanym linkiem śledzącym, kopiowane jednym kliknięciem

Każdy partner kopiuje kod HTML banera, tekst i link z już wstawionym własnym linkiem śledzącym. Zakładka pojawia się w strefie partnera tylko wtedy, gdy istnieje co najmniej jeden aktywny element.

Zestawienia i wypłaty

Zestawienia i wypłaty: miesięczne zestawienia, eksport SEPA lub PayPal, płatność oznaczana tylko raz
Zestawienia i wypłaty: miesięczne zestawienia, eksport SEPA lub PayPal, płatność oznaczana tylko raz

Wypłata odbywa się w czterech krokach, przypomnianych u góry strony:

  1. Utwórz zestawienia: wybierz miesiąc, sprawdź podgląd kwot dla każdego partnera, a następnie utwórz zestawienia. Zestawienie obejmuje prowizje do wypłaty utworzone przed końcem miesiąca oraz korekty ujemne. Poniżej minimalnej wypłaty saldo przechodzi na kolejny okres.
  2. Eksportuj plik płatności: zaznacz zestawienia, a następnie akcję grupową Eksportuj plik przelewów SEPA (XML) (pain.001.001.03) lub Eksportuj plik PayPal Payouts (CSV). Eksport CSV dla księgowości zawiera zamaskowany numer IBAN.
  3. Zapłać w swoim banku lub w PayPal: moduł nigdy nie wysyła pieniędzy.
  4. Oznacz jako opłacone, podając numer referencyjny i datę przelewu.
Zestawienie partnera: pozycje prowizji, kwota do zapłaty, zamaskowane dane bankowe i tytuł przelewu
Zestawienie partnera: pozycje prowizji, kwota do zapłaty, zamaskowane dane bankowe i tytuł przelewu

Opłaconego zestawienia nie można ponownie wyeksportować ani opłacić. Eksport płatności jest odrzucany w całości, jeśli wybrane zestawienie jest już opłacone lub brakuje danych: komunikat podaje, którego partnera to dotyczy i gdzie uzupełnić dane.

Zadanie cron (opcjonalnie)

Adres URL cron znajduje się w ustawieniach. Kończy on okresy weryfikacji i – jeśli opcja jest włączona – między 1. a 5. dniem miesiąca tworzy zestawienia za poprzedni miesiąc. Jest chroniony tokenem, nigdy nie uruchamia się dwa razy jednocześnie i nigdy niczego nie wypłaca.

E-maile

Moduł wysyła cztery e-maile, przetłumaczone na 8 języków i wysyłane w języku odbiorcy, łącznie z tematem i kwotami: nowe zgłoszenie (do sprzedawcy), aktywacja konta partnera, nowa sprzedaż i dostępne zestawienie.

E-mail „nowa sprzedaż” wysyłany do partnera: prowizja, kwota zamówienia i stawka, bez danych klienta
E-mail „nowa sprzedaż” wysyłany do partnera: prowizja, kwota zamówienia i stawka, bez danych klienta
E-mail z miesięcznym zestawieniem: okres, kwota, liczba prowizji i link do zestawienia w panelu partnera
E-mail z miesięcznym zestawieniem: okres, kwota, liczba prowizji i link do zestawienia w panelu partnera

E-mail o nowej sprzedaży podaje prowizję, kwotę zamówienia i stawkę, nigdy dane klienta. Każdy partner może go wyłączyć. Szablony znajdują się w katalogu mails/ modułu.

Ustawienia

Strona ustawień jest podzielona na pięć bloków:

  • Śledzenie i atrybucja: parametr URL, ważność cookie, model atrybucji, czas ignorowania powtórnych kliknięć, zgoda, powracający klienci.
  • Prowizje: domyślny typ i stawka, podstawa netto lub brutto, odliczanie kuponów, tylko nowi klienci, minimalna kwota zamówienia, statusy potwierdzające płatność lub odrzucające prowizję, okres weryfikacji.
  • Oszustwa i podwójne nagrody.
  • Zestawienia i wypłaty: minimalna wypłata, zestawienia przez cron, dane SEPA firmy.
  • Zgłoszenia i strona programu: automatyczne zatwierdzanie, e-maile, tekst prezentacji, strona z regulaminem, kolor akcentu.

Komunikaty o błędach wskazują, co poprawić, na przykład „IBAN firmy: cyfry kontrolne się nie zgadzają”.

RODO

Moduł rejestruje się w oficjalnym module RODO (GDPR) PrestaShop. Eksport danych klienta obejmuje jego profil partnera i prowizje, z zamaskowanym numerem IBAN. Usunięcie danych anonimizuje partnera, zachowując prowizje i zestawienia. Te same działania są dostępne z karty partnera. Narzędzia te pomagają obsługiwać żądania, ale nie stanowią gwarancji zgodności z przepisami.

Rozwiązywanie problemów

Żadne kliknięcie nie jest liczone

Testuj w oknie prywatnym przeglądarki, bez logowania na konto partnera. Zautomatyzowane przeglądarki są filtrowane jak roboty. Przy opcji „Czekaj na zgodę odwiedzającego” najpierw zaakceptuj usługę w swoim banerze. Jeśli sklep korzysta z pamięci podręcznej całych stron, używaj krótkich linków /go/, które zawsze przechodzą przez PrestaShop.

Prowizja pozostaje w stanie „Oczekuje na płatność za zamówienie”

Sprawdź, czy bieżący status zamówienia jest zaznaczony w polu Zamówienie opłacone przy. Zamówienie opłacane przelewem lub czekiem pozostaje oczekujące, dopóki nie potwierdzisz płatności.

Eksport SEPA jest odrzucany

Przeczytaj wyświetlony komunikat: wskazuje on zestawienie, które jest już opłacone, lub partnera, któremu brakuje numeru IBAN. Sprawdź też nazwę firmy i IBAN firmy oraz to, czy domyślną walutą jest euro.

Kompatybilność

  • PrestaShop 1.7.8, 8 i 9: ten sam plik ZIP obsługuje wszystkie trzy wersje, z motywami Classic i Hummingbird.
  • Wiele sklepów: partnerzy, prowizje i statystyki filtrowane według sklepu. Wiele walut: przeliczanie po kursie z zamówienia.
  • Moduł i e-maile w języku angielskim, francuskim, hiszpańskim, niemieckim, włoskim, niderlandzkim, polskim i portugalskim.
Czy ta strona była pomocna?

Nadal utknąłeś? Napisz do wsparcia