# Theme-Integration und strukturierte Daten

> Die Sphen-Theme-App-Embeds aktivieren, damit dein Shop strukturierte Daten für Produkte, Artikel, Organisation und Breadcrumbs ausgibt, die KI-Engines und Google lesen können.

Kanonische URL: https://sphen.ai/de/help/theme-integration/
Zuletzt aktualisiert: 2026-08-14

## Was der Bereich macht

Sphen liefert seine strukturierten Daten als Shopify-Theme-App-Embeds aus. Einmal aktiviert, gibt dein Storefront JSON-LD für Organization, WebSite, Product, BlogPosting und BreadcrumbList aus, dazu optional einen sichtbaren FAQ-Block mit passenden FAQPage-Daten und optional ein Verweildauer-Signal für deine Blogartikel. In deinem Theme rendert nichts, bevor du die Embeds im Theme-Editor einschaltest — es wird kein Theme-Code bearbeitet, und mit dem Entfernen der App verschwindet die Ausgabe wieder.

### Warum das wichtig ist

Strukturierte Daten sind der Weg, auf dem eine Maschine Preis, Verfügbarkeit, Marke und Bewertungen liest, ohne sie aus HTML zu raten. Es ist außerdem der günstigste Fix in der App: ein Schalter wirkt auf alle Produktseiten gleichzeitig. Bleibt er aus, meldet das Audit weiterhin Lücken bei strukturierten Daten, die es nicht für dich schließen kann.

## Einrichtung

1. Suche in der **Übersicht** die Karte **Strukturierte Daten im Theme aktivieren** und klicke auf **Theme-Editor öffnen**. Unter **Einstellungen → Integrationen** heißt die gleiche Aktion **Im Theme-Editor aktivieren** auf der Karte **Verbindungen & Status**.
2. Öffne im Shopify-Theme-Editor links den Bereich **App-Embeds**. Die Theme-Erweiterung bringt keine deutsche Sprachdatei mit: Embed-Namen und die Kästchen für die Schema-Typen stehen auch bei deutscher Admin-Sprache auf Englisch. Such also nach den englischen Bezeichnungen.
3. Schalte **Sphen Structured Data** ein und aktiviere darin unter **Schema types** die gewünschten Typen: **Organization & WebSite**, **Product**, **Article / BlogPosting**, **Breadcrumbs** und **FAQ schema**.
4. In derselben Liste stehen zwei weitere Embeds. **Sphen FAQs** schaltet den sichtbaren FAQ-Block samt FAQPage-Daten als Ganzes ein oder aus — aktiviere es, wenn du FAQs veröffentlichst. **Sphen Article Dwell** misst, wie lange Leser auf deinen Blogartikeln bleiben; ohne dieses Embed hat die Blog-Analyse nichts zu berichten, aktiviere es also, wenn du Artikel veröffentlichst.
5. Speichere das Theme. Die Embeds gelten nur für dein Live-Theme — wiederhole das nach jeder Veröffentlichung eines neuen Themes.
6. Prüfe zurück in Sphen unter **Einstellungen → Integrationen** auf der Karte **Verbindungen & Status**, dass **Strukturierte Daten (JSON-LD)** auf **Aktiv** steht.
7. Starte ein neues Audit, damit die Empfehlungen zu strukturierten Daten schließen. Siehe [Empfehlungen](/help/recommendations).

## Ergebnisse lesen

Gut sieht so aus: Auf **Verbindungen & Status** steht **Strukturierte Daten (JSON-LD)** auf **Aktiv**, und nach dem nächsten Audit sind die Aktionen zu strukturierten Daten aus deiner offenen Liste verschwunden. Ist der Tab **AI Shopping** für deinen Shop freigeschaltet, schlägt dort der Reife-Check **Strukturierte Daten unvollständig** bei deinen Produkten nicht mehr an.

**Nicht aktiv** heißt: Das Embed ist in deinem Live-Theme aus, und es wird kein JSON-LD ausgegeben — unabhängig davon, was die App sonst anzeigt. **Berechtigung fehlt** heißt, die App kann dein Theme nicht lesen; öffne sie erneut aus dem Shopify-Admin, um den Zugriff neu zu erteilen.

Eine Warnung, die du ernst nehmen solltest: Gibt bereits eine andere App oder dein Theme strukturierte Daten aus, schalte hier die entsprechenden Schema-Schalter ab. Doppeltes JSON-LD verursacht Fehler im Google Merchant Center und kann dich Rich Results kosten — schädlicher, als gar keine zu haben.

## Fehlerbehebung

### Ich habe das Embed aktiviert, der Status steht trotzdem auf nicht aktiv.

Prüfe, ob du das Theme gespeichert und das _veröffentlichte_ Theme bearbeitet hast, nicht einen Entwurf. Lade danach die Sphen-Seite neu — der Status wird aus deinem Live-Theme gelesen.

### Das Google Merchant Center meldet doppelte strukturierte Daten.

Zwei Quellen geben dasselbe Schema aus. Schalte den passenden Schema-Schalter im Embed Sphen Structured Data ab oder deaktiviere die Ausgabe der anderen App. Sphen erzeugt dafür auch eine eigene Empfehlung: **Doppelte strukturierte Daten deaktivieren**.

### FAQs sind freigegeben, im Storefront erscheint nichts.

Der sichtbare FAQ-Block steckt im separaten Embed **Sphen FAQs**. Schalte auch dieses ein; siehe [Inhalte](/help/content).

## Häufige Fragen

### Verändert das Embed meine Theme-Dateien?

Nein. Theme-App-Embeds werden von Shopify beim Rendern eingefügt. Dein Theme-Code bleibt unberührt, und das Abschalten entfernt die Ausgabe sofort.

### Muss ich das nach einem Theme-Wechsel wiederholen?

Ja. App-Embeds gelten pro Theme. Veröffentliche das neue Theme und aktiviere die Embeds dort — die App weist erneut darauf hin, sobald sie ein inaktives Embed erkennt.

### Bremst das mein Storefront aus?

Die Embeds geben JSON-LD-Skriptblöcke aus und, falls aktiviert, einen FAQ-Block. Es gibt kein externes Skript und keine renderblockierende Ressource.

## Noch offene Fragen?

Der Support beantwortet Fragen zu Installation, Katalog-Synchronisation, Audits, Abrechnung, Datenschutz und Konto für die SPHEN.AI Shopify-App. https://sphen.ai/support/