> 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/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/cross-selling-tracking-und-datenverarbeitung.md).

# Cross-Selling Tracking und Datenverarbeitung

Welche Daten Cross Selling Pro für Empfehlungen und Statistik verarbeitet, welche Cookies es setzt und welche Schalter Sie dafür haben.

Damit Cross Selling Pro persönliche Empfehlungen zeigen und Umsätze zuordnen kann, meldet das Plugin Ereignisse aus Ihrem Shop an InsightSearch. Diese Seite beschreibt, welche Daten das sind, welche Cookies im Browser landen und wie Sie den Umfang mit den Schaltern der Karte „Tracking“ steuern. Sie hilft Ihnen auch beim Ausfüllen Ihrer Datenschutzerklärung und beim Einrichten Ihres Cookie-Hinweises.

{% hint style="warning" %}
Diese Seite beschreibt das technische Verhalten des Plugins. Sie ist keine Rechtsberatung. Stimmen Sie die Einstellungen und Ihre Datenschutzerklärung bitte mit Ihrem Datenschutzbeauftragten ab.
{% endhint %}

## Wofür das Tracking da ist

Das Tracking hat drei Aufgaben:

* **Personalisierung:** Typen wie „Zuletzt Angesehen“, „Personalisiert“, „Weitermachen wo du aufgehört hast“ oder „Erneut kaufen“ brauchen Wissen darüber, was ein Besucher angesehen, in den Warenkorb gelegt oder gekauft hat.
* **Kaufdaten für Empfehlungen:** Bestellungen zeigen, welche Produkte oft zusammen gekauft werden. Davon leben zum Beispiel „Passt gut dazu“ und „Bestseller“.
* **Statistik:** Einblendungen, Klicks und Umsatz durch Empfehlungen erscheinen im Plugin-Dashboard unter „Statistik“.

Ohne Tracking zeigt Cross Selling Pro weiterhin Empfehlungen auf Basis der Produktdaten, zum Beispiel „Ähnliche Produkte (Alternativen)“. Persönliche Empfehlungen und die Statistik werden dann aber dünner oder fallen weg.

## Welche Daten übertragen werden

Die Produktdaten aus Ihrem Feed enthalten keine Kundendaten. Kundenbezogene Angaben entstehen nur über die folgenden Ereignisse.

### Warenkorb

Legt ein Besucher ein Produkt in den Warenkorb, meldet der Shop an InsightSearch: Produkt, Menge, Preis, eine Sitzungskennung und bei angemeldeten Kunden die Kunden-ID und die Kundennummer. Kunden-ID und Kundennummer lassen sich mit „Kundenbezug senden“ abschalten.

### Bestellungen

Bei einer Bestellung gehen an InsightSearch: Bestell-ID, die Positionen mit Produkt, Einzelpreis und Menge, die Beträge (unter anderem Bestellsumme, Nettosumme, Versandkosten, Währung), Zahl- und Bestellstatus, eine Sitzungskennung und bei angemeldeten Kunden die Kunden-ID und die Kundennummer. Zu jeder Position wird außerdem vermerkt, ob sie aus einer Empfehlung in den Warenkorb kam. Dazu kommen Gerätetyp und die Kennung des Browsers.

Name, Anschrift, E-Mail-Adresse, Telefonnummer und Zahlungsdaten werden mit Bestellungen nicht übertragen.

### Ereignisse aus dem Browser

Aus dem Browser kommen Seitenaufrufe, Einblendungen von Empfehlungen und Klicks auf Empfehlungen. Mitgesendet werden unter anderem die Seitenadresse, der Seitentitel, der Seitentyp (etwa Startseite, Kategorie, Produkt, Suche, Warenkorb), auf der Suchergebnisseite der Suchbegriff, der Gerätetyp (Handy, Tablet, Desktop), die Kennung des Browsers, die Sitzungskennung und bei angemeldeten Kunden die Kunden-ID, wenn „Kundenbezug senden“ an ist.

Die Seitenadresse wird vorher bereinigt: Zugangsdaten, Passwort- und Bestätigungslinks sowie der Code in Bestell-Links für Gäste werden entfernt. Kampagnen-, Such- und Filterangaben bleiben erhalten.

Diese Ereignisse laufen über Ihren Shop. Der Shop prüft sie und gibt sie im Hintergrund an InsightSearch weiter.

### Abruf der Empfehlungen

Die Empfehlungen selbst lädt der Browser des Besuchers direkt bei InsightSearch. Dabei erhält InsightSearch technisch bedingt die IP-Adresse des Besuchers.

### Anmeldung

Meldet sich ein Kunde an, geht ein Ereignis mit der Sitzungskennung an InsightSearch. Ist „Kundenbezug senden“ an, kommt der Kundenbezug dazu. So lässt sich das Verhalten vor der Anmeldung dem Kunden zuordnen.

## Die Schalter der Karte „Tracking“

Sie finden die Karte unter **Erweiterungen → Meine Erweiterungen → Cross Selling Pro → Konfigurieren** oder im Plugin-Dashboard unter **System → Plugin-Konfiguration**. Alle Schalter lassen sich je Verkaufskanal einstellen.

| Einstellung                                     | Wirkung                                                                                                                                       | Standard                                              |
| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| „Einstellung im Consent Manager ignorieren“     | Setzt das Komfort-Cookie für Empfehlungen immer, auch ohne Zustimmung im Cookie-Hinweis. Der Hilfetext im Admin sagt dazu: „nicht empfohlen!“ | aus                                                   |
| „Bestell-Tracking aktivieren“                   | Sendet Bestellungen an InsightSearch. Nötig für Umsatz durch Empfehlungen und für Kaufdaten                                                   | an                                                    |
| „Warenkorb-Tracking aktivieren“                 | Meldet Produkte, die in den Warenkorb gelegt werden                                                                                           | an                                                    |
| „Kundenbezug senden“                            | Siehe Hilfetext unten                                                                                                                         | an                                                    |
| „Ereignisse aus dem Browser“                    | „Immer (wie bisher)“, „Nur mit Einwilligung“ oder „Aus“                                                                                       | „Immer (wie bisher)“                                  |
| „Transaktionsstatus die als "bezahlt" gelten“   | Welche Zahlstatus in der Statistik als bezahlt zählen                                                                                         | „Bezahlt“, „Teilweise bezahlt“, „Teilweise erstattet“ |
| „Transaktionsstatus die als "storniert" gelten“ | Welche Zahlstatus als storniert zählen                                                                                                        | „Abgebrochen“, „Fehlgeschlagen“, „Erstattet“          |

### „Kundenbezug senden“

Der Hilfetext im Admin lautet: „Wenn aktiv, gehen bei angemeldeten Kunden Kunden-ID und Kundennummer mit Bestellungen, Warenkörben und Klicks an InsightSearch. Das braucht die Personalisierung für Empfehlungstypen wie „Erneut kaufen“. Wenn aus, sind diese Ereignisse nur über die Sitzungskennung verknüpft.“

### „Ereignisse aus dem Browser“

Der Standard ist „Immer (wie bisher)“. Damit gehen Seitenaufrufe, Einblendungen und Klicks **auch ohne Einwilligung** an InsightSearch, verknüpft über die Sitzungskennung.

* **„Nur mit Einwilligung“** sendet diese Ereignisse erst, wenn der Besucher dem Komfort-Cookie „Personalisierte Empfehlungen“ zugestimmt hat.
* **„Aus“** sendet keine Ereignisse aus dem Browser.

In beiden Fällen fehlen in der Statistik Einblendungen und Klickrate ganz oder teilweise. Warenkorb und Bestellungen hängen nicht an diesem Schalter, sondern an ihren eigenen Schaltern.

{% hint style="info" %}
Die zurückhaltendste Einstellung ist: „Ereignisse aus dem Browser“ auf „Nur mit Einwilligung“ oder „Aus“, „Kundenbezug senden“ aus und „Einstellung im Consent Manager ignorieren“ aus. Dann gibt es keine Personalisierung über das Kundenkonto (etwa „Erneut kaufen“) und weniger Zahlen in der Statistik.
{% endhint %}

### Zahlstatus und Kauf auf Rechnung

Bestellungen mit stornierten Zahlstatus zählen nicht als Umsatz durch Empfehlungen. Bezahlte, offene und unbekannte zählen. Werden Zahlungen in Ihrem Shop nie als bezahlt bestätigt, etwa bei Kauf auf Rechnung, wählen Sie bei „Transaktionsstatus die als "bezahlt" gelten“ zusätzlich „Offen“.

## Cookies und Browser-Speicher

Das Plugin trägt seine Cookies selbst in den Cookie-Hinweis von Shopware ein.

| Name                                | Eintrag im Cookie-Hinweis       | Gruppe                 | Laufzeit       | Zweck                                                                                                            |
| ----------------------------------- | ------------------------------- | ---------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------- |
| `cogi_recommendation_session_token` | „Produktempfehlungen (Sitzung)“ | technisch erforderlich | wenige Minuten | Kurzlebiger Zugangsschlüssel, mit dem der Browser die Empfehlungen abruft                                        |
| `cogi_recommendation_session`       | „Personalisierte Empfehlungen“  | Komfortfunktionen      | 365 Tage       | Zufällige Besucher-ID, damit Empfehlungen beim nächsten Besuch wieder passen. Wird nur nach Einwilligung gesetzt |

* Widerruft ein Besucher die Einwilligung, wird das Komfort-Cookie gelöscht.
* Ohne Einwilligung nutzt das Plugin statt der Besucher-ID eine Kennung, die aus der Shop-Sitzung abgeleitet und nicht umkehrbar ist. Sie gilt nur, solange die Sitzung im Shop besteht.
* Der Conversion Booster merkt sich seine Sitzung eine Stunde lang im Speicher des Browsers, aber nur mit Einwilligung. Sonst nur, solange die Seite geöffnet ist.

{% hint style="warning" %}
Nutzen Sie ein eigenes Einwilligungs-Tool statt des Cookie-Hinweises von Shopware, ordnen Sie `cogi_recommendation_session` dort selbst der Gruppe für Komfort oder Personalisierung zu. Das Plugin erkennt die Einwilligung am gesetzten Cookie.
{% endhint %}

## Besucher, Sitzung und Besuch

* **Besucher:** mit Einwilligung die zufällige ID aus dem Komfort-Cookie, sonst die aus der Shop-Sitzung abgeleitete Kennung.
* **Besuch:** Ein Besuch endet nach 30 Minuten ohne Aktivität. Er bleibt bei der Anmeldung erhalten.
* **Zusammen mit dem Such-Plugin:** Ist das Such-Plugin InsightSearch installiert, erkennen beide Plugins Besucher und Besuche auf dieselbe Weise.
* **Zwischenspeicher:** Kunden-ID, Kundennummer und Sitzung stehen nicht im zwischengespeicherten HTML Ihrer Seiten. Das Plugin lädt sie für jeden Besucher getrennt nach.

## Bots und Crawler

Der Shop sendet die Kennung des Browsers mit, damit Bots erkannt werden. Ereignisse von Bots fließen nicht in Empfehlungen und Statistik ein. Auch für die Kennzahlen im cogi Commander sortiert das Plugin Bots vorher aus.

## Daten im Shop selbst

* **Nutzer-Tracking im Admin:** Unter **Überblick → Nutzer-Tracking** sehen Sie die Verläufe einzelner Sitzungen, auf denen die persönlichen Empfehlungen beruhen. Dafür brauchen Sie das Recht „Bestellungen ansehen“.
* **cogi Commander:** Warenkorb und Bestellungen aus Empfehlungen zählt das Plugin für den Commander im Shop, unabhängig von der Einwilligung. Einblendungen und Klicks folgen dagegen „Ereignisse aus dem Browser“. Ist der Commander nicht installiert, bleiben die Tagessummen 90 Tage im Shop. Mehr dazu unter [Zusammenspiel mit anderen Plugins](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/zusammenspiel-mit-anderen-plugins.md).
* **Warteschlange:** Bis die Hintergrundverarbeitung von Shopware ein Ereignis weitergibt, liegt es in der Warteschlange Ihres Shops. Läuft diese Verarbeitung nicht, stauen sich die Ereignisse. Siehe [Technik und Betrieb](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/technik-und-betrieb.md).

## Checkliste für Ihre Datenschutzerklärung

Diese Punkte sollten Sie mit Ihrem Datenschutzbeauftragten durchgehen:

1. Die beiden Cookies und ihre Gruppen im Cookie-Hinweis.
2. Die Einstellung „Ereignisse aus dem Browser“. Der Standard sendet auch ohne Einwilligung.
3. Ob Sie „Kundenbezug senden“ brauchen, etwa für „Erneut kaufen“.
4. Dass Bestellungen und Warenkörbe mit Beträgen und Sitzungskennung an InsightSearch gehen.
5. Dass der Browser die Empfehlungen direkt bei InsightSearch abruft und dabei die IP-Adresse übermittelt wird.
6. Wenn Sie ein eigenes Einwilligungs-Tool nutzen: die Zuordnung von `cogi_recommendation_session`.

Fragen zu Vertragsunterlagen wie einer Auftragsverarbeitung stellen Sie bitte an den Support.

## Weiterlesen

{% content-ref url="/pages/19dd99dc5a16be5f7fb7d6dfa77ced388d560bba" %}
[Statistiken](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/statistiken.md)
{% endcontent-ref %}

{% content-ref url="/pages/enEkOGiDkia4Xa21DEfe" %}
[Technik und Betrieb](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/technik-und-betrieb.md)
{% endcontent-ref %}

{% content-ref url="/pages/aCNptxGGhAgb4q2w1Roy" %}
[Zusammenspiel mit anderen Plugins](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/zusammenspiel-mit-anderen-plugins.md)
{% endcontent-ref %}

{% content-ref url="/pages/GGXPYNq3gHeZ8533R9E7" %}
[Fehlersuche und häufige Fragen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/fehlersuche-und-faq.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/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/cross-selling-tracking-und-datenverarbeitung.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.
