Cookie Manager Tarteaucitron: volledige gids

Overzicht

Cookie Manager Tarteaucitron is een module voor cookietoestemmingsbeheer voor PrestaShop 8.0+ en 9.x. Hij combineert de opensourcemotor tarteaucitron.js, die diensten daadwerkelijk blokkeert vóór toestemming, met een moderne interface in Axeptio-stijl: geanimeerde zwevende kaart, toggles per categorie en heropeningsbubbel. De module integreert Google Consent Mode v2, een trackerscanner met automatische activering en een AVG-logboek van de toestemmingen.

Installatie

1. Ga in uw PrestaShop-backoffice naar Modules → Modulebeheer → Een module installeren.
2. Upload het bestand datafirefly_tarteaucitron.zip.
3. Klik op Installeren en daarna op Configureren.

Leeg na elke update van de module de PrestaShop-cache: Geavanceerde instellingen → Prestaties → Cache legen.

Algemene configuratie

Het tabblad Algemeen bevat de basisinstellingen:

• Module inschakelen: hoofdschakelaar van de banner in de frontoffice.
• Cookienaam: naam van het toestemmingscookie (standaard tarteaucitron). Wijzig deze alleen als een andere tool conflicteert.
• Levensduur van het cookie: standaard 365 dagen. De CNIL beveelt maximaal 13 maanden aan (395 dagen).
• Heropeningsbubbel: toont na de toestemming een kleine bubbel “Cookies”, waarmee de bezoeker zijn keuzes op elk moment kan wijzigen, een AVG-vereiste.
• Link naar het privacybeleid: URL van uw CMS-pagina, getoond onder de knoppen van de banner.

Het tabblad Teksten laat u de titel, het bericht en de labels van de drie knoppen aanpassen. Het tabblad Design regelt de hoofdkleur en de achtergrond- en tekstkleuren van de knoppen.

Diensten activeren

Het tabblad Diensten toont de 11 kant-en-klare integraties. Activeer voor elke dienst de schakelaar en vul de gevraagde identifier in:

• Google Analytics 4: Measurement ID in het formaat G-XXXXXXXX
• Google Tag Manager: Container ID in het formaat GTM-XXXXXX
• Google Ads: Conversion ID
• Meta Pixel: numeriek Pixel ID
• Hotjar: numeriek Site ID
• LinkedIn Insight: Partner ID
• TikTok Pixel: Pixel ID
• Microsoft Clarity: Project ID
• Intercom: App ID
• YouTube: geen identifier nodig, activeert het blokkeren van ingesloten video’s vóór toestemming
• Stripe: geen identifier nodig, zie de aparte sectie hieronder

Scanner en automatische detectie

Het tabblad Automatische detectie configureert de module voor u:

1. Klik op Site nu scannen. De module leest de cookies op uw domein en haalt de HTML van uw frontoffice op om de scripttags van derden te analyseren.
2. Er verschijnen twee tabellen: de gedetecteerde cookies (met waarschijnlijke dienst en voorgestelde categorie, aanpasbaar) en de geïdentificeerde scripts van derden (met hun status in de module).
3. De groene balk toont het aantal herkende diensten. Klik op Toepassen op de module en opslaan: de bijbehorende diensten worden geactiveerd en de configuratie wordt onmiddellijk opgeslagen.
4. Ga daarna naar het tabblad Diensten om de identifiers van de nieuw geactiveerde diensten in te vullen.

De scanner herkent onder meer: Google Analytics, Google Ads, Meta Pixel, Hotjar, LinkedIn, TikTok, Microsoft Clarity, Intercom, Brevo, Stripe, en de functionele PrestaShop-cookies.

Google Consent Mode v2

Verplicht sinds maart 2024 voor Europese adverteerders, laat Consent Mode v2 Google conversies modelleren, zelfs bij weigering. Het tabblad Consent Mode van de module:

• verstuurt de 7 vereiste signalen (ad_storage, ad_user_data, ad_personalization, analytics_storage, functionality_storage, personalization_storage, security_storage) als default vóór elke tag;
• laat u elke standaardstatus afzonderlijk instellen, denied wordt aanbevolen voor de EER;
• werkt de signalen automatisch bij volgens de keuzes van de bezoeker.

Bijzonderheid van de module: bij het laden van elke pagina leest de standaardstatus het bestaande toestemmingscookie. Een bezoeker die al heeft geaccepteerd, krijgt granted vanaf het eerste frame, geen tijdelijke denied-fase die uw Google Ads-conversies bij het herladen zou aantasten.

Stripe en de essentiële cookies

De Stripe-cookies (__stripe_mid, __stripe_sid) zijn strikt noodzakelijk voor de preventie van betaalfraude. Ze vallen onder de toestemmingsvrijstelling voor essentiële trackers: ze blokkeren zou het bestelproces breken.

De module behandelt ze dienovereenkomstig: wanneer de Stripe-dienst is geactiveerd, laadt hij zonder toestemmingsvraag en verschijnt hij in het voorkeurenpaneel onder de categorie Essentieel en betaling met de badge “Altijd actief”. Volledige transparantie voor de bezoeker, geen enkele geblokkeerde betaling.

Aangepaste diensten

Het tabblad Aangepaste diensten laat u elk script van derden toevoegen dat niet in de lijst staat:

• Sleutel: unieke technische identifier in kleine letters (bv. mijnchat)
• Naam: label dat in de banner wordt getoond
• Categorie: analytic, ads, social, support, api of other
• JavaScript-code: de laadcode van de dienst, alleen uitgevoerd na toestemming
• Cookies: lijst met namen van geplaatste cookies, gescheiden door komma’s
• Beleids-URL: link naar het privacybeleid van de dienst

De aangepaste diensten verschijnen in de banner onder een eigen categorie met hun eigen toggle.

AVG-logboek van de toestemmingen

Artikel 7 van de AVG vereist dat u kunt aantonen dat toestemming is gegeven. Het tabblad AVG-logboek toont de laatste 50 registraties met, per actie:

• de datum en het tijdstip;
• de anonieme bezoekers-identifier (eigen technisch cookie, geen persoonsgegevens);
• de geaccepteerde categorieën;
• het detail van de keuzes per dienst.

Belangrijke punten van de werking:

• Het IP-adres wordt nooit in klare tekst opgeslagen: het wordt gehasht met SHA-256 en een serversalt, conform de aanbevelingen van de CNIL.
• Een serverdeduplicatie negeert identieke registraties van dezelfde bezoeker binnen 5 seconden (dubbelklik).
• Een automatische opschoning verwijdert bij elk bezoek aan de configuratiepagina de vermeldingen ouder dan 3 jaar.
• Het logboek wordt bewaard bij de-installatie van de module, om uw auditspoor te behouden.

Probleemoplossing

• De banner wordt niet weergegeven: controleer of de module is ingeschakeld in het tabblad Algemeen en leeg daarna de PrestaShop-cache. Controleer ook of er geen andere toestemmingsmodule tegelijk actief is.
• De keuzes worden niet onthouden: gebruik versie 1.1.0 of hoger, die het cookie in het native tarteaucitron-formaat schrijft. Leeg de browsercache en verwijder het oude toestemmingscookie voordat u opnieuw test.
• Een dienst laadt niet na acceptatie: controleer of de identifier is ingevuld in het tabblad Diensten. Open de browserconsole om eventuele fouten op te sporen.
• De scan detecteert niets: blader eerst door de frontoffice in dezelfde browser en start de scan opnieuw. Staan de admin en de front op verschillende domeinen, dan werkt alleen de scriptanalyse.
• Geen enkele registratie in het logboek: bezoek de configuratiepagina van de module (de tabel wordt automatisch aangemaakt als ze ontbreekt) en geef daarna een nieuwe toestemming vanuit de front in privénavigatie.