--- title: "Das App-Embed einschalten und den Aktivierungsstatus prüfen" description: "Aktivieren Sie das QuotWay-App-Embed in Ihrem Theme und lesen Sie das Aktivierungsstatus-Panel, damit jede Shop-Oberfläche als live angezeigt wird." url: "https://www.quotway.com/de/docs/storefront/app-embed-and-activation" type: "documentation" category: "storefront" updated: "2026-06-20" locale: "de" source: "QuotWay - B2B Quote & Negotiation App for Shopify" --- # Das App-Embed einschalten und den Aktivierungsstatus prüfen **Lesezeit:** 5 Minuten. **Zuletzt aktualisiert:** 20. Juni 2026 **Für wen:** Händler, deren **Angebot anfragen**-Button noch nicht erscheint, und alle, die QuotWay zum ersten Mal einrichten und bestätigen wollen, dass jede Shop-Oberfläche live ist. Bevor irgendein QuotWay-Button in Ihrem Shop erscheint, müssen zwei Dinge stimmen: Das **App-Embed** ist in Ihrem Theme aktiviert, und die gewünschten Blöcke sind platziert. Das App-Embed ist die Laufzeit – es lädt das QuotWay-Shop-Skript, damit Buttons, das Angebots-Panel und das Ausblenden von Preisen funktionieren können. Dieser Artikel zeigt, wie Sie das Embed einschalten, das Panel **Aktivierungsstatus** lesen und verstehen, was „Platziert“ und „Aktiv“ für jede Oberfläche bedeuten. Erscheint Ihr Button nicht, beginnen Sie hier – es ist die häufigste Lösung. ## Was Sie erreichen Am Ende ist das App-Embed an, das Aktivierungsstatus-Panel zeigt Grün für die Oberflächen, die Sie nutzen, und Sie wissen, wie Sie nach jeder Änderung erneut prüfen. ## Bevor Sie starten - QuotWay ist in Ihrem Shopify-Admin installiert. - Sie nutzen ein Online-Store-2.0-Theme (Dawn, Horizon und die meisten modernen Themes erfüllen die Voraussetzungen). Das App-Embed schalten Sie im Theme-Editor ein – ohne Theme-Code zu bearbeiten. ## Schritt 1 – Das App-Embed einschalten 1. Öffnen Sie in Ihrem QuotWay-Admin **Einstellungen → Aktivierung** und wählen Sie **App-Embed aktivieren**. (Oder gehen Sie zu **Shopify-Admin → Onlineshop → Themes → Anpassen → App-Embeds**.) 2. Suchen Sie im Panel **App-Embeds** des Theme-Editors **QuotWay** und legen Sie seinen Schalter um. 3. Wählen Sie **Speichern**. Das App-Embed lädt einmal je Shop-Seite. Ist es aus, rendert nirgends ein QuotWay-Button oder -Panel, ganz gleich wie Ihre Blöcke platziert sind – deshalb ist das immer das Erste, was Sie prüfen sollten. ## Schritt 2 – Das Aktivierungsstatus-Panel lesen Öffnen Sie **Einstellungen → Aktivierung** in Ihrem QuotWay-Admin. Die Tabelle **Oberflächen** listet jeden Ort, an dem QuotWay erscheinen kann, jeweils mit einem Live-Status-Abzeichen und, wo noch etwas zu tun ist, einer Einrichtungsaktion. QuotWay prüft Ihr veröffentlichtes Theme in Echtzeit, die Abzeichen spiegeln also, was tatsächlich live ist – nicht, was Sie vorhatten. | Oberfläche | Was der Status bedeutet | | --- | --- | | **App-Embed** | **Aktiviert** (grün) heißt, die Laufzeit ist in Ihrem veröffentlichten Theme geladen. **Deaktiviert** (gelb) heißt: einschalten – vorher funktioniert nichts anderes. | | **Angebots-Button-Block (Produktseite)** | **Platziert** (grün) heißt, der Block **QuotWay Quote Button** ist in Ihrer Produktvorlage. **Nicht platziert** (gelb) zeigt die Aktion **Angebots-Button hinzufügen**. | | **Warenkorb-Angebotsblock (Warenkorbseite)** | **Platziert** (grün) heißt, der Block **QuotWay Cart Quote Button** ist in Ihrer Warenkorbvorlage. **Nicht platziert (optional)** (neutral) – der Block auf der Warenkorbseite ist optional, deshalb bleibt das neutral und wird keine Warnung. | | **Kundenkonto-UI-Erweiterung** | **Aktiv** (grün), wenn der Block **Meine Angebote** in den neuen Kundenkonten platziert ist. Nutzt Ihr Shop neue Kundenkonten, ist der Block aber noch nicht platziert, sehen Sie eine Aktion zum Abschließen der Einrichtung; ältere Konten leiten Käufer stattdessen ins gehostete Portal. | | **Gehostetes Portal** | **Konfiguriert** (grün) – immer verfügbar. Käufer erreichen ihr Angebot über einen sicheren Link, ganz ohne Einrichtung. | | **Bereitschaft des Käuferwegs** | Eine Zusammenfassung: **Bereit** (grün), sobald das App-Embed an **und** der Angebots-Button-Block auf der Produktseite platziert ist – das Minimum, damit ein Käufer aus Ihrem Shop ein Angebot anfragen kann. | ### Was „Platziert“ und „Aktiv“ bedeuten - **Aktiv / Aktiviert** beschreibt das **App-Embed** – die Laufzeit ist eingeschaltet und in Ihrem Theme geladen. - **Platziert** beschreibt einen **Block** – Sie haben ihn im Theme-Editor zu einer Vorlage hinzugefügt und gespeichert. - Eine Oberfläche ist erst vollständig grün, wenn beides zutrifft: Für den Produkt-Button muss das Embed **Aktiviert** und der Block **Platziert** sein. Der Button im Warenkorb-Panel (Drawer) und der Button auf Produktkacheln erscheinen in dieser Tabelle nicht als eigene „Platziert“-Zeilen – sie werden vom App-Embed automatisch eingefügt (Panels und Kacheln können keine Theme-Blöcke aufnehmen), es gibt also nichts zu platzieren. Siehe [Angebots-Button im Warenkorb und Mini-Warenkorb](./cart-and-mini-cart-button.md). ## Schritt 3 – Nach einer Änderung erneut prüfen Das Panel prüft Ihr Theme automatisch erneut, sobald Sie zum QuotWay-Tab oder -Fenster zurückwechseln – der übliche Ablauf ist also: Theme-Editor in einem neuen Tab öffnen, Änderung vornehmen, zurückwechseln und zusehen, wie das Abzeichen grün wird. Wirkt ein Abzeichen veraltet, nachdem Sie die Einrichtung Ihres Shops geändert haben (zum Beispiel Shopify B2B nach der Installation aktiviert), nutzen Sie **Einstellungen → Aktivierung → Erneut prüfen**, damit QuotWay Ihren Shop neu erkennt und jede Oberfläche aktualisiert. ## Häufige Stolpersteine - **Alles ist gelb und kein Button erscheint.** Das App-Embed ist aus. Schalten Sie es ein (Schritt 1) – es steuert jede andere Oberfläche. - **Das Embed ist an, aber der Produkt-Button ist „Nicht platziert“.** Fügen Sie den Block **QuotWay Quote Button** zu Ihrer Produktvorlage hinzu. Siehe [Platzierung des Angebots-Buttons](./quote-button-placement.md). - **Eine Oberfläche ist grün, aber Käufer sehen den Button trotzdem nicht.** Der Button erscheint nur bei Produkten und Käufern, die zu einer aktiven Targeting-Regel passen. Prüfen Sie Ihre Regeln. Siehe [Targeting-Regeln](../targeting/targeting-rules.md). - **Das Abzeichen hat sich nach einer Theme-Änderung nicht aktualisiert.** Das Panel aktualisiert sich, wenn Sie zum Tab zurückkehren; ist es weiterhin veraltet, nutzen Sie **Erneut prüfen**. ## Verwandte Artikel - [Platzierung des Angebots-Buttons](./quote-button-placement.md) – die Produkt- und Warenkorbblöcke im Theme-Editor hinzufügen. - [Angebots-Button im Warenkorb und Mini-Warenkorb](./cart-and-mini-cart-button.md) – der Block auf der Warenkorbseite und der automatisch eingefügte Panel-Button. - [Targeting-Regeln](../targeting/targeting-rules.md) – entscheiden, welche Produkte und Käufer den Button sehen, sobald alles aktiv ist.