Documentation menu

Store-native Rabattcode-Prägung

MailInApp unterstützt dynamische Store-native Rabattcode-Prägung für verbundene Shopify- und WooCommerce-Shops.

Statt Käufer durch einen Checkout eines Drittanbieters oder generische öffentliche Gutscheine zu schicken, prägt MailInApp beim Versand automatisch einmalige, auf den Kunden beschränkte Rabattcodes direkt in Ihrem Shop — über einen von zwei unabhängigen Mechanismen, die ein einzelnes Projekt zusammen, getrennt oder gar nicht nutzen kann:

  • Rabattangebot auf Projektebene — eine Einstellung auf der Versand-Seite, die pro passendem Empfänger einen Code prägt, entweder für Ihren gesamten Shop oder für ein aus einem Dropdown gewähltes Produkt gültig, gedacht zur Kombination mit einem Kaufhistorie-Zielgruppensegment. Siehe Rabattangebot.
  • Rabatt pro Produkt am Produkt-Block — ein Schalter direkt am Studio-Produkt-Block, gültig für genau den Artikel, den dieser Block aus Ihrem Katalog importiert hat, ohne dass ein Zielgruppenfilter oder eine Einrichtung auf der Versand-Seite nötig wäre. Von Anfang bis Ende durchgegangen in Shopify-Produktrabattcodes und WooCommerce-Produktrabattcodes.

Beide prägen über dieselbe zugrunde liegende Shop-Verbindung und teilen sich die untenstehenden Mechanismen; ein Rabatt pro Produkt beschränkt den Code lediglich zusätzlich auf einen Artikel und führt seine eigene Cooldown-Markierung, getrennt von der des Rabattangebots auf Projektebene und der jedes anderen Produkt-Blocks.


Wie es funktioniert

Wenn eine Kampagne oder Journey ein Rabattangebot enthält:

  1. Dynamische Kundenauflösung:
    • Shopify: Löst die Customer-GraphQL-ID des Empfängers (gid://shopify/Customer/...) über die Admin-GraphQL-API auf, bevor der Rabatt-Knoten erzeugt wird.
    • WooCommerce: Beschränkt den erzeugten Gutschein über die WooCommerce REST API auf die exakte E-Mail-Adresse des Empfängers.
  2. Einmalig & sicher:
    • Codes tragen zufällige kryptografische Suffixe (z. B. MIA-7F3A91B2).
    • Jeder Code ist auf eine einzige Nutzung beschränkt (usage_limit: 1) und ausschließlich an die E-Mail-Adresse des Empfängers gebunden, was ein Durchsickern von Gutscheinen auf Deal-Seiten verhindert.
  3. Optionale Produktbeschränkung:
    • Ein shopweit geprägter Code gilt für jeden Kauf. Einer, der auf ein Produkt beschränkt ist — über den eigenen Geltungsbereich-Auswahldialog des Rabattangebots auf Projektebene, oder den Rabatt pro Produkt eines Produkt-Blocks — ist auf genau diesen Artikel beschränkt: bei Shopify über customerGets.items.products.productsToAdd mit einer echten Produkt-GID, bei WooCommerce über das Feld product_ids des Gutscheins.
  4. Vorab angewendet beim Shop-Checkout:
    • Der Link eines shopweiten oder projektweiten Codes wendet ihn an Ihrem generischen Checkout an (/cart/?coupon=MIA-... bei WooCommerce, /discount/MIA-... mit Weiterleitung auf / bei Shopify).
    • Der eigene Rabatt pro Produkt eines Produkt-Blocks führt den Käufer stattdessen direkt zurück auf die eigene Seite dieses Produkts, mit bereits angewendetem Code (?coupon=MIA-... an die Produkt-URL angehängt bei WooCommerce; /discount/MIA-...?redirect=<product path> bei Shopify) — nicht auf die Startseite des Shops, da die E-Mail auf ein bestimmtes Produkt verwiesen hat.
  5. Sichtbar, bevor der Käufer durchklickt:
    • Die Studio-Arbeitsfläche zeigt in dem Moment, in dem Sie den Rabatt pro Produkt eines Produkt-Blocks einschalten, dasselbe Rabatt-Badge und den durchgestrichenen Preis wie die versendete E-Mail und die Live-Ansicht — Sie müssen die Live-Ansicht nicht öffnen, um es zu prüfen.
    • Für Shopify-Shops zeigt ein optionaler MailInApp-Rabatt-Badge-App-Block dasselbe Badge direkt auf der echten Produktseite für einen Käufer, der von der E-Mail aus durchgeklickt hat, noch vor dem Checkout — Einrichtung siehe Den Rabatt auf Ihrer Produktseite anzeigen (Shopify) weiter unten. Für WooCommerce gibt es kein Äquivalent — WooCommerce-Gutscheine haben keinen Mechanismus, um zu ändern, was eine Produktseite selbst anzeigt.

Den Rabatt auf Ihrer Produktseite anzeigen (Shopify)

Die Studio-Arbeitsfläche zeigt das Rabatt-Badge und den durchgestrichenen Preis bereits in dem Moment, in dem Sie den Rabatt pro Produkt eines Produkt-Blocks einschalten — keine Einrichtung nötig. Dasselbe Badge auf Ihrer echten Shopify-Storefront anzuzeigen ist ein einmaliger, manueller Schritt pro Shop, da MailInApp Ihr Theme nie automatisch bearbeitet:

  1. Gehen Sie im Shopify-Adminbereich zu Online-Shop → Themes und klicken Sie bei Ihrem Live-Theme (oder einem Entwurf) auf Anpassen.
  2. Stellen Sie die Seitenauswahl oben auf eine Produkt-Seite um.
  3. Klicken Sie in die Sektion, die den Preis/Kaufen-Button zeigt — meist Produktinformationen oder Kaufen-Buttons.
  4. Klicken Sie innerhalb dieser Sektion auf Block hinzufügen (nicht „Sektion hinzufügen") und wählen Sie unter Apps MailInApp discount badge.
  5. Ziehen Sie es neben den Preis, passen Sie optional seine Badge-Farben im Einstellungsbereich an und klicken Sie dann auf Speichern.

Falls Apps in der Block-Auswahl dieser Sektion nicht erscheint, hat diese Sektion App-Blöcke noch nicht aktiviert — versuchen Sie eine andere Sektion, oder bitten Sie Ihren Theme-Entwickler, {"type": "@app"} zu ihrem Schema hinzuzufügen. Die meisten Online Store 2.0-Themes (Dawn und seine Forks) unterstützen dies bereits in der Haupt-Produktsektion. Erfordert ein Online Store 2.0-Theme.

Das Badge bleibt bei einem gewöhnlichen Storefront-Besuch bewusst unsichtbar — es wird nur gerendert, wenn die Produktseite mit dem signierten Link geladen wird, den eine echte Rabatt-pro-Produkt-E-Mail erzeugt. Wenn Sie also selbst zur Seite navigieren, sehen Sie es nicht, und auch Test senden zeigt es nicht (das rendert die E-Mail direkt und überspringt den Rabatt-Prägeschritt, der den Link des Badges signiert). Um es tatsächlich zu sehen, versenden Sie echt an einen Empfänger — auch nur an sich selbst — und klicken Sie in der zugestellten E-Mail auf Jetzt kaufen. Es ist eine reine Anzeigevorschau, berechnet aus dem eigenen Preis des Produkts; der echte Rabatt wird in jedem Fall erst beim Checkout über den einmaligen Code angewendet.


Unterstützte Angebotstypen

  • Prozentualer Rabatt: z. B. 15 % oder 20 % Rabatt shopweit, für eine Kollektion oder ein einzelnes Produkt.
  • Fester Rabattbetrag: z. B. 10 $ oder 25 $ Rabatt auf den gesamten Warenkorbwert oder auf ein Produkt.
  • Ablauffenster: Codes tragen ein automatisch berechnetes Ablaufdatum (z. B. 7 oder 14 Tage nach Versandzeitpunkt), sodass Dringlichkeit im Shop des Händlers durchgesetzt wird.
  • Konto-Cooldowns: Eingebaute Cooldown-Markierungen verhindern eine Übercouponierung desselben Kontakts über mehrere Zeitpläne oder Projekte hinweg — eine Markierung für das Rabattangebot auf Projektebene und eine separate pro Produkt-Block, sodass ein Rabatt auf ein Produkt nie den Cooldown eines anderen oder den des Rabattangebots auf Projektebene blockiert.

Einrichtung & API-Integration

  • Shopify: Erfordert verbundene Shop-Zugangsdaten mit dem Berechtigungsbereich write_discounts (wird bei der OAuth-Verbindung erledigt).
  • WooCommerce: Erfordert einen verbundenen Shop-REST-API-Consumer-Key und -Secret mit Lese-/Schreibrechten.

Der Rabatt pro Produkt eines Produkt-Blocks erfordert zusätzlich, dass dieser Block ein echtes Produkt über seinen Auswahldialog Aus Shop importieren importiert hat (keine handgetippte externe URL) — das Prägen benötigt die numerische Produkt-ID Ihres Shops, um den Code darauf zu beschränken.