> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/datenschutz.md).

# Datenschutz

Welche Daten das Plugin verarbeitet, welche Cookies und Browser-Speicher es nutzt und worauf Sie in Ihrer Datenschutzerklärung achten sollten.

Diese Seite beschreibt sachlich, was das Plugin im Browser Ihrer Besucher speichert und welche Daten es an unser Suchsystem überträgt. Sie hilft Ihnen, Ihre Datenschutzerklärung und Ihr Cookie-Banner passend zu gestalten.

{% hint style="warning" %}
Das ist keine Rechtsberatung. Bitte lassen Sie Ihre Datenschutzerklärung rechtlich prüfen. Ob und welche Vereinbarung zur Auftragsverarbeitung für Ihren Shop nötig ist, klären Sie bitte mit Ihrer Rechtsberatung.
{% endhint %}

## Überblick

| Thema                     | Kurz gesagt                                                                                                         |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Cookie                    | Ein Cookie zur Wiedererkennung, nur nach Zustimmung im Cookie-Banner                                                |
| Ohne Zustimmung           | Kein Cookie. Die Suche funktioniert, Ereignisse einer Sitzung werden über eine abgeleitete Kennung zusammengehalten |
| Ereignisse                | Klicks in der Suche, Einblendungen, Warenkorb, Bestellung, Zahlstatus                                               |
| Nicht übertragen          | Name, E-Mail-Adresse, Anschrift, Telefon, Zahlungsdaten, Bestellkommentare, IP-Adresse im Klartext, Passwörter      |
| Bots                      | Werden bei Browser- und Warenkorb-Ereignissen ausgeschlossen                                                        |
| Shopping-Assistent (Beta) | Eingaben werden maskiert, nach 30 Tagen gelöscht, Auswertung in Rechenzentren in Deutschland                        |

## Cookie und Einwilligung

### Das Cookie im Überblick

| Eigenschaft   | Wert                                                                                                    |
| ------------- | ------------------------------------------------------------------------------------------------------- |
| Name          | `cogi_recommendation_session`                                                                           |
| Inhalt        | Eine zufällige Kennung (UUID), keine Angaben zur Person                                                 |
| Laufzeit      | 365 Tage                                                                                                |
| Pfad          | `/`                                                                                                     |
| Einstellungen | `SameSite=Lax`, bei HTTPS zusätzlich `Secure`. Es wird per JavaScript gesetzt und ist nicht `HttpOnly`. |
| Zweck         | Wiedererkennung desselben Besuchers für Suche, Statistik und Personalisierung                           |

Das Cookie teilt sich das Plugin mit „InsightSearch Recommendations“. Eine Einwilligung gilt für beide Plugins.

### Eintrag im Cookie-Banner

Das Plugin trägt sich in das Cookie-Banner von Shopware ein:

* **Gruppe:** „Komfortfunktionen“
* **Name:** „Wiedererkennung für Suche und Empfehlungen“
* **Beschreibung:** „Merkt sich, welche Produkte Sie angesehen haben, damit Suchergebnisse und Empfehlungen besser zu Ihnen passen.“

Ist auch das Empfehlungs-Plugin installiert, gibt es keinen doppelten Eintrag. Der Eintrag erscheint mit dem gemeinsamen Text. Das Cookie wird nur gesetzt, wenn der Besucher zugestimmt hat. Ohne Zustimmung wird es entfernt.

Nutzen Sie ein Cookie-Banner eines Drittanbieters, muss dieses den Cookie-Mechanismus von Shopware verwenden. Sonst erscheint der Eintrag dort unter Umständen nicht. Prüfen Sie das im Zweifel mit Ihrem Anbieter.

### Verhalten ohne Einwilligung

Hat ein Besucher nicht zugestimmt, setzt das Plugin **kein Cookie**. Die Suche funktioniert trotzdem. Damit die Ereignisse einer Sitzung zusammenhängen, nutzt das Plugin zwei Hilfen:

* Eine **abgeleitete Referenz der Shopware-Sitzung**. Sie wird aus der Sitzungskennung berechnet (Kürzel `sr_` plus ein Teil einer Prüfsumme), lässt sich nicht zurückrechnen, und der Sitzungswert selbst wird nie weitergegeben.
* Eine **Zufalls-ID im Sitzungsspeicher des Browsers** (`sessionStorage`), die nur für den geöffneten Tab gilt und beim Schließen des Tabs verschwindet.

Was fehlt: Der Besucher wird über mehrere Besuche hinweg nicht wiedererkannt.

### „Cookie-Einwilligung für die Wiedererkennung ignorieren“

In der Plugin-Konfiguration, Karte „Personalisierung“, gibt es die Option „Cookie-Einwilligung für die Wiedererkennung ignorieren“.

| Einstellung                                              | Wirkung                                                                   | Standard |
| -------------------------------------------------------- | ------------------------------------------------------------------------- | -------- |
| „Cookie-Einwilligung für die Wiedererkennung ignorieren“ | Das Cookie wird immer gesetzt und genutzt, auch ohne Zustimmung im Banner | aus      |

Der Hilfetext sagt: Nur einschalten, wenn die Einwilligung anderweitig eingeholt wird. Die rechtliche Verantwortung dafür liegt bei Ihnen als Betreiber.

## Weitere Speicher im Browser

Neben dem Cookie nutzt das Plugin einige Speicher des Browsers. Das sind keine Cookies, sie können aber in einer Datenschutzerklärung erwähnenswert sein:

| Speicher         | Zweck                                                                                                                                                            |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `localStorage`   | Kurzlebiger technischer Zugangsschlüssel für die Suche. Außerdem die zuletzt in der Suche angeklickten Produkte, damit Käufe der Suche zugeordnet werden können. |
| `sessionStorage` | Hilfen für das laufende Tracking, die Wiederherstellung der Suche nach einem Seitenwechsel im selben Tab (30 Minuten) und das Ausblenden des Verlaufs            |

## Besuch, Besucher und Sitzung

* Jeder Besuch bekommt eine eigene Besuchskennung (UUID). Sie liegt in der Shopware-Sitzung und bleibt über den Login hinweg erhalten.
* Nach **30 Minuten ohne Aktivität** beginnt ein neuer Besuch mit einer neuen Kennung.
* Suche, Klicks, Warenkorb und Bestellung nutzen dieselbe Besuchs- und Besucherkennung. So kann die Statistik einen Kauf der Suche zuordnen.

## Welche Ereignisse das Plugin sendet

**Aus dem Browser des Besuchers:**

* Klick auf ein Suchergebnis, Klick auf die Schnellansicht
* Anzeige des Such-Layouts (beim Öffnen der Suche) und Einblendung von Suchergebnissen, auch auf der Suchergebnisseite
* Klick auf „In den Warenkorb“ und auf den Merkzettel im Suchergebnis
* Seitenereignisse (Aufruf von Landingpage, Kategorie, Produktseite, Kasse, Seitenaufruf)

**Aus Ihrem Shop (Server):**

* Produkt in den Warenkorb gelegt, mit der Herkunft „aus der Suche“ oder „aus dem Assistenten“, wenn bekannt
* Bestellung abgeschlossen
* Wechsel des Zahlstatus (bezahlt, storniert, Zahlartwechsel)
* Stornierung einer Bestellung

Die Suchanfragen selbst gehen an unser Suchsystem.

Mit dem Schalter „Bestellungs-Tracking aktivieren“ (Standard an) steuern Sie Warenkorb, Bestellung und Zahlstatus gemeinsam. Ist er aus, werden diese drei Ereignisse nicht gesendet.

## Welche Daten übertragen werden

| Vorgang                                      | Übertragene Daten                                                                                                                                                                                                                                          |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Verbindung (Einrichtung, stündliche Prüfung) | Instanz-ID des Shops, Shop-Adresse, Shop-Typ, Plugin-Typ, Shopware- und Plugin-Version, Zeitzone, Kaufstand der Zusatzfunktionen, Zugangsschlüssel zur Anmeldung                                                                                           |
| Produktdaten                                 | Die im Feed oder Push eingestellten Felder (Titel, Beschreibung, Preise, Marke, Kategorien, Eigenschaften, Zusatzfelder, Bild- und Produktlinks, Bestand). Zusätzlich je Produkt die Verkaufszahl und eine Margenklasse von 1 bis 5.                       |
| Suchanfragen                                 | Suchbegriff, Filter, Besucherkennung, Fläche und Herkunft, Browser-Kennung (User-Agent, auf 512 Zeichen gekürzt). Bei Abruf durch den Server zusätzlich eine IP-Prüfsumme.                                                                                 |
| Browser-Ereignisse                           | Ereignistyp, Zeitpunkt, Besucher- und Besuchskennung, bereinigte Seitenadresse, Seitentitel, Produkt-ID, Suchbegriff, Trefferposition, Verkaufskanal, Sprache, Geräteklasse, User-Agent, bei eingeloggten Kunden die Kunden-ID                             |
| Warenkorb                                    | Besucher- und Besuchskennung, Produkte mit Menge und Preis, Herkunftsangabe, Verkaufskanal, Sprache, Gerät, bei eingeloggten Kunden Kunden-ID und Kundennummer                                                                                             |
| Bestellung                                   | Bestell-ID, Gesamtbetrag, Währung, Positionen mit Menge und Preis nach anteiligem Rabatt, Bestelldatum, Zahlstatus, Transaktionsstatus, Bestellstatus, Verkaufskanal, Sprache, Besucher- und Besuchskennung, Gerät, User-Agent, Kunden-ID und Kundennummer |

Zu einzelnen Punkten:

* **Margenklasse:** Sie wird aus dem Einkaufspreis abgeleitet. Der Einkaufspreis selbst wird nicht übertragen. Die Übertragung von Verkaufszahl und Margenklasse schalten Sie mit „Abverkauf und Margenklasse übertragen“ (Karte „Datenfreigabe“, Standard an) ab. Dann entfallen die Topseller-Sortierung und das Margen-Ranking.
* **IP-Prüfsumme:** Die letzte Stelle der IP-Adresse wird anonymisiert, danach wird eine Prüfsumme berechnet und gekürzt. Die IP-Adresse im Klartext wird vom Plugin nicht übertragen. Ruft der Browser des Besuchers unser Suchsystem direkt auf, ist die IP-Adresse technisch bedingt für die Verbindung sichtbar, wie bei jedem Aufruf einer Webadresse.
* **Seitenadresse:** Von der Adresse bleiben nur die Parameter `search`, `p` und `order`. Zugangsdaten und Fragmente werden entfernt.
* **Kunden-ID und Kundennummer** sind Kennungen, die sich auf einen Kunden Ihres Shops beziehen. Sie werden nur gesendet, wenn der Kunde eingeloggt ist. Berücksichtigen Sie das in Ihrer Datenschutzerklärung.

### Was nicht übertragen wird

Das Plugin sendet nicht: Namen, E-Mail-Adressen, Anschriften, Telefonnummern, Zahlungsdaten, Bestellkommentare, IP-Adressen im Klartext und Passwörter. Zugangsschlüssel werden aus Nachrichten und Protokollen entfernt.

## Personalisierung

In der Karte „Personalisierung“ können Sie „Suchergebnisse personalisieren“ einschalten (Standard aus). Marken und Kategorien, die ein Besucher zuletzt angesehen hat, rücken dann leicht nach oben. Die Stärke wählen Sie zwischen „Niedrig“ und „Mittel“.

Personalisiert wird nur mit Einwilligung (Cookie-Banner, Gruppe „Komfortfunktionen“) oder bei eingeloggten Kunden. Bei eingeloggten Kunden geht die Kunden-ID an unser Suchsystem.

## Bots

Das Plugin wertet Bots nicht als Besucher. Browser-Ereignisse und Warenkorb-Ereignisse werden verworfen, wenn die Browser-Kennung zu einem Bot gehört. Dazu zählen Crawler von Suchmaschinen, KI-Diensten und sozialen Netzwerken, Headless-Browser, Prüfwerkzeuge und HTTP-Bibliotheken wie curl. Auch ein leerer User-Agent gilt als Bot. Bestellungen werden nicht nach Bots gefiltert.

Ein eigener Test mit curl oder einem Skript taucht deshalb in der Statistik nicht auf.

## Shopping-Assistent (Beta)

Der Shopping-Assistent ist in der Beta und standardmäßig aus. Wenn Sie ihn nutzen, gilt:

* Gespeichert werden nur echte Texteingaben, nicht Klicks auf Auswahl-Knöpfe. Es wird weder die IP-Adresse noch die Kunden-ID gespeichert.
* Vor dem Speichern werden **E-Mail-Adressen, Telefonnummern, IBAN und lange Ziffernfolgen maskiert**.
* Gespräche werden **nach 30 Tagen gelöscht**.
* Die Sprachauswertung läuft **ausschließlich in Rechenzentren in Deutschland**.
* Namen oder Anschriften, die jemand im Freitext schreibt, werden nicht erkannt und nicht maskiert.

Mehr zum Assistenten finden Sie unter [Shopping-Assistent (Beta)](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/shopping-assistent.md).

## Protokolle im Shop

Das Plugin schreibt Protokolle in Ihren Shop (Ordner `var/log`, Dateien `cogi_insightsearch-<Datum>.log`). Es werden 14 Dateien aufbewahrt. Zugangsdaten werden nicht mitgeschrieben.

## Hinweise für Ihre Datenschutzerklärung

Prüfen Sie, ob Ihre Datenschutzerklärung und Ihr Cookie-Banner folgende Punkte abdecken:

1. Die Suche als Dienstleister, an den Suchanfragen, Produktdaten und Ereignisse übertragen werden.
2. Das Cookie `cogi_recommendation_session` mit Name, Zweck und Laufzeit von 365 Tagen, und die Zuordnung zur Gruppe „Komfortfunktionen“.
3. Die Speicher im Browser (`localStorage`, `sessionStorage`).
4. Die Verarbeitung von Kunden-ID und Kundennummer bei eingeloggten Kunden.
5. Die Erfassung von Warenkorb, Bestellung und Zahlstatus für die Umsatz-Statistik. Für Ihren Shop können Sie sie mit „Bestellungs-Tracking aktivieren“ ausschalten.
6. Falls Sie den Shopping-Assistenten nutzen: Maskierung, Löschung nach 30 Tagen, Auswertung in Deutschland.
7. Falls Sie „Cookie-Einwilligung für die Wiedererkennung ignorieren“ einschalten: wie Sie die Einwilligung anderweitig einholen.

Bitte lassen Sie Ihre Datenschutzerklärung rechtlich prüfen.

## Weiterlesen

{% content-ref url="/pages/ygPmevhI5XOJUeRPfFTy" %}
[Shopping-Assistent (Beta)](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/shopping-assistent.md)
{% endcontent-ref %}

{% content-ref url="/pages/X477UQ3qyxb8nuVOceWJ" %}
[Statistik](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/statistik.md)
{% endcontent-ref %}

{% content-ref url="/pages/Ldiml6Xb2DKBYoCOFNLC" %}
[Plugin Einstellungen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/plugin-einstellungen.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://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/datenschutz.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.
