> 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/de/features/cookies/integration/blocking.md).

# Cookie-Blockierung

Dieser Leitfaden erklärt, wie Sie Cookies wirksam blockieren.

Um Cookies wirksam zu blockieren, gibt es mehrere Methoden: das Löschen von Cookies, das Blockieren eines Snippets, eigenes JavaScript oder Google Tag Manager.

## Cookies löschen

Diese Methode ist am schnellsten einzurichten, aber auch am wenigsten zuverlässig. Wenn Sie im Abschnitt **Dienstleistungen** des Banners bei jedem Dienst die Namen der zugehörigen Cookies eintragen (Tab **Verbundene Cookies** des Dienstes), löscht das SDK diese Cookies automatisch, sobald für den Dienst eine Ablehnung erfasst wird.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-15bab1623478cb092d9135de0eca5c2232f40678%2Fcookies-blocking-1.png?alt=media" alt="Der Tab Verbundene Cookies eines Dienstes mit der Liste seiner Cookies"><figcaption><p>Die mit einem Dienst verbundenen Cookies</p></figcaption></figure>

Diese Methode funktioniert in manchen Fällen, kann aber die Zuverlässigkeit von Drittanbieter-Tools beeinträchtigen, insbesondere von Web-Analyse-Tools. Verwenden Sie sie zusätzlich zu einer der folgenden Methoden.

## Ein Code-Snippet in der Seite blockieren

Mit dieser Methode deaktivieren Sie ein Tracking-Code-Snippet vollständig.

Ersetzen Sie im HTML-Code Ihrer Seite das folgende Snippet:

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

durch:

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

Ersetzen Sie `{your-service-slug}` durch die Kennung des Dienstes. Sie finden sie im Feld **Name der Variablen (wichtig für die Einbindung der Einwilligung)** des Dienstformulars:

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-5adb83ba27507ebb59ce2a9b659f69e3145757cb%2Fcookies-blocking-2.png?alt=media" alt="Das Feld Name der Variablen eines Dienstformulars"><figcaption><p>Die Kennung des Dienstes</p></figcaption></figure>

Hat der Besucher den Dienst akzeptiert, wird der Inhalt des Skripts automatisch ausgeführt.

Um ein externes Skript zu laden, fügen Sie das Attribut `src` hinzu: Der Browser lädt es erst nach der Einwilligung herunter.

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

{% hint style="info" %}
Diese Methode hat Nebenwirkungen: Die Syntaxhervorhebung der meisten Code-Editoren erkennt den Typ `dastra/script` nicht. Das Skript wird nie ausgeführt, wenn das Dastra-Banner nicht geladen werden kann.
{% endhint %}

### Die von der Anwendung erzeugten Snippets verwenden

Für jeden Dienst erzeugt der Abschnitt **Integration der Einwilligung** des Banners fertig kopierbare Snippets und eine Checkliste. Es stehen drei Tabs zur Verfügung: **Html integration** (das Snippet oben), **Custom javascript** (die unten beschriebene Blockierung in reinem JavaScript) und **Google tag manager** (die Ereignisse, die Sie in Google Tag Manager verbinden).

## Blockierung in reinem JavaScript

In JavaScript können Sie auf die Ereignisse hören, die auf `window` ausgelöst werden, um die Einwilligung zu erfassen und je nachdem, ob Cookies akzeptiert oder abgelehnt werden, ein bestimmtes Verhalten umzusetzen. Diese Methode bietet Ihnen mehr Flexibilität:

```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

Siehe die folgende Seite:

{% content-ref url="/pages/mrmWU7Xb45xC6x5K2m4J" %}
[Google Tag Manager](https://doc.dastra.eu/de/features/cookies/integration/blocking/google-tag-manager.md)
{% endcontent-ref %}

## Erinnerung an den Lebenszyklus der Einwilligung

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-e6d1ddf819e463c60044733ee6decc6928e04b01%2Fcookies-lifecycle.drawio.png?alt=media" alt="Diagramm des Lebenszyklus der Einwilligung, vom Laden der Seite bis zum Speichern des Cookies consent-eu"><figcaption><p>Lebenszyklus der Einwilligung</p></figcaption></figure>

## JavaScript-Ereignisse

Das Banner löst mehrere Ereignisse auf dem Element `window` der Seite aus. Die Einwilligungsereignisse werden bei jedem Laden der Seite ausgelöst, wenn das Banner die bereits gespeicherten Entscheidungen anwendet, und anschließend bei jedem Speichern einer Entscheidung.

| Ereignisname                    | Hinweise                                                                                                                                                                                                                                                          |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `dastra:consent:<service slug>` | Wird ausgelöst, wenn der Dienst akzeptiert wird, durch den Besucher oder standardmäßig (unbedingt notwendige Dienste sind nicht betroffen). Ist der Dienst auf „standardmäßig akzeptiert“ eingestellt, wird das Ereignis ab dem ersten Laden der Seite ausgelöst. |
| `dastra:refused:<service slug>` | Wird ausgelöst, wenn der Dienst nicht akzeptiert wird: standardmäßig, wenn keine Einwilligung erteilt wurde, oder nach einer ausdrücklichen Ablehnung.                                                                                                            |
| `dastra:consents:ready`         | Wird ausgelöst, wenn die gespeicherte Einwilligung (standardmäßig das Cookie `consent-eu`) gelesen und die ersten Ereignisse ausgelöst wurden.                                                                                                                    |
| `dastra:consents:updated`       | Wird bei jedem Laden der Seite und bei jedem Speichern von Entscheidungen ausgelöst (akzeptiert, abgelehnt oder angepasst). Das Ereignisdetail enthält die Liste der Einwilligungen.                                                                              |
| `dastra:consents:any_refused`   | Wird ausgelöst, wenn mindestens eine gespeicherte Einwilligung eine Ablehnung ist, bei jedem Laden der Seite und bei jedem Speichern von Entscheidungen.                                                                                                          |
| `dastra:consents:all_accepted`  | Wird ausgelöst, wenn keine gespeicherte Einwilligung eine Ablehnung ist, bei jedem Laden der Seite und bei jedem Speichern von Entscheidungen.                                                                                                                    |
| `dastra:consents:closed`        | Wird ausgelöst, wenn der Besucher das Banner mit dem Schließen-Kreuz schließt.                                                                                                                                                                                    |
| `dastra:gpc:applied`            | Wird ausgelöst, wenn das Banner nicht notwendige Cookies automatisch ablehnt, weil ein Signal Global Privacy Control oder Do Not Track vorliegt. Siehe [US-Compliance](https://doc.dastra.eu/de/features/cookies/banner/us-privacy.md).                           |

{% hint style="info" %}
Da die Ereignisse `dastra:consent:*` und `dastra:consents:*` auch beim Laden der Seite ausgelöst werden, registrieren Sie Ihre Listener für das erneute Laden innerhalb von `dastra:consents:ready`. Siehe [Google Tag Manager](https://doc.dastra.eu/de/features/cookies/integration/blocking/google-tag-manager.md).
{% endhint %}

Um auf jede Aktualisierung der Einwilligung zu reagieren, können Sie auch `dastra.addConsentDastraListener(callback)` verwenden: Die Funktion wird bei jedem Ereignis `dastra:consents:updated` aufgerufen.

***

## Häufig gestellte Fragen

**Kann ich ein Skript nach Kategorie statt nach Dienst blockieren? (z. B. `data-consent="analytics"`)**

Nein. Das Attribut `data-consent` erwartet einen **Dienst-Slug**, keinen Kategorie-Slug. Die Schreibweise `<script data-consent="analytics" type="dastra/script">`, um alle Dienste einer Kategorie mit einer einzigen Anweisung zu blockieren, wird nicht unterstützt.

Der Grund: Ein Nutzer kann einige Dienste einer Kategorie akzeptieren und andere derselben Kategorie ablehnen. Das Banner verwaltet die Einwilligung auf Ebene der Dienste, nicht der Kategorien.

Um ein Skript zu laden, je nachdem, ob eine ganze Kategorie akzeptiert wurde, verwenden Sie die 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` gibt nur dann `true` zurück, wenn **alle** Dienste der Kategorie akzeptiert sind. Hat das Banner in dieser Kategorie keinen Dienst, löst der Aufruf einen Fehler aus: Sichern Sie ihn ab, zum Beispiel mit einem `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/de/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.
