seoMetaData - Meta-Daten & Seo-Texte

Der seoMetaData-Knoten steuert den Aufbau von Meta-Title und Meta-Description für Kategorien, Produkte, Startseite sowie freie Templates per Bausteinen.

Der Knoten seoMetaData steuert, wie Meta-Title und Meta-Description im Shop gebaut werden - für Kategorien, Produkte, die Startseite und frei definierte Templates. Statt jeden Text manuell zu pflegen, lassen sich Bausteine Kombinieren, inklusive Trennzeichen und Reihenfolge.

---

​

seoMetaData* - Grundstruktur

Nachfolgend der Grundaufbau des Knotens seoMetaData:

{
    "seoMetaData": {
      "categorySchemes": {...},
      "generalSchemes": {...},
      "productSchemes": {...},
      "startPage": {...},
      "viewSchemes": {...}
    }
}

​

Parameterbeschreibung

Parameter	Beschreibung
categorySchemes	Bausteine für Meta-Title und Description von Kategorien.
generalSchemes	Definiert das globale SEO-Schema.
productSchemes	Bausteine für Meta-Title und Description von Produkten.
startPage	Bausteine für Meta-Title und Description für die Startseite.
viewSchemes	Bausteine für Meta-Title und Description für Templates.

---

​

seoMetaData.categorySchemes - Kategorie-Meta-Daten

Der Knoten seoMetaData.categorySchemes liefert Bausteine für Meta-Title und Meta-Description von Kategorien.

​

Beispielkonfiguration

{
  "generalMetaDescription": false,
  "generalMetaTitle": false,
  "metaTitleForms": [
    {
      "separator": "",
      "termType": "categoryField",
      "termData": { "categoryField": "content.categoryField:name" }
    },
    {
      "separator": " | ",
      "termType": "customCategoryField",
      "termData": { "customCategoryField": "content.customCategoryField:brandTagline" }
    },
    {
      "separator": " – ",
      "termType": "freeText",
      "termData": { "freeText": "Jetzt online kaufen" }
    }
  ],
  "metaDescriptionForms": [
    {
      "separator": "",
      "termType": "customCategoryField",
      "termData": { "customCategoryField": "content.customCategoryField:metaIntro" }
    },
    {
      "separator": " ",
      "termType": "categoryField",
      "termData": { "categoryField": "content.categoryField:descr" }
    },
    {
      "separator": " ",
      "termType": "freeText",
      "termData": { "freeText": "Top Auswahl • Schneller Versand" }
    }
  ]
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
metaTitleForms	list (object)	Liste der “Bausteine” für den Meta-Titel einer Kategorie. Die Einträge werden der Reihe nach mit separator aneinandergefügt.
separator	string	Trennzeichen, das vor diesem Term eingefügt wird (z.B. -).
termType	enum	Art des Terms. Folgende Werte sind möglich: - categoryField - verweist auf Standard-Kategoriefelder (z.B. name, descr) - customCategoryField - verweist auf selbst angelegte Kategoriefelder - freeText - ein fester Text, der in termDatadefiniert werden kann.
termData	oneOf	Daten des Terms - je nach gewähltem termType.
freeText	string	Selbst definierter, fester Text für freeText.
categoryField	singleAssoc	Angabe eines Standard-Kategoriefelds aus content.categoryField.
customCategoryField	singleAssoc	Angabe eines benutzerdefinierten Kategoriefelds aus content.customCategoryField.
generalMetaTitle	bool	Nutzt den Standard-Meta-Title statt den obigen Bausteinen.
metaDescriptionForms	list (object)	Bausteinliste für die Meta-Description - analog zu metaTitleForms.
separator	string	Trennzeichen, das vor diesem Term eingefügt wird (z.B. -).
termType	enum	Art des Terms. Folgende Werte sind möglich: - categoryField - verweist auf Standard-Kategoriefelder (z.B. name, descr) - customCategoryField - verweist auf selbst angelegte Kategoriefelder - freeText - ein fester Text, der in termDatadefiniert werden kann.
termData	oneOf	Daten des Terms - je nach gewähltem termType.
freeText	string	Selbst definierter, fester Text für freeText.
categoryField	singleAssoc	Angabe eines Standard-Kategoriefelds aus content.categoryField.
customCategoryField	singleAssoc	Angabe eines benutzerdefinierten Kategoriefelds aus content.customCategoryField.
generalMetaDescription	bool	Nutzt die Standard-Meta-Description statt den obigen Bausteinen.

---

​

seoMetaData.generalSchemes - Allgemeines SEO-Schema

Der Knoten seoMetaData.generalSchemes definiert globale SEO-Texte und Muster. Dazu zählen Standard-Meta-Daten für die Startseite sowie „Formeln“ (Forms), mit denen z. B. Tab-Titel oder Snippets automatisch aus Kategorie-/Produktfeldern und freiem Text zusammengesetzt werden.

​

Beispielkonfiguration

{
  "initialTabs": [
    {
      "forms": [
        {
          "separator": "-",
          "termData": {
            "categoryField": "content.categoryField.name"
          },
          "termType": "categoryField"
        },
        {
          "separator": null,
          "termData": {
            "categoryField": "content.categoryField.descr"
          },
          "termType": "categoryField"
        }
      ]
    },
    {
      "forms": [
        {
          "separator": null,
          "termData": {
            "categoryField": "content.categoryField.descr"
          },
          "termType": "categoryField"
        }
      ]
    },
    {
      "forms": null
    },
    {
      "forms": [
        {
          "separator": null,
          "termData": {
            "productField": "content.productField.descr"
          },
          "termType": "productField"
        }
      ]
    },
    {
      "forms": [
        {
          "separator": "-",
          "termData": {
            "freeText": "test"
          },
          "termType": "freeText"
        },
        {
          "separator": null,
          "termData": {},
          "termType": "resourceId"
        }
      ]
    },
    {
      "forms": [
        {
          "separator": null,
          "termData": {},
          "termType": "resourceId"
        }
      ]
    }
  ],
  "startPageMetaData": {
    "metaDescription": "",
    "metaTitle": "startseite beschreibung"
  }
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
initialTabs	list (object)	Liste von Bausteinen für Tabs, aus denen der Shop SEO-Texte zusammenstellt.
forms	list (object)	Die einzelnen Textbausteine, aus denen ein Tab zusammengesetzt wird.
separator	string	Trennzeichen, das vor diesem Baustein eingefügt wird. (z.B. “-“)
termData	oneOf	Daten des Terms - je nach gewähltem termType.
termType	enum	Art des Terms. Folgende Werte sind möglich: - categoryField - verweist auf Standard-Kategoriefelder (z.B. name, descr) - customCategoryField - verweist auf selbst angelegte Kategoriefelder - productField - verweist auf ein Standardfeld eines Produkts (z.B. name) - customProductField - verweist auf selbst angelegte Produktfelder. - resourceId- verweist auf eine Kategorie- oder Produkt-ID. - freeText - ein fester Text, frei zu vergebender Text.
categoryField	singleAssoc	Wert aus einem Standard-Kategoriefeld (z.b. name). Wert aus content.categoryField.
customCategoryField	singleAssoc	Wert aus einem benutzerdefinierten Kategoriefeld. Wert aus content.customCategoryField
productField	singleAssoc	Wert aus einem Standard-Produktfeld. (z.B. descr). Wert aus content.productField.
customProductField	singleAssoc	Wert aus einem benutzerdefinierten Produktfeld. Wert aus content.customProductField
freeText	string	Fest vorgegebener, selbst gewählter Text.
startPageMetaData	object	Standard-Meta-Daten der Startseite.
metaDescription	string	Meta-Description der Startseite.
metaTitle	string	Meta-Title der Startseite

---

​

seoMetaData.productSchemes - Produkt-Meta-Daten

Der Knoten seoMetaData.productSchemes steuert, wie Meta-Title und Meta-Description für Produktseiten zusammengesetzt werden.

​

Beispielkonfiguration

{
  "generalMetaTitle": false,
  "generalMetaDescription": false,

  "metaTitleForms": [
    {
      "separator": " – ",
      "termType": "productField",
      "termData": { "productField": "content.productField.name" }
    },
    {
      "separator": " | ",
      "termType": "customProductField",
      "termData": { "customProductField": "content.customProductField.brand" }
    },
    {
      "separator": null,
      "termType": "freeText",
      "termData": { "freeText": "Offizieller Shop" }
    }
  ],

  "metaDescriptionForms": [
    {
      "separator": "",
      "termType": "productField",
      "termData": { "productField": "content.productField.descr" }
    },
    {
      "separator": " • ",
      "termType": "customProductField",
      "termData": { "customProductField": "content.customProductField.keyFeatures" }
    }
  ]
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
generalMetaTitle	bool	Aktiviert einen globalen Meta-Title nach den definierten Bausteinen, falls am Produkt kein eigener Titel hinterlegt ist.
generalMetaDescription	bool	Aktiviert eine globale Meta-Description nach den definierten Bausteinen, falls am Produkt keine Beschreibung hinterlegt ist.
metaTitleForms	list (object)	Reihenfolge von Textbausteinen, aus denen der Meta-Title für Produktseiten generiert wird.
separator	string	Trennzeichen, das vor diesem Baustein eingefügt wird. (z.B. “-“)
termType	enum	Art des Terms. Folgende Werte sind möglich: - productField - verweist auf ein Standardfeld eines Produkts (z.B. name). - customProductField - verweist auf selbst angelegte Produktfelder. - freeText - ein fester Text, frei zu vergebender Text.
termData	oneOf	Daten des Terms - je nach gewähltem termType.
metaDescriptionForms	list (object)	Reihenfolge von Textbausteinen, aus denen die Meta-Description für Produktseiten generiert wird.
separator	string	Trennzeichen, das vor diesem Baustein eingefügt wird. (z.B. “-“)
termType	enum	Art des Terms. Folgende Werte sind möglich: - productField - verweist auf ein Standardfeld eines Produkts (z.B. name). - customProductField - verweist auf selbst angelegte Produktfelder. - freeText - ein fester Text, frei zu vergebender Text.
termData	oneOf	Daten des Terms - je nach gewähltem termType.

---

​

seoMetaData.startPage - Startseite Meta-Daten

Der Knoten seoMetaData.startPage definiert die SEO-Texte für die Startseite. Hier können Meta-Title und Meta-Description hinterlegt werden.

​

Beispielkonfiguration

{
  "metaTitle": "Willkommen im WEBSALE Demo-Shop – Neuheiten & Bestseller",
  "metaDescription": "Jetzt Neuheiten, Bestseller und attraktive Angebote entdecken. Schneller Versand, sichere Zahlung und erstklassiger Service."
}

​

Parameterbeschreibung

Parameter	Typ	Beschreibung
metaTitle	string	SEO-Titel der Startseite (kurz und prägnant, ideal ca. 50-60 Zeichen).
metaDescription	string	SEO-Beschreibung der Startseite (zusammenfassend, ideal ca. 140-160 Zeichen).

---

​

seoMetaData.viewSchemes - Template-Meta-Daten

Der Knoten seoMetaData.viewSchemes definiert, wie Meta-Title und Meta-Description für z.B. Templates automatisch zusammengesetzt werden.

​

Beispielkonfiguration

 {
  "generalMetaDescription": false,
  "generalMetaTitle": false,
  "metaTitleForms": [
    {
      "separator": null,
      "termType": "freeText",
      "termData": { "freeText": "Onlineshop" }
    },
    {
      "separator": " | ",
      "termType": "resourceId",
      "termData": {}
    }
  ],
  "metaDescriptionForms": [
    {
      "separator": null,
      "termType": "freeText",
      "termData": { "freeText": "Infos & Service" }
    },
    {
      "separator": null,
      "termType": "resourceId",
      "termData": {}
    }
  ]
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
generalMetaDescription	bool	Aktiviert eine globale Meta-Description nach den definierten Bausteinen, falls am Produkt keine Beschreibung hinterlegt ist.
generalMetaTitle	bool	Aktiviert einen globalen Meta-Title nach den definierten Bausteinen, falls am Produkt kein eigener Titel hinterlegt ist.
metaTitleForms	list (object)	Reihenfolge von Textbausteinen, aus denen der Meta-Title für Produktseiten generiert wird.
separator	string	Trennzeichen, das vor diesem Baustein eingefügt wird. (z.B. “-“)
termType	enum	Art des Terms. Folgende Werte sind möglich: - resourceId - verweist auf eine Kategorie- oder Produkt-ID. - freeText - ein fester Text, frei zu vergebender Text.
termData	oneOf	Daten des Terms - je nach gewähltem termType.
metaDescriptionForms	list (object)	Reihenfolge von Textbausteinen, aus denen die Meta-Description für Produktseiten generiert wird.
separator	string	Trennzeichen, das vor diesem Baustein eingefügt wird. (z.B. “-“)
termType	enum	Art des Terms. Folgende Werte sind möglich: - resourceId - verweist auf eine Kategorie- oder Produkt-ID. - freeText - ein fester Text, frei zu vergebender Text.
termData	oneOf	Daten des Terms - je nach gewähltem termType.