seoMetaData - Meta-Daten & Seo-Texte

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 `seperator` aneinandergefügt.
`seperator`	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 `termData`definiert 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.CategoryFields`.
`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`.
`seperator`	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 `termData`definiert 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.CategoryFields`.
`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	Metal-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.
`seperator`	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.
`seperator`	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 Starseite. 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.viewSchemesdefiniert, 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`.

Konfiguration

Documentation Index

​seoMetaData* - Grundstruktur

​seoMetaData.categorySchemes - Kategorie-Meta-Daten

​seoMetaData.generalSchemes - Allgemeines SEO-Schema

​seoMetaData.productSchemes - Produkt-Meta-Daten

​seoMetaData.startPage - Startseite Meta-Daten

​seoMetaData.viewSchemes - Template-Meta-Daten

`seoMetaData*` - Grundstruktur

`seoMetaData.categorySchemes` - Kategorie-Meta-Daten

`seoMetaData.generalSchemes` - Allgemeines SEO-Schema

`seoMetaData.productSchemes` - Produkt-Meta-Daten

`seoMetaData.startPage` - Startseite Meta-Daten

`seoMetaData.viewSchemes` - Template-Meta-Daten