SERP Tracker: volledige gids
Installatie, configuratie en gebruik van de Google-positietracking: SERP-provider, trefwoorden per land en apparaat, dashboard, afstand tot de top, zichtbaarheidsindex, concurrenten, meldingen en cron voor PrestaShop 8 en 9.
Overzicht
De module SERP Tracker (dfserptracker) volgt de posities van uw winkel in de zoekresultaten van Google, direct vanuit de PrestaShop back-office. U declareert uw trefwoorden (met hun land en apparaat), de module meet regelmatig hun positie via een SERP-API-provider van uw keuze, bewaart de geschiedenis van elke meting, berekent uw kansen en waarschuwt u per e-mail wanneer een pagina zakt.
SERP Tracker scrapet Google niet: hij steunt op een officiële SERP-API waaraan u uw eigen sleutel levert. De metingen zijn zo betrouwbaar, stabiel en conform de gebruiksvoorwaarden van Google. Vier providers worden native ondersteund: Serper.dev, ValueSERP, SerpApi en DataForSEO.
Compatibiliteit
- PrestaShop 8.0 tot 9.x
- PHP 7.4 tot 8.3
- MySQL 5.6+ of MariaDB 10.3+
- Enkele winkel en multistore (tracking geïsoleerd per winkel)
- 5 talen: FR, EN, ES, DE, IT
- Compatibel met gedeelde hosting (o2switch, OVH, enzovoort)
- Geen Composer-afhankelijkheid (eigen autoloader); grafieken gerenderd met lokaal meegeleverd Chart.js, zonder CDN
Installatie
- Open in de back-office Modules > Modulebeheer.
- Klik op Een module installeren en selecteer het bestand
dfserptracker.zip. - Klik na de installatie op Configureren.
Bij de installatie maakt de module haar twee tabellen aan (df_serp_keyword en df_serp_position), registreert ze haar beheertabbladen onder het menu SERP Tracker (Dashboard, Trefwoorden, Concurrenten) en initialiseert ze haar standaardinstellingen, waaronder een willekeurig crontoken.
Een SERP-provider kiezen en configureren
Vóór elke meting moet u een provider kiezen en uw API-sleutel invullen op de configuratiepagina van de module.
- Serper.dev: vul uw sleutel in bij Serper API-sleutel. Eenvoudig en voordelig, ideaal om te starten.
- ValueSERP: vul uw sleutel in bij ValueSERP API-sleutel.
- SerpApi: vul uw sleutel in bij SerpApi API-sleutel.
- DataForSEO: deze provider gebruikt authenticatie met login en wachtwoord. Vul uw DataForSEO-login en uw DataForSEO-wachtwoord in.
De module wordt eenmalig verkocht; de metingen verbruiken credits bij de provider die u kiest, volgens uw eigen account en uw aantal trefwoorden. De meeste providers bieden een gratis of zeer goedkoop instapaanbod.
Op het dashboard verschijnt een waarschuwingsbanner zolang er geen provider correct is geconfigureerd. Controleer of de ingevoerde sleutel overeenkomt met de provider die in het keuzemenu Provider is geselecteerd.
Configuratie
Standaardzoekcontext
- Gevolgd domein: het domein waarvan u de positie wilt detecteren (standaard het domein van de winkel). De module vergelijkt dit domein met de organische resultaten en negeert daarbij het voorvoegsel
www. - Standaardland en Standaardapparaat (desktop of mobiel): toegepast op nieuwe trefwoorden, per trefwoord te overschrijven.
- Resultaatdiepte: aantal geanalyseerde resultaten per meting (daarbuiten wordt de positie als “niet gerangschikt” beschouwd).
Meldingen
- Meldingen inschakelen: activeert het versturen van e-mails bij significante positieveranderingen.
- Bestemmings-e-mailadres: het adres dat de meldingen ontvangt.
- Daaldrempel: aantal plaatsen achteruitgang waarbij een melding wordt geactiveerd.
Planning
- Batchgrootte: aantal trefwoorden dat per cronrun wordt verwerkt.
- Bewaartermijn van de geschiedenis: bewaarduur van de metingen; oudere metingen worden automatisch opgeschoond.
- Cron-URL: alleen-lezen adres, beveiligd met een token, aan te roepen vanuit de cron van uw hoster (zie de sectie Automatische metingen).
Trefwoorden toevoegen en beheren
Open het tabblad Trefwoorden en dan Een trefwoord toevoegen. Elk trefwoord draagt zijn context:
- Trefwoord: de te volgen zoekopdracht.
- Doel-URL (optioneel): de pagina die u gepositioneerd wilt zien. Als ze is ingevuld, geeft de module voorrang aan een exacte match van deze URL; anders houdt hij de eerste pagina van uw domein aan.
- Tag: groeperingslabel (assortiment, thema…) om uw trefwoorden te filteren.
- Taal, Land en Apparaat: de zoekcontext van dit trefwoord.
- Zoekvolume (optioneel): ter indicatie.
- Actief: alleen actieve trefwoorden worden door de cron gemeten.
De trefwoordenlijst toont de huidige positie, met een gekleurd label en een evolutiepijl (▲ / ▼) ten opzichte van de vorige meting. Positie 0 betekent “niet gerangschikt” binnen de geanalyseerde diepte.
U kunt een directe meting starten zonder op de cron te wachten: gebruik de actie Nu controleren op een regel, of selecteer meerdere trefwoorden en pas de bulkactie Controleren toe. Met de bulkacties kunt u ook in batch inschakelen, uitschakelen of verwijderen.
Het dashboard
Het tabblad Dashboard vat uw vindbaarheid samen in 7 indicatoren:
- Zichtbaarheidsindex (0 tot 100): globale score gewogen met een CTR-curve per positie. Een trefwoord op de eerste plaats weegt veel zwaarder dan een trefwoord onderaan de pagina. Dit is de trendindicator om in de tijd te volgen.
- Totaal gevolgd: aantal actieve trefwoorden.
- Top 3 en Top 10: aantal trefwoorden in de eerste drie en eerste tien plaatsen.
- Afstand tot de top: trefwoorden tussen de 4e en de 20e plaats — uw meest rendabele kansen.
- Gemiddelde positie: gemiddelde van de gerangschikte posities.
- Niet gerangschikt: trefwoorden buiten de geanalyseerde diepte.
Onder de indicatoren toont een ringdiagram de verdeling van uw posities (top 3 / top 10 / afstand tot de top / niet gerangschikt). Twee tabellen tonen uw winnaars en verliezers tussen de laatste twee metingen, en een tabel afstand tot de top isoleert de trefwoorden met veel potentieel. De knop Alle metingen starten voert een directe meting uit van alle verschuldigde trefwoorden (via AJAX, zonder de pagina te verlaten).
Concurrenten en SERP-features
Bij elke meting detecteert de module de SERP-features: featured snippet (met identificatie van de eigenaar — u of een concurrent), People Also Ask en local pack.
Het tabblad Concurrenten aggregeert de domeinen die op uw zoekopdrachten verschijnen op basis van de laatste meting van elk trefwoord, telt hun aantal verschijningen en berekent hun gemiddelde positie. De 30 meest aanwezige domeinen worden getoond, om in één oogopslag te zien wie u over uw hele bereik op de hielen zit.
Automatische metingen (cron)
Roep voor het automatiseren van de metingen de cron-URL aan vanuit de taakplanner van uw hoster (cron van o2switch, OVH, enzovoort). De URL, beveiligd met een token, wordt alleen-lezen in de configuratie getoond.
Bij elke run verwerkt de cron een batch verschuldigde trefwoorden (volgens de geconfigureerde batchgrootte), spreidt hij de aanroepen om uw provider te respecteren, en past hij vervolgens uw bewaartermijn toe door oude metingen op te schonen. Twee optionele parameters worden op de URL geaccepteerd: limit (aantal te verwerken trefwoorden) en id_shop (doelwinkel in multistore).
Het crontoken beschermt het endpoint tegen ongeautoriseerde aanroepen. Verspreid het niet publiekelijk. Elk verzoek zonder het juiste token wordt geweigerd.
Meldingen
Wanneer de meldingen zijn ingeschakeld, verstuurt SERP Tracker een e-mail (HTML- en tekstsjablonen, in het Frans en Engels) wanneer een trefwoord een significante verandering doormaakt:
- binnenkomen in of vallen uit de top 3;
- vallen uit de top 10;
- verlies van rangschikking (het trefwoord verschijnt niet meer);
- daling groter dan de geconfigureerde drempel;
- winst van een featured snippet.
De e-mail vermeldt het betrokken trefwoord, de oude en de nieuwe positie, de reden(en) van de melding en de gerangschikte URL.
FAQ en probleemoplossing
Het dashboard toont “geen provider geconfigureerd”
Controleer of u een provider hebt geselecteerd in het keuzemenu Provider en de bijbehorende sleutel hebt ingevuld (of de login/het wachtwoord voor DataForSEO). De banner verdwijnt zodra een geldige provider wordt gedetecteerd.
Mijn trefwoorden worden niet automatisch bijgewerkt
De module meet de posities alleen wanneer de cron-URL wordt aangeroepen. Configureer een geplande taak bij uw hoster om deze URL met de gewenste frequentie aan te roepen (bijvoorbeeld eenmaal per dag). In afwachting daarvan maken de knop Alle metingen starten en de actie Nu controleren handmatige metingen mogelijk.
Een positie toont 0
Positie 0 betekent dat uw domein niet is gevonden binnen de geanalyseerde resultaatdiepte. Verhoog eventueel de diepte in de configuratie, of controleer de doel-URL en de context (land, apparaat) van het trefwoord.
Waarom niet direct Google scrapen?
Direct scrapen is fragiel, wordt snel geblokkeerd en is in strijd met de gebruiksvoorwaarden van Google. Via een officiële SERP-API blijven de metingen betrouwbaar en conform. U houdt de kosten in de hand via uw eigen provideraccount.
Hoe wordt de zichtbaarheidsindex berekend?
Elke positie wordt omgezet in een geschatte CTR via een curve per positie, waarna het geheel wordt herleid tot een score van 0 tot 100. Het is een trendindicator: hij stijgt wanneer uw trefwoorden globaal naar de top van de resultaten klimmen.
Is de module compatibel met PrestaShop 9 en multistore?
Ja. De module is compatibel met PrestaShop 8 en 9, en de tracking is per winkel geïsoleerd in multistore. De controllers steunen op ModuleAdminController om compatibel te blijven tussen PS8 en PS9.