App embed

Das App embed („App-Einbettung“) von DiscountOS ist ein einziger Schalter in deinem Theme-Editor. Ist er an, kann die App Dinge in deinen Onlineshop zeichnen: Sale Badges, Price Drops und das automatisch in den Warenkorb gelegte Geschenk bei einem Rabatt „Geschenk zum Kauf“. Ist er aus, zeigen diese drei nichts — deine Rabatte greifen weiterhin, Käufer bekommen das Geld also trotzdem.

Einrichtung

Öffne Promotions in der DiscountOS-App.

In der Seitenleiste des Shopify-Adminbereichs hat DiscountOS unter Apps drei Einträge: Manage discounts, Block codes und Promotions (Beta).
Klicke auf Enable in theme editor.

Solange das App embed aus ist, zeigt die Seite Promotions eine Karte App embed mit dem Text “Sale Badges and Price Drops need the app embed enabled in your theme” und einer Schaltfläche Enable in theme editor. Die Schaltfläche öffnet deinen Theme-Editor direkt beim App-embeds-Panel.

Auf der Seite einer einzelnen Promotion steht derselbe Status in der rechten Spalte als dauerhafte Zeile App embed mit einer Schaltfläche Enable oder Disable.
Schalte das App embed Promotions ein und speichere das Theme.

Schalte im Panel App embeds des Theme-Editors Promotions ein und klicke auf Save.

Schalte es in dem Theme ein, das du veröffentlicht hast. Ein App embed, das nur in einem unveröffentlichten Theme oder einem Entwurf aktiviert ist, erreicht keine Käufer, und die App zählt es nicht.
Geh zurück in die App und prüfe, ob der Status Enabled lautet.

Das Status-Badge neben App embed wechselt auf Enabled. Solange die App die Antwort noch ermittelt, zeigt sie statt eines Badges eine Ladeanzeige.

Einstellungen

Das App embed hat zwei eigene Einstellungen, im Theme-Editor, unter der Überschrift Free gift. Sie spielen nur eine Rolle, wenn du einen Rabatt „Geschenk zum Kauf“ betreibst.

Refresh cart pages after gift changes

Standardmäßig an. Nachdem die App ein Geschenk hinzugefügt oder entfernt hat, lädt die Warenkorbseite neu, damit dein Theme den neuen Warenkorb zeigt. Schalte es nur aus, wenn dein Theme seinen Warenkorb ohne Neuladen aktualisiert — der Hinweis der Einstellung selbst sagt, dass die Seite bei ausgeschalteter Option nach Geschenkänderungen nie aktualisiert wird, kombiniere es also mit dem Event unten, sonst sehen Käufer womöglich veraltete Geschenkpositionen bis zu ihrer nächsten Interaktion.

Custom cart update event

Optional. Der Name des Warenkorb-Aktualisierungs-Events deines Themes. Die App löst es nach Geschenkänderungen aus, damit das Theme seinen Warenkorb an Ort und Stelle aktualisieren kann, statt neu zu laden.

Wie die App den Status ermittelt

Zwei Dinge sagen der App, ob das App embed an ist, und sie stützen einander.

Die Prüfung des Onlineshops. Die App öffnet die Startseite deines Onlineshops und sucht nach der Markierung, die Shopify für jedes aktivierte App embed in die Seite schreibt. Das ist eine eindeutige Antwort, an oder aus, und sie kostet dich nichts — es ist dieselbe öffentliche Seite, die auch ein Käufer sieht. Die App liest sie höchstens einmal pro Minute und Shop erneut.

Die Rückmeldung des App embed. Wenn das App embed läuft, meldet es sich — aus deinem veröffentlichten Onlineshop und aus der Vorschau des Theme-Editors in dem Moment, in dem du es einschaltest. Deshalb springt der Status meist binnen Augenblicken nach dem Speichern des Themes auf Enabled.

Beides wird kombiniert:

Markierung gefunden → Enabled.
Markierung fehlt, aber das App embed hat sich in den letzten 10 Minuten gemeldet → Enabled. Eine Live-Rückmeldung ist das App embed, das tatsächlich läuft, und das wiegt schwerer als eine Seite, die die Markierung nicht zeigte.
Markierung fehlt und keine frische Rückmeldung → Not enabled.
Die App konnte die Seite überhaupt nicht lesen — dein Onlineshop ist passwortgeschützt, oder die Anfrage lief in eine Zeitüberschreitung → dann entscheiden die Rückmeldungen allein: eine Rückmeldung aus den letzten 48 Stunden gilt als Enabled, und ohne Rückmeldung bleibt der Status unbekannt und die App prüft weiter.

Bei einem passwortgeschützten Onlineshop kann die App die Markierung nicht lesen, die Rückmeldung ist dann das einzige Signal. Öffne deinen Onlineshop einmal mit eingeschaltetem App embed und lade danach die App neu. Bis das passiert, kann der Status hinter dem zurückhängen, was dein Theme längst hat.

Limits und Hinweise

Die vier Widget-Blöcke brauchen das App embed nicht. Quantity Break Table, Quantity Break Picker, Spend More Save More und Cart Goal Bar sind Theme-Blöcke, die du in einer Sektion platzierst; jeder rendert von selbst. Siehe Storefront-Widgets.
Das App embed auszuschalten stoppt nie einen Rabatt. Shopify prüft weiterhin den Warenkorb und wendet den Rabatt weiterhin an. Was stoppt, ist die Anzeige: Badges, durchgestrichene Preise und das Geschenk, das dem Käufer in den Warenkorb gelegt wird. Bei einem Rabatt „Geschenk zum Kauf“ können Käufer das Geschenk weiterhin selbst hinzufügen, und es wird weiterhin kostenlos.
Was zählt, ist das veröffentlichte Theme. Die App liest deinen veröffentlichten Onlineshop.
Änderungen brauchen einen Moment, bis sie erscheinen. Promotions erreichen deinen Shop meist innerhalb einer Minute, manchmal bis zu 15.