> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/nl/features/cookies/integration/blocking.md).

# Cookies blokkeren

Deze handleiding legt uit hoe u cookies daadwerkelijk blokkeert.

Om cookies effectief te blokkeren zijn er verschillende methoden: cookies verwijderen, een codefragment blokkeren, aangepast JavaScript of Google Tag Manager.

## Cookies verwijderen

Deze methode is het snelst in te stellen, maar ook het minst betrouwbaar. Voert u in de sectie **Diensten** van de banner de namen in van de cookies die bij elke dienst horen (tabblad **Bijbehorende cookies** van de dienst), dan verwijdert de SDK deze cookies automatisch zodra een weigering voor de dienst wordt vastgelegd.

<figure><img src="https://996651476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i0NSpf8ID0PXTpIyycA%2Fuploads%2Fgit-blob-15bab1623478cb092d9135de0eca5c2232f40678%2Fcookies-blocking-1.png?alt=media" alt="Het tabblad Bijbehorende cookies van een dienst met de lijst van de cookies"><figcaption><p>De cookies die aan een dienst zijn gekoppeld</p></figcaption></figure>

Deze methode werkt in sommige gevallen, maar kan de betrouwbaarheid van hulpmiddelen van derden verstoren, vooral van webanalysehulpmiddelen. Gebruik haar naast een van de onderstaande methoden.

## Een codefragment in de pagina blokkeren

Met deze methode schakelt u een trackingcodefragment volledig uit.

Vervang in de HTML-code van uw pagina het volgende fragment:

```html
<script>
  alert("hello, I'm a tracking javascript tag");
</script>
```

Door:

```html
<script data-consent="{your-service-slug}" type="dastra/script">
  alert("hello, I'm a tracking javascript tag");
</script>
```

Vervang `{your-service-slug}` door de identificatie van de dienst, die u vindt in het veld **Naam van de variabele (belangrijk voor integratie van toestemming)** van het dienstformulier:

<figure><img src="https://996651476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i0NSpf8ID0PXTpIyycA%2Fuploads%2Fgit-blob-5adb83ba27507ebb59ce2a9b659f69e3145757cb%2Fcookies-blocking-2.png?alt=media" alt="Het veld Naam van de variabele van een dienstformulier"><figcaption><p>De identificatie van de dienst</p></figcaption></figure>

Heeft de bezoeker de dienst geaccepteerd, dan wordt de inhoud van het script automatisch uitgevoerd.

Om een extern script te laden voegt u het attribuut `src` toe: de browser downloadt het pas na toestemming.

```html
<script data-consent="{your-service-slug}" type="dastra/script" src="https://example.com/tracker.js"></script>
```

{% hint style="info" %}
Deze methode heeft neveneffecten: de syntaxiskleuring van de meeste code-editors herkent het type `dastra/script` niet. Het script wordt nooit uitgevoerd als de Dastra-banner niet laadt.
{% endhint %}

### De door de toepassing gegenereerde codefragmenten gebruiken

Voor elke dienst genereert de sectie **Integratie van toestemming** van de banner kant-en-klare codefragmenten en een checklist. Er zijn drie tabbladen: **Html integration** (het fragment hierboven), **Custom javascript** (het blokkeren in pure JavaScript, hieronder) en **Google tag manager** (de gebeurtenissen die u in Google Tag Manager koppelt).

## Blokkeren in pure JavaScript

In JavaScript kunt u luisteren naar de gebeurtenissen die op `window` worden afgevuurd om toestemming te verzamelen en specifiek gedrag af te handelen, afhankelijk van of cookies worden geaccepteerd of geweigerd. Deze methode geeft u meer flexibiliteit:

```html
<script>
  (function () {

    /*
     * Trigger a custom service tag with the expected cookies
     */
    function customTagsTrigger() {
      /* If the vendor provides a specific function to make the service work without cookies, call it here.
       * Otherwise, copy the default code snippet provided by the vendor. */
    }

    /*
     * Handle the global scope consent event.
     * If the user consented to the vendor's cookies, this event is fired on each page load
     * where the cookie consent banner is installed.
     */
    window.addEventListener('dastra:consent:{your-service-slug}', function () {
      /* The visitor opted in to the vendor's cookies */
      customTagsTrigger();
    });

    /*
     * Handle the global scope refused event (optional)
     */
    window.addEventListener('dastra:refused:{your-service-slug}', function () {
      /* The vendor's cookies are refused */
    });

  })();
</script>
```

## Google Tag Manager

Zie de volgende pagina:

{% content-ref url="/pages/yLeIeF9Q8a1JxvZna7oF" %}
[Google Tag Manager](/nl/features/cookies/integration/blocking/google-tag-manager.md)
{% endcontent-ref %}

## Herinnering: de levenscyclus van toestemming

<figure><img src="https://996651476-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1i0NSpf8ID0PXTpIyycA%2Fuploads%2Fgit-blob-e6d1ddf819e463c60044733ee6decc6928e04b01%2Fcookies-lifecycle.drawio.png?alt=media" alt="Diagram van de levenscyclus van toestemming, van het laden van de pagina tot het opslaan van de cookie consent-eu"><figcaption><p>Levenscyclus van toestemming</p></figcaption></figure>

## JavaScript-gebeurtenissen

De banner vuurt verschillende gebeurtenissen af op het element `window` van de pagina. De toestemmingsgebeurtenissen worden bij elke paginalading afgevuurd, wanneer de banner de reeds opgeslagen keuzes toepast, en daarna telkens wanneer een keuze wordt opgeslagen.

| Naam van de gebeurtenis         | Opmerkingen                                                                                                                                                                                                                                          |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `dastra:consent:<service slug>` | Wordt afgevuurd wanneer de dienst wordt geaccepteerd, door de bezoeker of standaard (strikt noodzakelijke diensten worden niet geraakt). Staat de dienst op "standaard toegestaan", dan wordt de gebeurtenis afgevuurd vanaf de eerste paginalading. |
| `dastra:refused:<service slug>` | Wordt afgevuurd wanneer de dienst niet wordt geaccepteerd: standaard als er geen toestemming is gegeven, of na een uitdrukkelijke weigering.                                                                                                         |
| `dastra:consents:ready`         | Wordt afgevuurd wanneer de opgeslagen toestemming (standaard de cookie `consent-eu`) is gelezen en de eerste gebeurtenissen zijn afgevuurd.                                                                                                          |
| `dastra:consents:updated`       | Wordt afgevuurd bij elke paginalading en telkens wanneer keuzes worden opgeslagen (geaccepteerd, geweigerd of aangepast). Het detail van de gebeurtenis bevat de lijst met toestemmingen.                                                            |
| `dastra:consents:any_refused`   | Wordt afgevuurd wanneer ten minste één opgeslagen toestemming een weigering is, bij elke paginalading en telkens wanneer keuzes worden opgeslagen.                                                                                                   |
| `dastra:consents:all_accepted`  | Wordt afgevuurd wanneer geen enkele opgeslagen toestemming een weigering is, bij elke paginalading en telkens wanneer keuzes worden opgeslagen.                                                                                                      |
| `dastra:consents:closed`        | Wordt afgevuurd wanneer de bezoeker de banner sluit met het sluitkruisje.                                                                                                                                                                            |
| `dastra:gpc:applied`            | Wordt afgevuurd wanneer de banner niet-essentiële cookies automatisch weigert vanwege een signaal van Global Privacy Control of Do Not Track. Zie [US Privacy: CCPA, GPC en DoNotTrack](/nl/features/cookies/banner/us-privacy.md).                  |

{% hint style="info" %}
Omdat de gebeurtenissen `dastra:consent:*` en `dastra:consents:*` ook bij het laden van de pagina worden afgevuurd, registreert u uw listeners voor het herladen binnen `dastra:consents:ready`. Zie [Google Tag Manager](/nl/features/cookies/integration/blocking/google-tag-manager.md).
{% endhint %}

Om op elke toestemmingsupdate te reageren, kunt u ook `dastra.addConsentDastraListener(callback)` gebruiken: de functie wordt bij elke gebeurtenis `dastra:consents:updated` aangeroepen.

## Veelgestelde vragen

### Kan ik een script blokkeren per categorie in plaats van per dienst? (bijvoorbeeld `data-consent="analytics"`)

Nee. Het attribuut `data-consent` verwacht een **service slug**, geen categorie-slug. Met `<script data-consent="analytics" type="dastra/script">` alle diensten van een categorie in één instructie blokkeren, wordt niet ondersteund.

De reden: een gebruiker kan sommige diensten binnen een categorie accepteren en andere in dezelfde categorie weigeren. De banner beheert toestemming op het niveau van de dienst, niet van de categorie.

Om een script te laden afhankelijk van de vraag of een hele categorie is geaccepteerd, gebruikt u de programmatische API:

```javascript
window.addEventListener('dastra:consents:updated', function () {
  if (window.dastra.cookieConsent.consent.getPurposeConsent('Analytical')) {
    // load your analytics scripts here
  }
});
```

{% hint style="warning" %}
`getPurposeConsent` geeft alleen `true` terug als **alle** diensten van de categorie zijn geaccepteerd. Heeft de banner geen enkele dienst in die categorie, dan gooit de aanroep een fout: vang die af, bijvoorbeeld met een `try ... catch`.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.dastra.eu/nl/features/cookies/integration/blocking.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.