PS PrestaShop PrestaShop Średnio zaawansowany

SERP Tracker: kompletny przewodnik

Instalacja, konfiguracja i praca ze śledzeniem pozycji w Google: dostawca SERP, słowa kluczowe według kraju i urządzenia, pulpit, dystans do czołówki, wskaźnik widoczności, konkurenci, alerty i cron dla PrestaShop 8 i 9.

Zaktualizowano Wersja modułu 1.0.0

Prezentacja

Moduł SERP Tracker (dfserptracker) śledzi pozycje Twojego sklepu w wynikach wyszukiwania Google, bezpośrednio z panelu administracyjnego PrestaShop. Deklarujesz swoje słowa kluczowe (wraz z krajem i urządzeniem), moduł regularnie pobiera ich pozycję przez wybranego przez Ciebie dostawcę API SERP, przechowuje historię każdego odczytu, wylicza Twoje szanse i powiadamia Cię e-mailem, gdy strona traci pozycję.

SERP Tracker nie scrapuje Google: opiera się na oficjalnym API SERP, do którego podajesz własny klucz. Odczyty są dzięki temu wiarygodne, stabilne i zgodne z warunkami korzystania z Google. Natywnie obsługiwanych jest czterech dostawców: Serper.dev, ValueSERP, SerpApi i DataForSEO.

Zgodność

  • PrestaShop 8.0 do 9.x
  • PHP 7.4 do 8.3
  • MySQL 5.6+ lub MariaDB 10.3+
  • Tryb jednosklepowy i multisklep (śledzenie izolowane per sklep)
  • 5 języków: FR, EN, ES, DE, IT
  • Zgodność z hostingiem współdzielonym (o2switch, OVH itd.)
  • Brak zależności Composer (własny autoloader); wykresy renderowane przez Chart.js dołączony lokalnie, bez CDN

Instalacja

  1. W panelu administracyjnym otwórz Moduły > Menedżer modułów.
  2. Kliknij Wgraj moduł i wybierz plik dfserptracker.zip.
  3. Po instalacji kliknij Konfiguruj.

Podczas instalacji moduł tworzy swoje dwie tabele (df_serp_keyword i df_serp_position), rejestruje zakładki administracyjne w menu SERP Tracker (Pulpit, Słowa kluczowe, Konkurenci) i ustawia wartości domyślne, w tym losowy token crona.

Wybór i konfiguracja dostawcy SERP

Przed pierwszym odczytem musisz wybrać dostawcę i wpisać swój klucz API na stronie konfiguracji modułu.

  • Serper.dev: wpisz klucz w polu Klucz API Serper. Prosty i tani, idealny na start.
  • ValueSERP: wpisz klucz w polu Klucz API ValueSERP.
  • SerpApi: wpisz klucz w polu Klucz API SerpApi.
  • DataForSEO: ten dostawca stosuje uwierzytelnianie loginem i hasłem. Wpisz swój Login DataForSEO oraz Hasło DataForSEO.

Moduł kupujesz jednorazowo; odczyty zużywają kredyty u wybranego przez Ciebie dostawcy, zgodnie z Twoim własnym kontem i liczbą słów kluczowych. Większość dostawców oferuje darmowy lub bardzo tani pakiet na start.

Dopóki żaden dostawca nie jest poprawnie skonfigurowany, na pulpicie wyświetla się baner ostrzegawczy. Sprawdź, czy wpisany klucz odpowiada dostawcy wybranemu na liście rozwijanej Dostawca.

Konfiguracja

Domyślny kontekst wyszukiwania

  • Śledzona domena: domena, której pozycję chcesz wykrywać (domyślnie domena sklepu). Moduł porównuje tę domenę z wynikami organicznymi, pomijając przedrostek www.
  • Domyślny kraj i Domyślne urządzenie (komputer lub telefon): stosowane do nowych słów kluczowych, nadpisywane indywidualnie na każdym słowie kluczowym.
  • Głębokość wyników: liczba wyników analizowanych przy każdym odczycie (poza nią pozycja jest uznawana za „niesklasyfikowaną”).

Alerty

  • Włącz alerty: uruchamia wysyłkę e-maili przy istotnych zmianach pozycji.
  • Adres e-mail odbiorcy: adres, który otrzymuje alerty.
  • Próg spadku: liczba utraconych miejsc, od której wyzwalany jest alert.

Harmonogram

  • Rozmiar partii: liczba słów kluczowych przetwarzanych przy każdym przebiegu crona.
  • Okres przechowywania historii: czas przechowywania odczytów; starsze odczyty są automatycznie czyszczone.
  • Adres URL crona: adres tylko do odczytu, chroniony tokenem, uruchamiany z crona Twojego hostingu (zobacz sekcję Automatyczne odczyty).

Dodawanie słów kluczowych i zarządzanie nimi

Otwórz zakładkę Słowa kluczowe, następnie Dodaj słowo kluczowe. Każde słowo kluczowe niesie własny kontekst:

  • Słowo kluczowe: śledzone zapytanie.
  • Docelowy adres URL (opcjonalny): strona, którą chcesz widzieć na pozycji. Jeśli go podasz, moduł faworyzuje dokładne dopasowanie tego adresu; w przeciwnym razie bierze pierwszą stronę z Twojej domeny.
  • Tag: etykieta grupująca (linia produktów, tematyka i tak dalej) do filtrowania słów kluczowych.
  • Język, Kraj i Urządzenie: kontekst wyszukiwania właściwy dla tego słowa kluczowego.
  • Wolumen wyszukiwań (opcjonalny): wartość orientacyjna.
  • Aktywne: cron pobiera pozycje wyłącznie dla aktywnych słów kluczowych.

Lista słów kluczowych pokazuje bieżącą pozycję, z kolorową etykietą i strzałką zmiany (▲ / ▼) względem poprzedniego odczytu. Pozycja 0 oznacza „niesklasyfikowany” w analizowanej głębokości.

Możesz uruchomić natychmiastowy odczyt bez czekania na crona: użyj akcji Sprawdź teraz na wierszu albo zaznacz kilka słów kluczowych i zastosuj akcję masową Sprawdź. Akcje masowe pozwalają też włączać, wyłączać i usuwać partiami.

Pulpit

Zakładka Pulpit podsumowuje Twoje pozycjonowanie w 7 wskaźnikach:

  • Wskaźnik widoczności (0 do 100): ogólny wynik ważony krzywą CTR według pozycji. Słowo kluczowe na pierwszej pozycji waży dużo więcej niż to na dole strony. To wskaźnik trendu, który warto śledzić w czasie.
  • Łącznie śledzonych: liczba aktywnych słów kluczowych.
  • Top 3 i Top 10: liczba słów kluczowych na trzech i dziesięciu pierwszych miejscach.
  • Dystans do czołówki: słowa kluczowe na pozycjach od 4 do 20, czyli Twoje najbardziej opłacalne szanse.
  • Średnia pozycja: średnia z pozycji sklasyfikowanych.
  • Niesklasyfikowane: słowa kluczowe, które wypadły poza analizowaną głębokość.

Pod wskaźnikami wykres pierścieniowy pokazuje rozkład Twoich pozycji (top 3 / top 10 / dystans do czołówki / niesklasyfikowane). Dwie tabele wymieniają Twoich zyskujących i tracących pomiędzy dwoma ostatnimi odczytami, a tabela dystans do czołówki wyodrębnia słowa kluczowe o dużym potencjale. Przycisk Uruchom wszystkie odczyty wykonuje natychmiastowy odczyt wszystkich zaległych słów kluczowych (w AJAX, bez opuszczania strony).

Konkurenci i funkcje SERP

Przy każdym odczycie moduł wykrywa funkcje SERP: featured snippet (wraz z identyfikacją jego właściciela, Ty albo konkurent), People Also Ask i local pack.

Zakładka Konkurenci agreguje domeny pojawiające się na Twoich zapytaniach na podstawie ostatniego odczytu każdego słowa kluczowego, liczy ich wystąpienia i wylicza średnią pozycję. Wyświetlanych jest 30 najczęściej obecnych domen, aby jednym rzutem oka widzieć, kto depcze Ci po piętach w całym zakresie.

Automatyczne odczyty (cron)

Aby zautomatyzować odczyty, uruchamiaj adres URL crona z harmonogramu zadań swojego hostingu (cron o2switch, OVH itd.). Adres, chroniony tokenem, jest wyświetlany tylko do odczytu w konfiguracji.

Przy każdym przebiegu cron przetwarza partię zaległych słów kluczowych (zgodnie ze skonfigurowanym rozmiarem partii), rozkłada wywołania w czasie, aby uszanować limity dostawcy, a następnie stosuje Twój okres przechowywania, czyszcząc stare odczyty. Adres URL przyjmuje dwa opcjonalne parametry: limit (liczba słów kluczowych do przetworzenia) i id_shop (wskazany sklep w trybie multisklep).

Token crona chroni endpoint przed nieautoryzowanymi wywołaniami. Nie udostępniaj go publicznie. Każde żądanie bez poprawnego tokenu jest odrzucane.

Alerty

Gdy alerty są włączone, SERP Tracker wysyła e-mail (szablony HTML i tekstowy, po francusku i angielsku), gdy słowo kluczowe odnotowuje istotną zmianę:

  • wejście do top 3 lub wyjście z niego;
  • wypadnięcie z top 10;
  • utrata pozycji (słowo kluczowe przestaje się pojawiać);
  • spadek powyżej skonfigurowanego progu;
  • zdobycie featured snippetu.

E-mail przypomina, którego słowa kluczowego dotyczy, podaje starą i nową pozycję, powód lub powody alertu oraz sklasyfikowany adres URL.

FAQ i rozwiązywanie problemów

Pulpit pokazuje „brak skonfigurowanego dostawcy”

Sprawdź, czy wybrałeś dostawcę na liście rozwijanej Dostawca i wpisałeś odpowiadający mu klucz (albo login i hasło w przypadku DataForSEO). Baner znika, gdy tylko zostanie wykryty poprawny dostawca.

Moje słowa kluczowe nie aktualizują się automatycznie

Moduł pobiera pozycje wyłącznie wtedy, gdy wywoływany jest adres URL crona. Skonfiguruj zadanie cykliczne u swojego hostingodawcy, aby uruchamiał ten adres z żądaną częstotliwością (na przykład raz dziennie). Do tego czasu przycisk Uruchom wszystkie odczyty i akcja Sprawdź teraz pozwalają na odczyty ręczne.

Pozycja pokazuje 0

Pozycja 0 oznacza, że Twoja domena nie została znaleziona w analizowanej głębokości wyników. Ewentualnie zwiększ głębokość w konfiguracji albo sprawdź docelowy adres URL i kontekst (kraj, urządzenie) słowa kluczowego.

Dlaczego nie scrapować Google bezpośrednio?

Bezpośrednie scrapowanie jest kruche, szybko blokowane i niezgodne z warunkami korzystania z Google. Korzystanie z oficjalnego API SERP sprawia, że odczyty pozostają wiarygodne i zgodne z regulaminem. Zachowujesz kontrolę nad kosztami przez własne konto u dostawcy.

Jak liczony jest wskaźnik widoczności?

Każda pozycja jest przeliczana na szacowany CTR według krzywej pozycji, a całość sprowadzana do wyniku od 0 do 100. To wskaźnik trendu: rośnie, gdy Twoje słowa kluczowe ogólnie przesuwają się w górę wyników.

Czy moduł jest zgodny z PrestaShop 9 i multisklepem?

Tak. Moduł jest zgodny z PrestaShop 8 i 9, a w trybie multisklep śledzenie jest izolowane per sklep. Kontrolery opierają się na ModuleAdminController, aby pozostać zgodne między PS8 i PS9.

Czy ta strona była pomocna?

Nadal utknąłeś? Napisz do wsparcia