> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Glossar: Fachbegriffe der WEBSALE-Dokumentation

> Erklärungen zentraler Fachbegriffe rund um WEBSALE, darunter ASSE, Consent, Cookie, Template-Code, Referrer und weitere Konzepte des Shops.

In diesem Glossar werden Fachbegriffe erklärt, die in der WEBSALE-Dokumentation vorkommen. Es richtet sich an alle, die mit dem Shop arbeiten.

***

## Allgemeine Begriffe

## ASSE

Abkürzung für *Asynchronous Server-Side Events*. Ein vom Shop ausgelöstes Ereignis, das im Hintergrund einen HTTP-Request an eine konfigurierte externe URL sendet, z. B. um nach einer Bestellung Daten an einen Tracking-Dienst zu übermitteln. „Asynchron" bedeutet, dass der Request zeitversetzt versendet wird. Der auslösende Seitenaufbau wartet nicht auf die Antwort.

Ausgelöst werden ASSE-Events im Template über [`$wsAsse`](/frontend/referenz/module/wsasse), eingerichtet werden sie in der [ASSE-Konfiguration](/konfiguration/general-allgemeine-shopeinstellungen#4-general-asse-schnittstelle-für-asynchronous-server-side-events-asse).

### ASSE

Abkürzung für *Asynchronous Server-Side Events*. Ein vom Shop ausgelöstes Ereignis, das im Hintergrund einen HTTP-Request an eine konfigurierte externe URL sendet, z. B. um nach einer Bestellung Daten an einen Tracking-Dienst zu übermitteln. „Asynchron" bedeutet, dass der Request zeitversetzt versendet wird. Der auslösende Seitenaufbau wartet nicht auf die Antwort.

Ausgelöst werden ASSE-Events im Template über [`$wsAsse`](/frontend/referenz/module/wsasse), eingerichtet werden sie in der [ASSE-Konfiguration](/konfiguration/general-allgemeine-shopeinstellungen#4-general-asse-schnittstelle-für-asynchronous-server-side-events-asse).

### Consent

Die ausdrückliche Zustimmung eines Besuchers, dass der Shop bestimmte Cookies setzen oder Daten verarbeiten darf. Für technisch notwendige Cookies ist sie nicht erforderlich, für Marketing- und Tracking-Cookies dagegen in der Regel Pflicht (DSGVO).

Im Template prüfen Sie die Zustimmung mit `$wsConsent.checkAllowed()`, bevor Sie ein nicht-notwendiges Cookie setzen. Details: [\$wsConsent](/frontend/referenz/module/wsconsent).

### Cookie

Eine kleine Information, die der Browser pro Website speichert und über mehrere Seitenaufrufe hinweg behält, zum Beispiel eine gewählte Einstellung oder eine Kennung. Ohne Cookie „vergisst" der Shop bei jedem Seitenaufruf alles Vorherige.

In WEBSALE lesen und setzen Sie Cookies über das Modul [\$wsCookie](/frontend/referenz/module/ws-cookie-browser-cookie).

### Flag

Ein Flag ist ein einfacher Markierungswert, der einen Zustand festhält, meist mit nur zwei möglichen Werten wie „ja/nein" oder „gesehen/nicht gesehen". Der Begriff kommt vom englischen Wort für „Fähnchen": Es ist entweder gesetzt oder nicht.

In WEBSALE begegnet Ihnen ein Flag zum Beispiel als Cookie-Wert, der festhält, ob ein Besucher ein Info-Popup bereits gesehen hat. Anhand des Flags entscheidet das Template, ob das Popup noch angezeigt wird.

### JSON

Ein Textformat für strukturierte Daten wie Listen oder Schlüssel-Wert-Paare (die Abkürzung steht für „JavaScript Object Notation"). Es ist menschenlesbar und wird von vielen Werkzeugen verstanden.

In WEBSALE werden komplexe Cookie-Werte (Listen, Maps) intern automatisch als JSON gespeichert. Auch externe Daten liegen häufig als JSON vor (siehe `$wsExternalData`, *Pfad prüfen*).

### Kampagnen-Link

Ein Link zum Shop, der zusätzliche Informationen mitführt, meist als Parameter in der Adresse. Damit lässt sich erkennen, aus welcher Marketing-Aktion ein Besucher kommt, etwa aus einem Newsletter oder einer Anzeige.

Ein Kampagnen-Link ist einer der typischen Auslöser, um ein Cookie zu setzen (Einstiegsweg). Verwandt: [Referrer](#referrer).

### Onsite-Personalisierung

Das gezielte Ausspielen individueller Inhalte oder Angebote direkt auf den Shop-Seiten, abhängig vom Verhalten oder den Merkmalen eines Besuchers.

**Abgrenzung:** Das bloße Speichern einer Einstellung in einem Cookie, etwa eine persönliche Begrüßung, ist für sich genommen noch keine Onsite-Personalisierung. (Doku-Seite *ergänzen, sobald vorhanden*.)

### Referrer

Die Adresse der Seite, von der ein Besucher kommt. Klickt jemand auf einen Link zu Ihrem Shop, übermittelt der Browser meist die Adresse der vorherigen Seite. So erkennen Sie, woher der Besucher stammt.

Der Referrer ist einer der typischen Auslöser, um ein Cookie zu setzen (Einstiegsweg). (Im technischen HTTP-Umfeld wird der Begriff auch „Referer" geschrieben.)

### Session-Cookie

Ein Cookie ohne festgelegte Lebensdauer. Es besteht nur bis zum Schließen des Browsers und wird dann gelöscht.

In WEBSALE entsteht ein Session-Cookie, wenn Sie beim Setzen keine Lebensdauer (`age`) angeben. Soll die Information länger erhalten bleiben, geben Sie eine Dauer an. Details: Modul [\$wsCookie](/frontend/referenz/module/ws-cookie-browser-cookie), Methode `setCookie`.

### Stylesheet

Eine CSS-Datei, die das Aussehen der Seiten festlegt: Farben, Schriften, Abstände und Layout. Ein Wechsel des Stylesheets ändert das Erscheinungsbild, zum Beispiel von einer hellen auf eine dunkle Darstellung.

***

## WEBSALE-spezifische Begriffe

### Template-Code

Code in den WEBSALE-Templates (den `.htm`-Dateien), der beim **Seitenaufbau** auf dem Server ausgeführt wird, nicht erst beim Klick des Nutzers.

Wichtige Folge: Aktionen wie das Setzen eines Cookies passieren während eines Seitenaufrufs, nicht im Moment des Klicks. Ein Klick wirkt erst, wenn er eine neue Anfrage auslöst und das Template dabei erneut durchläuft. (Konzept-Seite zu Templates *verlinken, sobald vorhanden*.)
