Documentation menu

Shopify

Verbinden Sie einen Shopify-Shop, um dessen Kunden in eine MailInApp-Kontaktliste zu synchronisieren, Journeys anhand echter Shop-Ereignisse auszulösen und Umsatz auf eine Kampagne oder Variante zurückzuführen.

Ihren Shop verbinden

Geben Sie unter Einstellungen → Integrationen die myshopify.com-Domain Ihres Shops ein und klicken Sie auf Shopify verbinden. Sie werden durch Shopifys eigenen OAuth-Bildschirm geführt, um den Zugriff zu genehmigen. MailInApp fordert read_customers, read_orders und read_products an (alle nur lesend) sowie write_discounts, damit die unten beschriebenen Einmal-Rabattcodes geprägt werden können — es fragt nie nach Schreibzugriff auf die Produkte, Bestellungen oder Kunden Ihres Shops selbst. Nach der Genehmigung erstellt MailInApp eine eigene Kontaktliste für den Shop und startet im Hintergrund einen anfänglichen Kunden-Backfill, gedeckelt auf 5.000 Kunden pro Verbindung. Ein Shop mit mehr Kunden als diesem Limit lässt seine Liste über Shopifys eigene Webhooks weiterwachsen, nur eben ohne einmaligen Backfill über die Obergrenze hinaus.

Installieren Sie direkt aus dem Shopify App Store heraus, bevor Sie je ein MailInApp-Konto erstellt haben, richtet MailInApp automatisch eines für Sie ein, unter Verwendung der eigenen E-Mail-Adresse Ihres Shops — Sie landen angemeldet, mit dem Shop bereits verbunden.

Das Verbinden von Shopify ist eine einmalige Gebühr von 30 $, einmalig über Shopifys eigene Billing API im Rahmen dieses Ablaufs abgerechnet, verfügbar auf jedem Tarif (einschließlich Free). Sie ist nicht erstattungsfähig, wenn Sie die App später deinstallieren — ein späteres erneutes Verbinden auf demselben MailInApp-Konto ist jedoch kostenlos.

Was es leistet

  • Kundensynchronisierung — Shopify-Kunden landen in einer Kontaktliste, die dieser Integration zugeordnet ist, und werden danach über Shopifys eigene Webhooks (customers/create, plus checkouts/create und orders/paid für die untenstehenden Trigger) aktuell gehalten statt durch periodisches erneutes Abfragen.
  • Journey-Trigger — ein verbundener Shop kann den Warenkorb abgebrochen-Trigger einer Journey (ein begonnener, aber nicht abgeschlossener Checkout) sowie deren Kauf-Trigger (eine bezahlte Bestellung) auslösen, sodass eine Willkommensserie oder eine Automatisierung für abgebrochene Warenkörbe auf echter Shopify-Aktivität laufen kann, statt nur auf MailInApps eigenem Produkt-Block-Checkout. Siehe Journeys.
  • Umsatzattribution — die eigene Kampagne/Variante einer Bestellung fließt, wo identifizierbar, in dieselben Antwort- und A/B-Test-Umsatzzahlen ein, die ein nativer Checkout-Auftrag bereits erzeugt.
  • Kaufhistorien-Segmente & Rabattangebote — Bestellpositionen synchronisieren zusammen mit den Kunden, sodass ein Zielgruppenfilter „Produkt X zwischen Datum A und B gekauft“ abgleichen kann (siehe Kaufhistorie), und ein Projekt kann pro passendem Empfänger einen einmaligen Shopify-Rabattcode prägen, der beim eigenen Shop-Checkout eingelöst wird (siehe Rabattangebot). Laufende Bestellungen synchronisieren automatisch über den orders/paid-Webhook; ein Shop, der vor der Einführung dieser Funktion verbunden wurde, oder mit älterer Historie, benötigt einen einmaligen Bestellhistorie nachladen-Abruf unter Einstellungen → Integrationen — gedeckelt auf ungefähr die letzten 60 Tage, sofern Shopify diese App nicht separat für die vollständige Bestellhistorie Ihres Shops freigegeben hat. Ein aus Ihrem Katalog importierter Produkt-Block kann unabhängig davon seinen eigenen Rabatt pro Produkt prägen — beschränkt auf genau diesen Artikel, ohne dass ein Zielgruppenfilter nötig ist — siehe Store-native Rabatte und Shopify-Produktrabattcodes.
  • Produktkatalog für das Studio — auch die eigenen aktiven Angebote Ihres Shops synchronisieren in MailInApp, automatisch im selben Rhythmus wie die Kunden aktualisiert (kein separater Button). Der Auswahldialog Aus Shop importieren des Produkt-Blocks durchsucht diesen synchronisierten Katalog und befüllt Name, Beschreibung, Bild und Preis eines Blocks anhand eines echten Produkts — eine einmalige Kopie, keine Live-Verknüpfung, sodass sich an einer gesendeten E-Mail nie etwas von dem unterscheiden kann, was Sie geprüft haben. Außerdem synchronisiert es die eigene Seite jedes Produkts (aus seinem Shopify-Handle) und stellt den Block, sofern verfügbar, auf Mit externem Shop-Checkout verknüpfen um, direkt darauf zeigend — sodass ein importiertes Produkt sofort verkaufsbereit auf Ihrem Shopify-Shop ist, ohne dass noch etwas zu konfigurieren wäre; schalten Sie manuell zurück auf MailInApp-Checkout, falls Sie die Zahlung lieber über Ihr verbundenes Stripe-Konto abwickeln möchten. Ein vor dieser Einführung verbundener Shop benötigt ein kurzes Trennen und dann Shopify verbinden, um die neue, von Shopify benötigte Berechtigung read_products zu erteilen — bis dahin zeigt der Auswahldialog schlicht nichts an.

Verbindungsstatus & erneut verbinden

Shopify stellt MailInApp ein kurzlebiges Zugriffstoken aus (etwa eine Stunde gültig) zusammen mit einem rotierenden Refresh-Token, und MailInApp erneuert dieses Paar automatisch im Hintergrund — Kundensynchronisierung, Journey-Trigger und das Prägen von Rabattcodes funktionieren im Normalbetrieb ohne jegliches Zutun Ihrerseits weiter.

Sollte Shopify dieses Refresh-Token jemals widerrufen oder ungültig machen — zum Beispiel weil die App außerhalb von MailInApp deinstalliert und neu installiert wurde, der Zugriff manuell in Ihrem Shopify-Adminbereich widerrufen wurde, oder das Token schlicht durch längere Inaktivität abgelaufen ist —, hält MailInApp bewusst an, statt stillschweigend mit veralteten Zugangsdaten weiterzuversuchen, und zeigt unter Einstellungen → Integrationen den Status des Shops als Erneute Verbindung erforderlich an. Dies ist eine Sicherheitsmaßnahme, kein Fehlerbericht: MailInApp authentifiziert sich niemals in Ihrem Namen erneut, ohne dass Sie eine neue OAuth-Freigabe über Shopifys eigenen Bildschirm genehmigen.

Wenn Sie diesen Status sehen, klicken Sie unter Einstellungen → Integrationen auf Trennen und anschließend erneut auf Shopify verbinden, um ein sauberes Token-Paar zu erhalten. Das dauert nur wenige Sekunden, berechnet die einmalige Verbindungsgebühr nicht erneut und rührt weder bereits synchronisierte Kontakte noch Bestellungen an — die Synchronisierung wird einfach fortgesetzt, sobald die neue Verbindung genehmigt ist.

Trennen

Trennen in den Einstellungen stoppt die Synchronisierung und jede weitere Webhook-Verarbeitung sofort. Bereits synchronisierte Kunden bleiben in ihrer Kontaktliste — das Trennen einer Integration löscht niemals Kontakte, da diese bereits eine Versand-Zielgruppe für andere Projekte sein könnten. Das Deinstallieren der App auf Shopify-Seite funktioniert zunächst genauso. Etwa 48 Stunden später, sobald Shopifys eigener Datenlösch-Webhook auslöst, werden auch die synchronisierten Kontakte und Warenkorb-Datensätze vollständig gelöscht — die Standard-Karenzzeit, die jede Shopify-App einhalten muss.