> 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/how-it-works.md).

# Funktionsweise des Banners

## So funktioniert die Lizenz

Anders als andere Lösungen, die Einwilligungsbanner pro Domain verkaufen, beruht die Dastra-Lizenz auf zwei Kriterien:

* **Maximaler monatlicher Traffic**: die Gesamtzahl der Nutzersitzungen (oder Besuche) auf Ihren Websites innerhalb eines Monats.
* **Die Anzahl der Banner**: Sie konfigurieren ein Banner mit einer Reihe von Cookies und Diensten, das Sie auf mehreren Websites oder Subdomains wiederverwenden können. Das Einwilligungs-Cookie kann über mehrere Subdomains hinweg funktionieren (zum Beispiel `*.example.com`).

Die Anzahl der **Domains und Subdomains ist daher pro Banner unbegrenzt**.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-e10ee5ecdfcf6cb0c3b686f93832162d86d5b68f%2Fcookies-widget-multi-site-architecture.png?alt=media" alt="Ein Dastra-Banner, das auf mehreren Websites verwendet wird, mit dem Dienstpool jeder Website"><figcaption><p>Ein Banner kann mehrere Websites und Subdomains bedienen</p></figcaption></figure>

## Gesamtablauf

Das Einwilligungsbanner funktioniert in drei Hauptschritten:

1. Die **Anzeige** des Einwilligungsfensters.
2. Die **Erfassung** der Einwilligung (Speicherung des Nachweises).
3. Die tatsächliche **Umsetzung** der Einwilligung des Nutzers.

{% hint style="info" %}
Das Dastra-Banner deckt die ersten beiden Schritte weitgehend automatisch ab. Für den dritten Schritt, der die Cookie-Präferenzen des Nutzers anwendet, müssen Sie das Einwilligungssystem technisch mit den Drittanbieter-Diensten verbinden, die Cookies setzen können. Siehe den [Leitfaden zur Cookie-Blockierung](https://doc.dastra.eu/de/features/cookies/integration/blocking.md).
{% endhint %}

Das JavaScript-SDK des Banners muss auf allen Seiten der Website eingebunden werden, die Cookies verwenden.

![Überblick über die Funktionsweise des Cookie-Einwilligungsbanners](https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-d6b9b7d292fd5f204ec91a27cca9ab39e21a4f47%2Fcookie-consent.png?alt=media)

### 1. Besuch der Website des Kunden

Der Besucher öffnet die Website, auf der das JavaScript-Code-Snippet installiert ist. Um die Leistung und die Suchmaschinenoptimierung Ihrer Seiten nicht zu beeinträchtigen, wird das SDK asynchron geladen und einen Tag lang zwischengespeichert.

### 2. und 3. Die Banner-Konfiguration abrufen und zwischenspeichern

Damit das Banner funktioniert, benötigt es eine aktuelle Konfiguration von den Dastra-Servern. Um die neueste Version zu erhalten, sendet es eine GET-Anfrage mit dem öffentlichen API-Schlüssel, der prüft, ob das Banner zum Kunden gehört.

{% hint style="info" %}
Ist die Domain der Website im Banner nicht festgelegt, wird die Anfrage abgelehnt und das Banner erscheint nicht. Öffnen Sie zur Behebung das Banner unter **Cookie-Banner** > **Banner** und fügen Sie dann im Abschnitt **Konfiguration** im Feld **Zulässige URLs (CORS)** die Adresse der Website hinzu.
{% endhint %}

### 4. Die Einwilligung des Nutzers einholen

Fehlt das Cookie `consent-eu` (Sie können den Namen des Cookies ändern), erscheint das Einwilligungsfenster. Um zu testen, ob das Banner korrekt angezeigt wird, löschen Sie dieses Cookie aus Ihrem Browser.

### 5. Die Einwilligung erfassen

Einwilligungen werden von der Dastra-API automatisch mit einer POST-Anfrage im JSON-Format erfasst.

In der Oberfläche des Banners wird die Einwilligung pro Zweck ausgedrückt, aber pro Dienst gespeichert.

So sieht ein Einwilligungsnachweis aus, wie er in unseren Datenbanken gespeichert ist. Interne technische Felder werden nicht angezeigt.

```json
{
    "id": "6185fe65-0924-410d-9132-3cde838c4627",
    "sessionId": "0b93b823-ff36-4d61-8959-e9e8deee5ef8",
    "date": "2026-10-12T16:54:03.272Z",
    "dateExpiration": "2027-04-10T16:54:03.272Z",
    "type": 2,
    "widgetId": 43,
    "typeDevice": 2,
    "workSpaceId": 19,
    "consentId": "8a5e89c4-2243-4598-97c5-ba3cfb35a138",
    "countryCode": "FR",
    "referrer": "https://www.example.com/pricing",
    "consents": {
        "lang": "fr-FR",
        "versionKey": "6f65cb1d-85eb-4a64-976d-519679189f8d",
        "cookieConsents": [
            {
                "id": "584ffef3-251c-4e9a-efb8-08d7fbfbee92",
                "tenantId": 0,
                "name": "Drift",
                "slug": "drift",
                "consent": true,
                "version": "6f65cb1d-85eb-4a64-976d-519679189f8d",
                "date": "2026-10-12T16:53:59.511Z",
                "purpose": 3
            }, {
                "id": "1c3baa61-0d05-44e4-da3d-08d7eeadee05",
                "tenantId": 0,
                "name": "Google Analytics",
                "slug": "google-analytics",
                "consent": true,
                "version": "6f65cb1d-85eb-4a64-976d-519679189f8d",
                "date": "2026-10-12T16:54:00.568Z",
                "purpose": 2
            }
        ]
    }
}
```

Als Antwort gibt die API eine `consentId` zurück, die zusammen mit den Entscheidungen des Besuchers im Einwilligungsspeicher abgelegt wird: standardmäßig im Cookie `consent-eu`, oder in `localStorage`, wenn Sie diesen Modus gewählt haben. Ihre Lebensdauer entspricht der Einstellung **Lebensdauer des Einwilligungs-Cookies (standardmäßig 180 Tage)** (standardmäßig 180 Tage, von 1 bis 365 Tagen). Diese Kennung ist die eindeutige Kennung des Einwilligungsnachweises. Im Streitfall ist sie diejenige, nach der Sie im Browser des Kunden suchen.

### 6. Die Einwilligung umsetzen

Sobald die Einwilligung erfasst ist, müssen Sie die Entscheidung des Nutzers anwenden, indem Sie die Einwilligungsinformationen an alle Dienste der Website weitergeben.

Für diese Phase siehe den Leitfaden zur Cookie-Blockierung:

{% content-ref url="/pages/1pfCrFS5WbM0hGRNVcf9" %}
[Cookie-Blockierung](https://doc.dastra.eu/de/features/cookies/integration/blocking.md)
{% endcontent-ref %}

{% hint style="info" %}
Mit Ausnahme der unbedingt notwendigen Cookies müssen alle Tracking-Dienste von Drittanbietern standardmäßig blockiert werden.
{% endhint %}

Sie können nun mit der technischen Integration des Banners beginnen:

{% content-ref url="/pages/nMlVabjFAZ8WT0BqPZRJ" %}
[Schnellstart](https://doc.dastra.eu/de/features/cookies/integration/quickstart.md)
{% endcontent-ref %}


---

# 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/how-it-works.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.
