Universelle Integration

Header Scripts Integration Guide

Das Header-Script bringt Schema.org-Markup in den Kopf deiner Seiten. Es ist der Weg für Shops ohne API, und zusätzlich nutzbar bei Shops, die schon per API verbunden sind.

Universell

Funktioniert mit allen Shop-Systemen

Einfach

Nur ein Code-Snippet einfügen

Sicher

Keine Theme-Änderungen nötig

Zwei Wege, klar getrennt

Per API verbunden

Magento 1 und Magento 2
Wix, Squarespace, PrestaShop
Shopware, BigCommerce, Ecwid, OpenCart

Per Header-Script, ohne API

JTL-Shop, Gambio, OXID eShop
Jedes weitere oder selbst gebaute System

Schritt 1: Plattform auswählen

Wähle deine E-Commerce-Plattform im Libers Suite Dashboard aus.

Dashboard → Shops → Shop hinzufügen
Wähle deine Plattform aus der Dropdown-Liste. Falls deine Plattform nicht aufgeführt ist, wähle "Andere".

Schritt 2: Shop verbinden

Verbinde deinen Shop mit Libers Suite - entweder via API oder manuell.

Option A: Mit API-Zugriff (empfohlen)

Falls deine Plattform eine API bietet, kannst du automatisch Produkte synchronisieren.

Magento 1 und Magento 2: Admin Username + Password Anleitung →
Wix: API Key + Site ID Anleitung →
Squarespace: API Key Anleitung →
BigCommerce: Store Hash + Access Token Anleitung →
PrestaShop: API Key (Webservices aktivieren) Anleitung →
Shopware: API Key + Secret Anleitung →
Ecwid: Store ID + Access Token
OpenCart: API Key

Option B: Ohne API-Zugriff

Falls keine API verfügbar ist, gib einfach deine Shop-URL ein. Du kannst Produkte später manuell importieren.

Header Scripts funktionieren auch ohne API-Zugriff. Du musst nur die Produkte manuell in Libers Suite anlegen.

Schritt 3: Produkte synchronisieren

Importiere deine Produkte in Libers Suite.

A
Mit API:

Klicke auf "Synchronisieren" im Dashboard. Produkte werden automatisch importiert.

B
Ohne API:

Lege Produkte manuell an oder importiere sie via CSV.

Schritt 4: Knowledge Packs generieren

Erstelle AI-optimierte Knowledge Packs für deine Produkte.

1
Gehe zu Dashboard → Products
2
Wähle Produkte aus und klicke auf "Für LLM optimieren"
3
Libers Suite analysiert Produktdaten und generiert optimierte Beschreibungen

Schritt 5: Header-Script aktivieren (WICHTIG)

Aktiviere die Header-Script Veröffentlichung in den Shop-Einstellungen.

  1. Gehe zu Dashboard → Shops
  2. Klicke auf deinen Shop
  3. Scrolle zu "Veröffentlichungs-Einstellungen"
  4. Aktiviere den Toggle "Header-Script"
Was macht das Header-Script?
Es injiziert automatisch Schema.org Markup, Meta-Tags und Open Graph Tags in deine Produktseiten. Crawler sehen die optimierten Daten - deine Kunden sehen die normale Seite.

Schritt 6: Code-Snippet kopieren

Kopiere das generierte JavaScript-Snippet aus dem Dashboard.

Code-Snippet Beispiel:
<script src="https://cdn.libers.ai/llmo-sdk.js"
        data-api-key="your-api-token-will-appear-here">
</script>

Dein persönlicher API-Token wird automatisch generiert

Schritt 7: Code in Shop-Theme einfügen

Füge das Code-Snippet in den <head> Bereich deines Shop-Themes ein.

Plattform-spezifische Anleitungen:

Magento / Adobe Commerce:

Admin → Content → Design → Configuration → HTML Head → Scripts and Style Sheets

Wix:

Settings → Custom Code → Add Custom Code → Head

Squarespace:

Settings → Advanced → Code Injection → Header

BigCommerce:

Storefront → Script Manager → Create a Script → Placement: Head

PrestaShop:

Design → Theme & Logo → Advanced Customization → Custom Code → Header

Shopware:

Theme Manager → Edit Theme → Custom CSS/JS → Add to Head

Andere Plattformen:

Suche in deinem Theme-Editor nach "Custom Code", "Header Scripts" oder "HTML Head"

Wichtig: Das Script muss im <head> Bereich eingefügt werden, nicht im Body. Nur so können die Meta-Tags korrekt ausgegeben werden.

Schritt 8: Verifizierung

Prüfe, ob das Script korrekt funktioniert.

Verifizierungs-Tools:

Seitenquelltext

Rechtsklick auf Produktseite → "Seitenquelltext anzeigen" → Suche nach "llmo-sdk.js"

Google Rich Results Test

search.google.com/test/rich-results

Schema.org Validator

validator.schema.org

Häufige Fragen

Kann ich Header Scripts und API-Integration kombinieren?

Ja! Du kannst beide Methoden gleichzeitig nutzen. API für automatischen Produkt-Sync und Header Scripts für Schema.org Markup Ausgabe.

Beeinflusst das Script die Ladezeit meines Shops?

Nein. Das Script wird asynchron geladen und hat minimalen Overhead (~5KB). Es beeinflusst weder Ladezeit noch User Experience.

Was passiert wenn ich das Script deaktiviere?

Das Schema.org Markup wird nicht mehr ausgegeben. Deine Produkte bleiben in Libers Suite gespeichert und können jederzeit wieder aktiviert werden.

Funktioniert das Script mit jedem Theme?

Ja. Das Script ist Theme-unabhängig und funktioniert mit allen Standard- und Custom-Themes, solange du Zugriff auf den HTML Head hast.