App embed

De app embed (app-insluiting) van DiscountOS is één schakelaar in je thema-editor. Staat hij aan, dan kan de app dingen op je webshop tekenen: Sale Badges (kortingsbadges), Price Drops (verlaagde prijzen) en het cadeau dat automatisch in de winkelwagen komt bij een korting met cadeau bij aankoop. Staat hij uit, dan tonen die drie niets — je kortingen gelden gewoon, dus kopers krijgen het geld nog steeds.

Instellen

Open Promotions in de DiscountOS-app.

In de zijbalk van je Shopify-beheercentrum heeft DiscountOS onder Apps drie items: Manage discounts, Block codes en Promotions (Beta).
Klik op Enable in theme editor.

Zolang de embed uit staat, toont de pagina Promotions een kaart App embed met de tekst “Sale Badges and Price Drops need the app embed enabled in your theme”, met een knop Enable in theme editor. Die knop opent je thema-editor meteen op het paneel met app embeds.

Op de pagina van een promotie zelf staat dezelfde status in de rechterkolom als een vaste rij App embed met een knop Enable of Disable.
Zet de app embed Promotions aan en sla het thema op.

Zet in het paneel App embeds van de thema-editor Promotions aan en klik op Save.

Zet hem aan in het thema dat je hebt gepubliceerd. Een app embed die alleen in een niet gepubliceerd thema of een concept aan staat, bereikt geen kopers, en de app telt hem niet mee.
Ga terug naar de app en controleer of de status op Enabled staat.

De statusbadge naast App embed verandert in Enabled. Zolang de app het antwoord nog aan het uitzoeken is, toont hij een laadindicator in plaats van een badge.

Instellingen

De app embed heeft twee eigen instellingen, in de thema-editor, onder de kop Free gift. Ze doen er alleen toe als je een korting met cadeau bij aankoop draait.

Refresh cart pages after gift changes

Staat standaard aan. Nadat de app een cadeau toevoegt of weghaalt, laadt de winkelwagenpagina opnieuw zodat je thema de nieuwe winkelwagen toont. Zet dit alleen uit als je thema zijn winkelwagen bijwerkt zonder herladen — de notitie bij de instelling zelf zegt dat de pagina, als dit uit staat, na cadeauwijzigingen nooit ververst, dus combineer het met het event hieronder of kopers zien mogelijk verouderde cadeauregels tot hun volgende handeling.

Custom cart update event

Optioneel. De naam van het verversingsevent voor de winkelwagen van je thema. De app vuurt het af na cadeauwijzigingen, zodat het thema zijn winkelwagen ter plekke kan bijwerken in plaats van te herladen.

Hoe de app de status bepaalt

Twee dingen vertellen de app of de embed aan staat, en ze dekken elkaar af.

De controle op de webshop. De app opent de homepage van je webshop en zoekt naar de markering die Shopify voor elke ingeschakelde app embed in de pagina zet. Dat is een definitief antwoord, aan of uit, en het kost je niets — het is dezelfde openbare pagina die een koper ziet. De app leest hem hooguit één keer per minuut per winkel opnieuw.

Het bericht van de embed zelf. Als de embed draait, meldt hij zich — vanaf je gepubliceerde webshop, en vanaf de voorbeeldweergave in de thema-editor op het moment dat je hem aanzet. Daarom springt de status meestal binnen een paar tellen na het opslaan van je thema op Enabled.

De twee worden gecombineerd:

Markering gevonden → Enabled.
Markering ontbreekt, maar de embed meldde zich in de laatste 10 minuten → Enabled. Een live melding is de embed die echt draait, en dat weegt zwaarder dan een pagina die de markering niet toonde.
Markering ontbreekt en geen recente melding → Not enabled.
De app kon de pagina helemaal niet lezen — je webshop is met een wachtwoord beveiligd, of er trad een time-out op → dan beslissen de meldingen op eigen kracht: een melding in de laatste 48 uur telt als Enabled, en zonder melding blijft de status onbekend en blijft de app controleren.

Bij een met een wachtwoord beveiligde webshop kan de app de markering niet lezen, dus is de melding het enige signaal. Open je webshop één keer met de embed aan en laad daarna de app opnieuw. Tot dat gebeurt, kan de status achterlopen op wat je thema al heeft.

Limieten en aandachtspunten

De vier widgetblokken hebben de embed niet nodig. Quantity Break Table, Quantity Break Picker, Spend More Save More en Cart Goal Bar zijn themablokken die je in een sectie plaatst; elk daarvan rendert op eigen kracht. Zie Widgets voor je webshop.
De embed uitzetten stopt nooit een korting. Shopify controleert de winkelwagen nog steeds en past de korting nog steeds toe. Wat stopt is de weergave: badges, doorgestreepte prijzen en het cadeau dat voor de koper in de winkelwagen wordt gelegd. Bij een korting met cadeau bij aankoop kunnen kopers het cadeau nog steeds zelf toevoegen en wordt het nog steeds gratis.
Het gepubliceerde thema is wat telt. De app leest je gepubliceerde webshop.
Wijzigingen zijn er niet meteen. Promoties bereiken je winkel meestal binnen een minuut, soms pas na 15 minuten.

Verwant

Sale Badge — een badge als “20% off” op je productafbeeldingen.
Price Drop — de oude prijs doorgestreept naast de prijs met korting.
Cadeau bij aankoop — de korting waarvan de embed het cadeau in de winkelwagen legt.
App embed lijkt uitgeschakeld — wat te doen als de schakelaar aan staat maar de app van niet zegt.