Przewodnik użytkownika

Przejście z wersji 1

Moduł Order Source Tracking 1.x (tak wcześniej nazywał się ten moduł) aktualizuje się w miejscu, z zachowaniem danych. Moduł ma nową nazwę, nowe menu i nowy sposób rejestrowania wizyt, a jego pulpit liczy inaczej. Ten rozdział opisuje, czego się spodziewać.

Jak przeprowadzić aktualizację

Sprawdzić, czy sklep działa na PrestaShop 8.0 lub nowszym. Wersja 2 nie instaluje się na PrestaShop 1.7; taki sklep pozostaje przy wersji 1.
Otworzyć Moduły › Menedżer modułów, kliknąć Załaduj moduł i wybrać nowy plik zip. PrestaShop przeprowadza aktualizację.
Otworzyć Zamówienia › Źródła zamówień › Ustawienia i przejrzeć kartę Lista kontrolna.

Wersji 1 nie trzeba najpierw odinstalowywać. Jeśli aktualizacja zatrzyma się w połowie, na przykład dlatego, że przetwarzanie dużej tabeli trwa zbyt długo, należy ponownie załadować plik zip: aktualizacja będzie kontynuowana od miejsca, w którym się zatrzymała.

Co zostaje zachowane

Dane wersji 1	Po aktualizacji
Źródła zamówień	Zachowane dla każdego zamówienia, które nadal istnieje. Źródło i medium są teraz zapisane małymi literami, więc „Facebook” i „facebook” stały się jednym źródłem.
Wizyty	Zachowane, jeśli są młodsze niż 13 miesięcy. Starsze wizyty nie są przenoszone. Duża tabela jest kopiowana miesiąc po miesiącu, od najnowszego; czego nie dokończy aktualizacja, dokończy codzienne porządkowanie. Skopiowane wizyty nie mają strony docelowej, słowa kluczowego, treści ani rodzaju kliknięcia reklamy: wersja 1 ich nie zapisywała.
Ustawienia	Zachowane: okno atrybucji, reguły odsyłaczy, wykluczone witryny, adresy testowe oraz dwa przełączniki kolumn pierwszego i ostatniego kontaktu w zakładce Zamówienia modułu.
Odwiedzający w trakcie ścieżki	Odwiedzający, który przyszedł przed aktualizacją, a zamawia po niej, nadal otrzymuje prawidłowy pierwszy i ostatni kontakt: moduł jednorazowo odczytuje pliki cookie wersji 1, a potem je usuwa.
Tabele wersji 1	Aktualizacja ich nie zmienia. Pozostają przez 30 dni jako zabezpieczenie, a potem usuwa je porządkowanie. Do tego czasu Lista kontrolna pokazuje pomarańczowy wiersz z tą informacją, a sekcja Dane i utrzymanie podaje datę. To informacja, a nie problem.

Co się zmieniło

Temat	Wersja 1	Teraz
Nazwa i menu	Order Source Tracking: trzy pozycje w menu Zamówienia i ustawienia w Menedżerze modułów	Order Source Pro: jedna pozycja, Źródła zamówień, z zakładkami Pulpit, Zamówienia, Wizyty i Ustawienia
Zamówienia potwierdzane w tle przez operatora płatności	Nie miały źródła	Otrzymują źródło: przechodzi ono razem z koszykiem
Zamówienia utworzone w panelu administracyjnym	Otrzymywały źródło z własnych wizyt pracownika	Nie mają źródła, co odpowiada prawdzie
Reguły odsyłaczy i wykluczone witryny	Były zapisywane, ale nigdy nie były używane	Działają
Powrót ze strony płatności	Mógł stać się źródłem zamówienia	Nigdy się nie liczy; własne domeny i popularni operatorzy płatności są wykluczeni
Kliknięcia reklam bez parametrów UTM	Nierozpoznawane	Rozpoznawane (Platformy reklamowe: rozpoznawanie bez parametrów UTM)
Co zapisuje wizyta	Adres IP, przeglądarkę, urządzenie i oglądane strony	Nic z tego (Co jest zapisywane, a co nie)
Ustawienia	Jedna strona w Menedżerze modułów	Zakładka z sekcjami i nowymi ustawieniami wykrywania, zgody, przechowywania i wyświetlania. Mają na początku te same wartości co po nowej instalacji (Ustawienia)

Ekrany, których już nie ma

Dwa ekrany importu CSV, ekran eksportu odwiedzających i eksport zakresu dat nad listą zamówień. Zakładki Zamówienia i Wizyty eksportują dane przyciskiem swojej listy.
Strona szczegółów odwiedzającego. Wszystko, co zawiera wizyta, jest na liście.
Ustawienia „Track First UTM” i „Track Last UTM”. Nigdy nie działały.

Nowe liczby na pulpicie

Po aktualizacji pulpit wyświetla komunikat: „Liczby na tej stronie zmieniły się w wersji 2.1. Liczą się tylko ważne zamówienia, a przychód to kwota zapłacona bez podatku i bez wysyłki, w walucie domyślnej, tak jak na pulpicie PrestaShop. Zamówienie jest liczone w dniu, w którym zostało złożone.” Komunikat pozostaje widoczny do kliknięcia Ukryj. Dzień, w którym liczy się zamówienie, czyli jedyną celowo zachowaną różnicę, objaśnia Co oznacza każda liczba. Co kryje się za komunikatem:

Liczba	Wersja 1 liczyła	Teraz
Zamówienia	Każde zamówienie, także anulowane i nieopłacone	Tylko ważne zamówienia, i to wszystkie: zamówienia bez źródła tworzą wiersz Nieśledzone
Przychód	Sumy zamówień, bez przeliczania walut	Bez podatku i bez wysyłki, przeliczony na walutę domyślną
Zamówienia bez źródła	„Unknown”	Nieśledzone, a wskaźnik Śledzone zamówienia podaje, ile zamówień ma źródło

Dlatego sumy z minionego miesiąca mogą się różnić od tych z wersji 1. Nic nie zginęło: anulowane i nieopłacone zamówienia już się nie liczą, a przychód pomija podatek i wysyłkę. Aby raportować z podatkiem, należy przełączyć Przychód na pulpicie na Z podatkiem (Zamówienia: gdzie jest wyświetlane źródło). W multisklepie stare wizyty, które nie doprowadziły do zamówienia, należą wszystkie do sklepu domyślnego (Wizyty z wersji 1).

Pytania i problemy

Warto zacząć od karty Lista kontrolna w zakładce Ustawienia › Przegląd: widać tam większość problemów, z linkiem do sekcji, w której można je naprawić. Błąd modułu nie zatrzymuje żadnej strony sklepu: zamiast tego jest zapisywany w menu Zaawansowane › Logi, w wierszu zaczynającym się od pch_ordersource.

Problemy

Nie pojawiają się żadne wizyty

Wykonać wizytę testową: otworzyć sklep w oknie prywatnym i dodać ?utm_source=test do adresu. Jeśli ustawiono opcję Po zaakceptowaniu plików cookie przez odwiedzającego, najpierw zaakceptować baner cookie na tej stronie. Po minucie otworzyć zakładkę Wizyty.
Jeśli wizyty brakuje, a rejestrowanie czeka na zgodę, baner być może nie przekazuje modułowi odpowiedzi odwiedzającego: wtedy nic nie jest rejestrowane (Zgoda: kiedy może zacząć się rejestrowanie).
Sprawdzić Ustawienia › Wykrywanie. Przy opcji Tylko serwer i pamięci podręcznej stron wizyty na stronach z pamięci podręcznej nie są rejestrowane. Wybrać Tylko skrypt, jak wyjaśnia Sklep korzysta z pamięci podręcznej stron lub CDN.
Przy opcji Tylko skrypt przeglądarka, która blokuje skrypty, albo reguła zapory sieciowej przed sklepem może zatrzymać zgłoszenie skryptu. Spróbować w innej przeglądarce, bez rozszerzeń.
Nadal nic? Włączyć Zapisuj decyzje w logach w zakładce Ustawienia › Dane i utrzymanie, powtórzyć wizytę testową i przeczytać Zaawansowane › Logi: moduł zapisuje, co zarejestrował lub pominął i dlaczego, w wierszach zaczynających się od pch_ordersource. Potem wyłączyć to ustawienie.

Niektóre wejścia są celowo pomijane: roboty wyszukiwarek i narzędzia monitorujące, strona, którą przeglądarka tylko wczytuje z wyprzedzeniem, oraz powrót ze strony płatności.

Zamówienia bez źródła (Nieśledzone)

Zamówienie nie ma źródła, gdy moduł nie mógł powiązać go z wizytą. Typowe przyczyny:

Zamówienie zostało utworzone w panelu administracyjnym lub przez API (webservice).
Zamówienie zostało złożone przed instalacją modułu.
Przeglądarka odwiedzającego odrzuciła lub usunęła plik cookie albo odwiedzający nie wyraził zgody w banerze cookie.
Sama wizyta nie została zarejestrowana, z jednej z przyczyn opisanych wyżej.

Pewien odsetek nieśledzonych zamówień jest normalny. Jego wielkość pokazuje wskaźnik Śledzone zamówienia na pulpicie. Jeśli wskaźnik jest niski, najpierw należy sprawdzić ustawienie zgody: przy opcji Po zaakceptowaniu plików cookie przez odwiedzającego każdy odwiedzający, który nie wyrazi zgody, nie jest śledzony.

Liczby różnią się od Google Analytics

Będą się różnić i żadne z narzędzi nie jest w błędzie. Oba liczą co innego:

Różnica	Order Source Pro	Usługa analityczna
Zamówienia	Rzeczywiste zamówienia sklepu, jeśli są ważne, także te potwierdzone w tle przez operatora płatności.	Zamówienia, które jej skrypt zobaczył na stronie potwierdzenia.
Przychód	Bez wysyłki, bez podatku, chyba że wybrano inaczej, w walucie domyślnej.	To, co wysyła kod śledzący sklepu, często z podatkiem i wysyłką.
Która wizyta otrzymuje zamówienie	Pierwszy kontakt albo ostatni kontakt, który nie był bezpośredni, w oknie atrybucji.	Według własnego modelu i własnego okna.
Wizyta	Jedno wejście; kończy ją 30 minut bez wyświetlenia strony.	Sesja według własnych zasad.
Kto jest liczony	Zależy od ustawień w sekcjach Wykrywanie i Zgoda.	Zależy od własnych ustawień zgody i od blokerów skryptów.

Lepiej porównywać z pulpitem PrestaShop: liczy zamówienia i sprzedaż według tych samych zasad. Jedyną celowo zachowaną różnicę, czyli dzień, w którym liczy się zamówienie, opisuje Co oznacza każda liczba.

Sklep korzysta z pamięci podręcznej stron lub CDN

W zakładce Ustawienia › Wykrywanie należy wybrać Tylko skrypt, jak radzi pomoc pola. To właściwa opcja, gdy pamięć podręczna lub CDN usuwa pliki cookie z przechowywanych stron. Nigdy Tylko serwer: strona z pamięci podręcznej jest wysyłana bez udziału sklepu. Lista kontrolna ostrzega, gdy znajdzie moduł pamięci podręcznej stron razem z opcją Tylko serwer. Jeśli pamięć podręczna jest skonfigurowana poza PrestaShop, na przykład u firmy hostingowej, lista kontrolna jej nie widzi: ustawienie trzeba wtedy wybrać samodzielnie.

Sklep ma baner cookie

Trzeba zdecydować, czy odwiedzający muszą wyrazić zgodę, zanim będą śledzeni; to kwestia prawna (Zgoda: kiedy może zacząć się rejestrowanie). Jeśli tak, należy wybrać Po zaakceptowaniu plików cookie przez odwiedzającego i upewnić się, że baner przekazuje odpowiedź: baner z Google Consent Mode robi to sam, każdy inny potrzebuje jednego wywołania. Potem przetestować: w oknie prywatnym wizyta powinna pojawić się w zakładce Wizyty dopiero po akceptacji.

Wśród źródeł pojawia się operator płatności

Należy dodać jego domenę w zakładce Ustawienia › Wykluczone witryny (Wykluczone witryny: strony, z których klient tylko wraca). Wizyty już zarejestrowane zachowują swoje źródło; nowe już go nie otrzymują.

Witryna partnera figuruje pod swoją domeną albo liczą się własne wizyty

Witryna bez reguły jest zapisywana pod swoją domeną jako link z innej witryny: wybrane źródło można jej nadać w zakładce Ustawienia › Reguły odsyłaczy (Reguły odsyłaczy: wybrane źródło dla witryny). Aby własne wizyty nie trafiały na pulpit, należy dodać swój adres w polu Testowe adresy IP w zakładce Ustawienia › Atrybucja.

Lista kontrolna informuje, że porządkowanie nie zostało wykonane

Porządkowanie uruchamia się, gdy ktoś otworzy panel administracyjny. Należy kliknąć Uruchom teraz w zakładce Ustawienia › Dane i utrzymanie. Dla sklepu, którego panel administracyjny nie jest otwierany codziennie, zaplanowane zadanie powinno raz dziennie wywoływać Adres konserwacji (Adres konserwacji).

Brakuje wizyt z jednego biura lub jednej sieci

Aby powstrzymać zalew wizyt, moduł rejestruje najwyżej 30 nowych wizyt na minutę z jednego adresu. Prawdziwi odwiedzający nigdy tego nie osiągają, chyba że sklep działa za serwerem proxy lub CDN, który pokazuje sklepowi jeden adres dla wszystkich. Firma hostingowa może skonfigurować serwer tak, aby sklep widział prawdziwy adres każdego odwiedzającego.

Pracownik nie może otworzyć zakładek modułu

Cztery zakładki są stronami menu panelu administracyjnego. Profilowi pracownika należy nadać prawo do ich wyświetlania w menu Zaawansowane › Zespół › Uprawnienia. Kolumna Źródło i karta Źródło zamówienia nie wymagają osobnego uprawnienia.

Znane ograniczenia

Ograniczenie	Co oznacza (cecha sposobu działania modułu, a nie błąd)
Jedna przeglądarka to jeden odwiedzający	Ktoś, kto kliknie reklamę na telefonie, a kupi na laptopie, to dwóch odwiedzających. Zamówienie otrzymuje źródło wizyty z laptopa.
Zamówienia utworzone w panelu administracyjnym	Nie mają źródła: nie prowadzi do nich żadna wizyta klienta. To samo dotyczy zamówień, które przychodzą przez API (webservice).
Odwiedzający, którzy odrzucają plik cookie	Nie są śledzeni, a ich zamówienia nie mają źródła. Przy opcji Po zaakceptowaniu plików cookie przez odwiedzającego dotyczy to każdego odwiedzającego, który nie wyrazi zgody. Przeglądarka, która nie przechowuje plików cookie, wygląda na nową na każdej stronie; limit zalewu wizyt nie pozwala jej zapełnić list.
Późno wyrażona zgoda	Przy opcji Po zaakceptowaniu plików cookie przez odwiedzającego odwiedzający, który zaakceptuje dopiero po opuszczeniu pierwszej strony, jest rejestrowany jako wizyta bezpośrednia.
Serwer proxy, który ukrywa adresy odwiedzających	Limit zalewu wizyt liczy wtedy wszystkich razem (patrz wyżej).
Kilka sklepów	Sklep w katalogu innego sklepu dzieli z nim odwiedzających. Wizyty z wersji 1, które nie doprowadziły do zamówienia, są w sklepie domyślnym (Kilka sklepów).
Tylko pierwszy i ostatni kontakt	Moduł nie dzieli zamówienia między kilka źródeł i nie importuje kosztów reklam. Zamówienie otrzymuje źródło raz: ustawienie lub reguła zmienione później nie zmieniają zapisanych już zamówień i wizyt.
PrestaShop 1.7	Nieobsługiwany przez wersję 2.

Najczęściej zadawane pytania

Co widzą klienci?

Nic: żadnego okna wyskakującego ani banera. W zależności od ustawienia w sekcji Wykrywanie po wczytaniu strony ładowany jest jeden mały skrypt. Wysyła jedno krótkie zgłoszenie na wizytę, do własnego sklepu.

Dlaczego wiersz „bezpośrednie” jest tak duży?

Do wizyt bezpośrednich trafia każda wizyta, która nie mówi nic o swoim pochodzeniu: wpisane adresy i zakładki, ale też linki w aplikacjach, programach pocztowych i wiadomościach, które nie mają parametrów. Po oznaczeniu publikowanych linków parametrami UTM (Tworzenie linków kampanii) ten udział maleje.

Pomoc techniczna

PrestaChamps rozwija ten moduł i zapewnia dla niego pomoc techniczną. Można zalogować się na addons.prestashop.com, otworzyć zamówienie modułu Order Source Pro i napisać do dewelopera przez formularz kontaktowy. Należy podać wersje PrestaShop, PHP i modułu, opisać, czego się oczekiwało i co dzieje się zamiast tego, oraz dołączyć zrzut ekranu karty Lista kontrolna. Jeśli brakuje wizyt lub źródeł, należy włączyć Zapisuj decyzje w logach, powtórzyć sytuację i przesłać nam wiersze modułu z Zaawansowane › Logi. Nigdy nie należy wysyłać własnego hasła: jeśli będziemy musieli zajrzeć do panelu administracyjnego, poprosimy o tymczasowe konto pracownika.

Dla programistów

Ten rozdział jest przeznaczony dla osoby, która konfiguruje baner cookie, serwer lub raporty sklepu: wywołania JavaScript dla banera cookie, adres dla zaplanowanego zadania i tabele, na których opierają się listy.

Wywołania JavaScript dla banera cookie

Mają znaczenie tylko wtedy, gdy pole Kiedy zaczyna się rejestrowanie ma wartość Po zaakceptowaniu plików cookie przez odwiedzającego (Zgoda: kiedy może zacząć się rejestrowanie). Skrypt modułu niczego wtedy nie zapisuje i nie ustawia pliku cookie, dopóki nie dowie się, że odwiedzający wyraził zgodę.

Google Consent Mode

Nie trzeba nic dodawać. Skrypt odczytuje wpisy zgody, które baner przekazuje do window.dataLayer:

Wpis, który ustawia analytics_storage na granted, uruchamia rejestrowanie, niezależnie od tego, czy jest to wpis default, czy update.
Wpis update, który ustawia tę wartość na denied, wycofuje zgodę.
Wpis default z wartością denied to stan początkowy banera: niczego nie zmienia.

Każdy inny baner

window.pchOrderSource.grantConsent();    // odwiedzający zaakceptował statystyczne pliki cookie
window.pchOrderSource.revokeConsent();   // odwiedzający wycofał zgodę lub odmówił po wcześniejszej akceptacji

Baner, który wcześnie zna zapisaną odpowiedź, może zamiast tego ustawić flagę, zanim uruchomi się skrypt modułu: window.pchOrderSourceConsent = 'granted' lub 'denied'.

Co się dzieje	Skutek
Zgoda zostaje wyrażona na stronie, na którą trafił odwiedzający	Wizyta jest rejestrowana z prawdziwym źródłem. Kolejne strony tej samej wizyty nie potrzebują nowego sygnału.
Zgoda zostaje wyrażona na późniejszej stronie	Wizyta jest rejestrowana jako bezpośrednia: kampania wejścia nie jest już znana.
Zgoda zostaje wycofana	Skrypt usuwa znacznik wizyty, a sklep usuwa oba pliki cookie. Wizyty już zapisane nie są usuwane (Eksport i usuwanie danych klienta).

Aby sprawdzić konfigurację, należy otworzyć sklep w oknie prywatnym: przed akceptacją nie może istnieć żaden plik cookie o nazwie pch_os_v ani pch_os_s; po akceptacji istnieją oba, a wizyta jest w zakładce Wizyty.

Adres konserwacji

Porządkowanie uruchamia się, gdy ktoś otworzy panel administracyjny. Jeśli panel pozostaje zamknięty przez wiele dni, zaplanowane zadanie (cron) powinno raz dziennie wywoływać adres konserwacji.

Otworzyć Ustawienia › Dane i utrzymanie i kliknąć Kopiuj obok pola Adres konserwacji.
W panelu hostingu utworzyć zaplanowane zadanie, które wywołuje ten adres raz dziennie, o spokojnej porze. Większość paneli ma pole na adres; na serwerze z wierszem poleceń wystarczy taki wiersz:

# codziennie o 03:15; skopiowany adres wkleić między cudzysłowy
15 3 * * * curl -fsS "PASTE-THE-MAINTENANCE-ADDRESS-HERE" > /dev/null

Udane wywołanie zwraca OK i informację, co zostało usunięte, na przykład OK visits=0 cart_links=0 legacy_tables=0. Adres zawiera tajny token: należy traktować go jak hasło. Wywołanie bez prawidłowego tokenu jest odrzucane i nic nie robi. To ten sam adres dla wszystkich sklepów multisklepu.

Tabele

Moduł przechowuje dane w czterech tabelach, których nazwy poprzedza prefiks tabel sklepu (w większości sklepów ps_). Można je odczytywać na potrzeby własnych raportów; nie należy do nich zapisywać.

Tabela	Jeden wiersz to
`pch_ordersource_visit`	Wizyta: `visitor_key`, `id_shop`, `date_add`, `source`, `medium`, `campaign`, `term`, `content`, `click_id_type`, `landing_path`, `referrer_host`, `id_order`, `is_test`, `origin`.
`pch_ordersource_order`	Źródło zamówienia: `id_order`, `id_shop`, następnie `first_source`, `first_medium`, `first_campaign`, `first_term`, `first_content`, `first_click_id_type`, `first_landing_path`, `first_date` oraz tych samych osiem kolumn z prefiksem `last_`.
`pch_ordersource_cart`	Powiązanie koszyka z jego odwiedzającym: `id_cart`, `visitor_key`, `date_add`.
`pch_ordersource_guard`	Licznik limitu zalewu wizyt. Codzienne porządkowanie usuwa jego wiersze.

Wartości, które warto znać

Wizyta bezpośrednia jest zapisywana ze źródłem (direct) i medium (none). Link z utm_source bez utm_medium ma medium (not set).
click_id_type jest puste lub ma jedną z wartości google, microsoft, tiktok, meta.
origin mówi, jak wizyta została zarejestrowana: 0 przez sklep, 1 przez skrypt, 2 skopiowana z wersji 1, 3 odczytana z pliku cookie wersji 1. Wiersze z wartością 3 istnieją tylko na potrzeby atrybucji; przy liczeniu wizyt należy je pomijać, tak jak robi to pulpit.
Pulpit liczy zamówienia z valid = 1 według date_add i sumuje (total_paid_tax_excl - total_shipping_tax_excl) / conversion_rate (z podatkiem: dwie kolumny _tax_incl). Zamówienie bez wiersza w pch_ordersource_order nie jest śledzone.

Jak moduł łączy się ze sklepem

Zgłoszenie skryptu. Jedno krótkie żądanie na wizytę do adresu /module/pch_ordersource/beacon własnego sklepu; ten adres przyjmuje żądania wyłącznie ze stron sklepu. Zapora sieciowa przed sklepem musi je przepuszczać.
Zamówienie. Moduł wiąże koszyk z jego odwiedzającym, gdy koszyk zostaje zapisany na stronach sklepu widocznych dla klientów, i zapisuje źródło, gdy PrestaShop zatwierdza zamówienie. W tym momencie nie odczytuje żadnego pliku cookie, więc zamówienie potwierdzone przez serwer operatora płatności również otrzymuje źródło. Koszyki utworzone w panelu administracyjnym lub przez API (webservice) nie są wiązane.

↑

Przejście z wersji 1 — Order Source Pro