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. Die App fragt Shopify jedes Mal neu, wenn du zu ihrem Tab zurückkehrst, deshalb musst du meist nichts neu laden. 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

Zuerst fragt sie Shopify. Die App fragt Shopify, ob das App embed Promotions in deinem veröffentlichten Theme an ist. Shopifys Antwort hängt nicht von deinem Onlineshop ab — eine Passwortseite ändert nichts daran —, und die App fragt erneut, sobald du zu ihrem Tab zurückkehrst, zum Beispiel nachdem du das Theme im Theme-Editor gespeichert hast.

Ersatzweg: eigene Prüfungen. Nur wenn Shopify keine klare Antwort (an oder aus) gibt, greift die App auf zwei eigene Prüfungen zurück, die einander stützen.

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.

Dieser Ersatzweg wird beim Laden der Seite ermittelt, lade in diesem Fall also die App neu, um erneut zu prüfen. Bei einem passwortgeschützten Onlineshop kann der Ersatzweg die Markierung nicht lesen, die Rückmeldung ist dann sein einziges Signal: Öffne deinen Onlineshop einmal mit eingeschaltetem App embed und lade danach die App neu.

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. Shopifys Antwort bezieht sich auf dein veröffentlichtes Theme, und der Ersatzweg liest deinen veröffentlichten Onlineshop.
Änderungen brauchen einen Moment, bis sie erscheinen. Änderungen erreichen deinen Shop meist innerhalb einer Minute; auf manchen Seiten kann es länger dauern, selten über eine halbe Stunde.