Installatiegids
Alles wat je nodig hebt om een website met AdCobalt 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://adcobalt.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 AdCobalt 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
Meldingen verschijnen standaard op elke pagina, ook op de homepage. Open je website 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.
Tonen vanaf pagina N en Wachten tellen over het hele bezoek: alle pagina's en tabbladen van je site, vanaf het moment dat de bezoeker binnenkomt. Een bezoek eindigt na 30 minuten zonder paginaweergave; test opnieuw in een privévenster.
Advertentievrije lidmaatschappen
Bezoekers die hun adblocker aan houden, kunnen je betalen voor een advertentievrij lidmaatschap in plaats van advertenties toe te staan. Het is optioneel en staat standaard uit.
- Koppel Stripe op de pagina Leden. Leden betalen op je eigen Stripe-account; jij bent de verkoper, dus Stripe stuurt bonnen op jouw naam en jij regelt daar terugbetalingen, geschillen en belastingen. AdCobalt houdt 8% van elke betaling (de verwerkingskosten van Stripe gelden zoals gewoonlijk).
- Zet het aanbod aan in de Recovery Builder (tabblad Leden), kies een maandprijs en eventueel een jaarprijs en publiceer. De knop “Advertentievrij” verschijnt pas als Stripe betalingen kan ontvangen.
- Zet een link naar #adcobalt-membership in je footer of menu, bijvoorbeeld <a href="#adcobalt-membership">Lidmaatschap</a>. Leden gebruiken die om te beheren of op te zeggen; andere bezoekers kunnen lid worden of inloggen.
- Leden zien de melding nooit. Wil je voor hen ook geen advertenties laden, zet je advertentiecode dan om: (window.adcobaltQueue = window.adcobaltQueue || []).push(function (ar) { if (!ar.isMember) { /* advertenties laden */ } }); Het script stuurt ook een event adcobalt:ready.
- Leden kunnen altijd in twee klikken opzeggen via de link in hun welkomstmail, via jouw Lidmaatschap-link of op de beheerpagina. Ze houden toegang tot het einde van de betaalde periode.
Het lidmaatschap wordt onthouden in de lokale opslag van de browser op je site. Op een ander apparaat loggen leden in met hun e-mailadres.
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 AdCobalt-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 je website.
- 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, als je Homepage overslaan aanzette, of je niet op de homepage bent.
- Andere domeinen die je code gebruiken (pagina Websites): je fragment draaide op een domein dat niet in je account staat. Daar wordt niets getoond of gemeten. Voeg het toe als het van jou is, of negeer het.
Privacy en opslag
Het script plaatst geen cookies. Het gebruikt lokale opslag op je site om pagina's binnen een bezoek te tellen (een bezoek eindigt na 30 minuten zonder paginaweergave), om te onthouden wanneer een Vriendelijke herinnering voor het laatst is getoond, dat de browser een melding zag terwijl advertenties werden geblokkeerd (tot 7 dagen) en dat hij daarna advertenties toestond (tot 180 dagen na het laatste bezoek), en, alleen voor advertentievrije leden, een ondertekend lidmaatschapstoken. Behalve dat token bevatten deze gegevens alleen tijdstempels en tellers. AdCobalt slaat geen IP-adressen van bezoekers op; detectiegebeurtenissen worden beperkt bewaard, daarna blijven alleen dagtotalen over.
Content-Security-Policy: script-src 'self' https://adcobalt.com https://pagead2.googlesyndication.com; connect-src 'self' https://adcobalt.com https://pagead2.googlesyndication.com