> ## 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.

# Strukturierte Daten und Rich Snippets

> Preise, Bewertungen, Kategoriepfad und Unternehmensdaten als Mikrodaten auszeichnen, damit Suchmaschinen erweiterte Suchergebnisse anzeigen können.

Ein Suchergebnis kann eine Zeile Text sein oder ein Eintrag mit Preis, Bewertungssternen und Kategoriepfad. Den Unterschied macht die Auszeichnung der Seiteninhalte mit Mikrodaten. Sie sagen der Suchmaschine nicht nur, dass eine Zahl auf der Seite steht, sondern dass diese Zahl ein Preis ist.

Ausgezeichnet wird mit drei HTML-Attributen:

| Attribut | Bedeutung |
| - | - |
| `itemscope` | hier beginnt ein Element mit strukturierten Daten |
| `itemtype` | um welchen Informationstyp es sich handelt, angegeben als Adresse aus dem Vokabular von schema.org |
| `itemprop` | welche Eigenschaft des Elements der Inhalt beschreibt |

Elemente lassen sich verschachteln, und zu einem `itemtype` gehören meist mehrere `itemprop`. Welche Angaben eine Suchmaschine tatsächlich auswertet, entscheidet sie selbst. Die Auszeichnung ist eine Einladung, keine Garantie.

![Snippets Screenweb3](https://mintcdn.com/websaleag-44ee7ea6/-VOorhOnZ4aGhsis/images/snippets_screenweb3.jpg?fit=max\&auto=format\&n=-VOorhOnZ4aGhsis\&q=85\&s=5655167af48ae6be51d73a8350a00996)

> [!WARNING]
>
> Zeichnen Sie nur aus, was auf der Seite auch sichtbar ist. Angaben, die ausschließlich im Markup stehen, werden von Suchmaschinen ignoriert oder als Täuschungsversuch gewertet.

## Produktdaten auszeichnen

Das Markup für `Product` gehört um den Bereich, der alle Produktinformationen enthält, also Bild, Name, Preis, Bewertung und Beschreibung.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<div itemscope itemtype="https://schema.org/Product">

   <img src="~PR-Image~" itemprop="image">

   <h1 itemprop="name">~PR-Name~</h1>

   <div itemprop="offers" itemscope itemtype="https://schema.org/Offer">

      <!-- Währung: im content das Kürzel, sichtbar das Symbol -->
      <span itemprop="priceCurrency" content="~WS-Currency~">~WS-CurrencySymbol~</span>

      <!-- Preis: im content unformatiert, sichtbar formatiert -->
      <span itemprop="price" content="~WS-DisablePriceAndNumberFormat~~PR-Price~~WS-EnablePriceAndNumberFormat~">~PR-Price~</span>

   </div>

   {PR-Descr}
      <span itemprop="description">~PR-Descr~</span>
   {/PR-Descr}

</div>
```

Der Preis wird im `content`-Attribut ohne Tausenderpunkt und mit Punkt als Dezimaltrennzeichen erwartet. Genau das leisten die beiden Klammer-Tags `WS-DisablePriceAndNumberFormat` und `WS-EnablePriceAndNumberFormat`, während der sichtbare Preis formatiert bleibt.

Referenz: [PR-Image](https://dokumentation.websale.de/v8s/referenz/tags/pr/bilder-und-links.md#die-tags-im-uberblick) · [PR-Name](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md#die-tags-im-uberblick) · [PR-Price](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md) · [PR-Descr](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md#beschreibungstexte) · [WS-Currency](https://dokumentation.websale.de/v8s/referenz/tags/ws/warenkorb-preise-waehrung-und-bonus.md#die-tags-im-uberblick) · [WS-CurrencySymbol](https://dokumentation.websale.de/v8s/referenz/tags/ws/warenkorb-preise-waehrung-und-bonus.md#die-tags-im-uberblick) · [WS-DisablePriceAndNumberFormat](https://dokumentation.websale.de/v8s/referenz/tags/ws/shop-seite-und-technik.md#die-tags-im-uberblick)

## Bewertungen aus der WEBSALE Produktbewertung

Für diesen Abschnitt muss das Modul "WEBSALE Produktbewertung" freigeschaltet und integriert sein.

### Durchschnitt und Anzahl

Der Block gehört innerhalb des `Product`-Elements.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<div itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating">
   <span itemprop="ratingValue">~PR-RatingScore~</span>
   <span itemprop="ratingCount">~PR-RatingVotes~</span>
</div>
```

### Einzelne Bewertungen

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<div itemprop="reviews" itemscope itemtype="https://schema.org/Review">

   {@PRODRATING-Data}

      <span itemprop="author">~A-NickName_value~</span>

      <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
         <meta itemprop="worstRating" content="1">
         <meta itemprop="bestRating" content="5">
         <span itemprop="ratingValue">~PRODRATING-Rating_value~</span>
      </div>

      <span itemprop="name">~PRODRATING-Subject_value~</span>
      <span itemprop="description">~PRODRATING-Comment_value~</span>

   {/@PRODRATING-Data}

</div>
```

`worstRating` und `bestRating` geben die Skala an. Ohne diese Angaben nehmen Suchmaschinen 1 und 5 an.

Referenz: [PR-RatingScore](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md) · [PR-RatingVotes](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md) · [A-NickName\_Value](https://dokumentation.websale.de/v8s/referenz/tags/prodrating/bewertung-abgeben-und-bestaetigen.md#das-formular-aufbauen) · PRODRATING-Data · [PRODRATING-Rating\_value](https://dokumentation.websale.de/v8s/referenz/tags/prodrating/bewertung-abgeben-und-bestaetigen.md#die-tags-im-uberblick) · [PRODRATING-Subject\_value](https://dokumentation.websale.de/v8s/referenz/tags/prodrating/bewertung-abgeben-und-bestaetigen.md#die-tags-im-uberblick) · [PRODRATING-Comment\_value](https://dokumentation.websale.de/v8s/referenz/tags/prodrating/bewertung-abgeben-und-bestaetigen.md#die-tags-im-uberblick)

## Shopbewertungen von Trusted Shops und eKomi

Beide Anbieter lassen Kunden den Shop nach Kriterien wie Kundenservice, Lieferung und Zustand der Ware bewerten. WEBSALE V8s holt einmal täglich die Durchschnittsbewertung und die Anzahl der Bewertungen ab, legt sie in der Shop-Datenbank ab und stellt sie über ein Tag zur Verfügung.

Die Einbindung ist für beide Anbieter identisch. Sie unterscheidet sich allein im ersten Parameter:

| Anbieter | Parameter |
| - | - |
| Trusted Shops | `trustedshops` |
| eKomi | `ekomi` |

### Freischaltung

Die Übernahme der Bewertungen muss für Ihren Shop freigeschaltet werden. Ihr WEBSALE Ansprechpartner kennt die Funktion unter dem Namen "third party import".

### Werte im Shop anzeigen

Das Tag `WS-ThirdPartyData()` liefert je nach zweitem Parameter den Durchschnitt (`score`) oder die Anzahl (`votes`). Als Klammerung zeigt es einen Bereich nur dann, wenn ein Wert vorliegt. Anzeigen lassen sich die Werte auf jeder Shopseite.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{WS-ThirdPartyData(trustedshops,score)}
   Durchschnittsbewertung: ~WS-ThirdPartyData(trustedshops,score)~
{/WS-ThirdPartyData(trustedshops,score)}

{WS-ThirdPartyData(trustedshops,votes)}
   Anzahl Bewertungen: ~WS-ThirdPartyData(trustedshops,votes)~
{/WS-ThirdPartyData(trustedshops,votes)}
```

### Werte als Mikrodaten übergeben

Üblich ist die Auszeichnung auf der Startseite, weil die Bewertung dem Shop gilt und nicht einem einzelnen Produkt.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<div itemscope itemtype="https://schema.org/LocalBusiness">

   <div itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating">

      {WS-ThirdPartyData(trustedshops,score)}
         <span itemprop="ratingValue">~WS-ThirdPartyData(trustedshops,score)~</span>
      {/WS-ThirdPartyData(trustedshops,score)}

      {WS-ThirdPartyData(trustedshops,votes)}
         <span itemprop="ratingCount">~WS-ThirdPartyData(trustedshops,votes)~</span>
      {/WS-ThirdPartyData(trustedshops,votes)}

   </div>

</div>
```

Für eKomi ersetzen Sie in allen sechs Stellen `trustedshops` durch `ekomi`.

Referenz: [WS-ThirdPartyData()](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste.md#die-tags-im-uberblick)

Wegweiser: [Trusted Shops](https://dokumentation.websale.de/v8s/marketing-funktionen/trusted-shops.md) · [eKomi](https://dokumentation.websale.de/v8s/referenz/tags/e-prodrating-ekomi.md)

### Produktbewertungen der Anbieter

Trusted Shops überträgt Produktbewertungen selbst an Google. Was dafür einzurichten ist, steht beim Gütesiegel.

Bei eKomi übergeben Sie die Produktbewertungen über das Template. Der folgende Block gehört innerhalb eines `Review`-Elements, das wiederum im `Product`-Element steht.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<meta itemprop="author" content="Kundenbewertung">
<meta itemprop="about" content="~PR-Name~">
<meta itemprop="datePublished" content="~E-PRODRATING-EKOMI_FeedbackData_Timestamp_year(true)~-~E-PRODRATING-EKOMI_FeedbackData_Timestamp_month(true)~-~E-PRODRATING-EKOMI_FeedbackData_Timestamp_day(true)~">

<div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
   <meta itemprop="worstRating" content="1">
   <meta itemprop="ratingValue" content="~E-PRODRATING-EKOMI_FeedbackData_Rating~">
   <meta itemprop="bestRating" content="5">
</div>

<meta itemprop="description" content="~E-PRODRATING-EKOMI_FeedbackData_Feedback~">
```

Der Parameter `true` bei den drei Zeit-Tags sorgt für die führende Null. Ohne sie entsteht aus dem 3. Mai kein gültiges Datum im Format `JJJJ-MM-TT`.

Referenz: [E-PRODRATING-EKOMI\_FeedbackData\_Timestamp\_day()](https://dokumentation.websale.de/v8s/referenz/tags/e-prodrating-ekomi.md#datum-und-uhrzeit-in-einzelteilen) · [E-PRODRATING-EKOMI\_FeedbackData\_Timestamp\_month()](https://dokumentation.websale.de/v8s/referenz/tags/e-prodrating-ekomi.md#datum-und-uhrzeit-in-einzelteilen) · [E-PRODRATING-EKOMI\_FeedbackData\_Timestamp\_year()](https://dokumentation.websale.de/v8s/referenz/tags/e-prodrating-ekomi.md#datum-und-uhrzeit-in-einzelteilen) · [E-PRODRATING-EKOMI\_FeedbackData\_Feedback](https://dokumentation.websale.de/v8s/referenz/tags/e-prodrating-ekomi.md#die-einzelnen-bewertungen) · [E-PRODRATING-EKOMI\_FeedbackData\_Rating](https://dokumentation.websale.de/v8s/referenz/tags/e-prodrating-ekomi.md#die-einzelnen-bewertungen)

Wegweiser: Gütesiegel Trusted Shops

## Kategoriepfad auszeichnen

Die Breadcrumb-Navigation entsteht aus einer Schleife über den Kategoriepfad. In diese Schleife lässt sich die Auszeichnung einbauen. Jede Station braucht dabei ihre Position im Pfad, die ein Zähler liefert.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{Cat-PathData}
   ~DC-Int1_set(0)~
   <ol itemscope itemtype="https://schema.org/BreadcrumbList">
      {@CAT-PathRegular}
         ~DC-Int1_inc~
         <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
            <a itemprop="item" href="~Cat-Link~">
               <span itemprop="name">~Cat-Name~</span>
            </a>
            <meta itemprop="position" content="~DC-Int1~">
         </li>
      {/@CAT-PathRegular}
   </ol>
{/Cat-PathData}
```

> [!WARNING]
>
> `~DC-Int1_set(0)~` gehört vor die Schleife. Steht es innerhalb, wird der Zähler bei jedem Durchlauf zurückgesetzt und alle Stationen tragen die Position 1.

Ältere Beispiele zeichnen den Pfad mit `https://schema.org/breadcrumb` und den Eigenschaften `title` und `url` aus. Diese Form wird nicht mehr ausgewertet. `BreadcrumbList` mit `ListItem`, `item`, `name` und `position` ist der aktuelle Stand.

Referenz: [Cat-PathData](https://dokumentation.websale.de/v8s/referenz/tags/cat/navigation-und-kategoriebaum.md#cat-pathdata) · [Cat-PathRegular](https://dokumentation.websale.de/v8s/referenz/tags/cat/navigation-und-kategoriebaum.md#die-tags-im-uberblick) · [Cat-PathReverse](https://dokumentation.websale.de/v8s/referenz/tags/cat/navigation-und-kategoriebaum.md#die-tags-im-uberblick) · [Cat-Link](https://dokumentation.websale.de/v8s/referenz/tags/cat/navigation-und-kategoriebaum.md#cat-link) · [Cat-Name](https://dokumentation.websale.de/v8s/referenz/tags/cat/kategoriedaten.md#die-tags-im-uberblick) · [DC-Int1…3](https://dokumentation.websale.de/v8s/referenz/tags/dc/rechnen.md) · [DC-Int1…3\_set](https://dokumentation.websale.de/v8s/referenz/tags/dc/rechnen.md#die-tags-im-uberblick) · [DC-Int1…3\_inc](https://dokumentation.websale.de/v8s/referenz/tags/dc/rechnen.md#die-tags-im-uberblick)

## Das Unternehmen auszeichnen

Adresse, Telefonnummer und Logo gehören auf alle Shopseiten und damit sinnvollerweise in ein Include, das überall eingebunden ist.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<div itemscope itemtype="https://schema.org/Organization">

   <a itemprop="url" href="~URL-Homepage~">
      <img src="firmenlogo.png" itemprop="logo">
   </a>

   <span itemprop="address">Musterweg 21, 12345 Musterhausen</span>
   <span itemprop="telephone">0123456789</span>

</div>
```

Referenz: [URL-Homepage](https://dokumentation.websale.de/v8s/referenz/tags/url-internetadresse.md#die-adressen-des-shops)

## Prüfen

Ob die Auszeichnung gelesen werden kann, prüfen Sie mit dem Test für strukturierte Daten von Google. Er zeigt jedes erkannte Element mit seinen Eigenschaften und meldet fehlende Pflichtangaben.

## Verwandte Themen

* Wegweiser: Trusted Shops
* Wegweiser: eKomi
* Wegweiser: [SEO-URLs und Link-Optimierung](https://dokumentation.websale.de/v8s/seo/seo-urls-und-link-optimierung.md)


## Related topics

- [Navigation und Kategoriebaum](https://dokumentation.websale.de/v8s/referenz/tags/cat/navigation-und-kategoriebaum.md)
- [Trusted Shops](https://dokumentation.websale.de/v8s/marketing-funktionen/trusted-shops.md)
- [eKomi Produktbewertung](https://dokumentation.websale.de/v8s/interaktive-funktionen/ekomi-produktbewertung.md)
- [E-PRODRATING-EKOMI_ (eKomi Produktbewertung)](https://dokumentation.websale.de/v8s/referenz/tags/e-prodrating-ekomi.md)
- [Daten-Migration](https://dokumentation.websale.de/migration/daten-migration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.