Installatiegids

Alles wat je nodig hebt om een website met AdRecover te verbinden.

1. Voeg het fragment toe

Kopieer na het toevoegen van je website in het dashboard je persoonlijke fragment. Het ziet er zo uit:

<script async src="https://adrecover.onrender.com/embed.js" data-publisher="pub_XXXXXXXXXXXXXXXX"></script>

Gebruik het fragment uit je dashboard: het bevat je eigen uitgevers-ID. Hetzelfde fragment werkt op alle websites in je account.

2. Waar plaats je het

Plak het fragment vlak voor de afsluitende </body>-tag van elke pagina, of één keer in het gedeelde sjabloon, de lay-out of de footer die elke pagina gebruikt.

Het script is asynchroon en blokkeert de weergave niet. Plaatsen in de <head> werkt ook.

WordPress en andere CMS'en

  • WordPress: gebruik een plug-in voor header/footer-code of voeg het fragment toe aan footer.php van je thema, vóór </body>.
  • Shopify: Webwinkel → Thema's → Code bewerken → theme.liquid, vóór </body>.
  • Wix, Squarespace en vergelijkbaar: gebruik de instelling voor aangepaste code of code-injectie in de footer.
  • Google Tag Manager: maak een aangepaste HTML-tag met het fragment die op alle pagina's wordt geactiveerd.

3. Controleer de verbinding

Open een willekeurige pagina van je website in een gewoon browservenster. Klik daarna op Verbinding controleren in het installatievenster. De status verandert in Verbonden zodra de eerste paginaweergave AdRecover bereikt.

Een melding publiceren en het script verbinden zijn twee verschillende dingen: een gepubliceerde melding wordt pas getoond als het script is geïnstalleerd.

Herstelmodi

  • AdBlock Wall: een niet-sluitbaar dialoogvenster zolang blokkering bevestigd is. Bezoekers kunnen instructies openen en opnieuw controleren.
  • Vriendelijke herinnering: een sluitbare melding met frequentie-instellingen.
  • Alleen meten: meten zonder zichtbare melding. Er verschijnt niets tot je een melding publiceert.

Targetingregels

Nieuwe meldingen slaan standaard de homepage over. Bezoek een interne pagina (bijvoorbeeld een artikel) met je adblocker aan om een net gepubliceerde wall te testen.

Je kunt paden als /login of /checkout uitsluiten. Een regel geldt voor het pad zelf en alles daaronder. Eindig een regel met * om elk pad te treffen dat daarmee begint.

Single-page-applicaties

Het script herkent navigatie aan de clientkant via de History API en behandelt elk nieuw pad als een nieuwe paginaweergave. Je hoeft zelf niets aan te roepen.

Content Security Policy

Gebruikt je site een Content Security Policy, sta dan de AdRecover-host toe voor scripts en verbindingen. De detectie doet ook een testverzoek naar een gangbare advertentieserver; blokkeert je CSP dat, dan kan de detectie vaker onbeslist uitvallen.

Testen met een adblocker

  • Installeer het script en publiceer de AdBlock Wall.
  • Zet een adblocker aan (bijvoorbeeld uBlock Origin of AdBlock) en open een interne pagina.
  • De wall verschijnt. Klik op Opnieuw controleren zonder iets te wijzigen: de wall blijft.
  • Pauzeer je blocker voor de site en klik op Opnieuw controleren: de wall sluit.
  • Zet de blocker weer aan en laad een andere pagina: de wall verschijnt opnieuw.

Problemen oplossen

  • De status blijft Wachten op installatie: controleer of het fragment op de live site staat en of het geregistreerde domein overeenkomt met het adres in de browser (met en zonder www gelden als dezelfde site; andere subdomeinen hebben een eigen vermelding nodig).
  • Er verschijnt geen melding: controleer of de melding gepubliceerd is, of de pagina niet is uitgesloten en of je niet op de homepage bent terwijl Homepage overslaan aan staat.
  • Het dashboard waarschuwt voor een niet-geregistreerd domein: je fragment is geladen op een domein dat niet in je account staat. Voeg het domein toe als het van jou is.

Privacy en opslag

Het script plaatst geen cookies. Het gebruikt sessieopslag om pagina's binnen een bezoek te tellen en, voor de Vriendelijke herinnering met Eén keer tonen, lokale opslag om te onthouden dat de herinnering is getoond. AdRecover slaat geen IP-adressen van bezoekers op; detectiegebeurtenissen worden beperkt bewaard, daarna blijven alleen dagtotalen over.

Content-Security-Policy: script-src 'self' https://adrecover.onrender.com https://pagead2.googlesyndication.com; connect-src 'self' https://adrecover.onrender.com https://pagead2.googlesyndication.com