Dokumentationsmenü

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.

Video auf Englisch

Ihren Shop verbinden

Sie verbinden einen Shop, indem Sie in Ihrem eigenen Shopify-Admin eine kleine App für ihn erstellen und deren zwei Schlüssel in MailInApp einfügen. Das dauert etwa fünf Minuten. Sie brauchen weder ein Shopify-Partner-Konto noch Code, und die App bleibt privat für Ihren Shop.

Sie müssen in Shopify Inhaber des Shops sein (oder ein Mitarbeiter, der Apps entwickeln darf) und Inhaber Ihres MailInApp-Kontos.

Schritt 1: Das Dev Dashboard öffnen

Gehen Sie in Ihrem Shopify-Admin zu Einstellungen → Apps und klicken Sie oben rechts auf Develop apps.

Die Seite Einstellungen → Apps im Shopify-Admin, mit hervorgehobener Schaltfläche Develop apps

Klicken Sie auf der Seite zur App-Entwicklung auf Build apps in Dev Dashboard. Beim ersten Mal bittet Shopify Sie, Ihre E-Mail-Adresse zu bestätigen und sich erneut anzumelden, und legt dann eine nach Ihrem Shop benannte Entwicklerorganisation an. Wenn die Seite Stores im Dev Dashboard „No stores yet“ anzeigt, ist das in Ordnung: Ihr Shop muss dort nicht aufgeführt sein.

Die Seite zur App-Entwicklung, mit hervorgehobener Schaltfläche Build apps in Dev Dashboard

Schritt 2: Die App erstellen

Öffnen Sie im Dev Dashboard Apps und klicken Sie auf Create app und dann auf Create app manually. Alles steht in einem Formular:

  • App name: ein Name, den Sie wiedererkennen, zum Beispiel MailInApp.
  • App URL: https://mailinapp.com/dashboard/settings/integrations. Shopify öffnet diese Seite nach der Installation der App, sodass Sie im Verbindungsformular von MailInApp landen, in dem Ihre Shop-Adresse bereits ausgefüllt ist.
  • Embed app in Shopify admin: Entfernen Sie das Häkchen. Ihre App hat keine Seite in Shopify.
  • Scopes: read_customers,read_orders,read_products,write_discounts. Damit kann MailInApp Ihre Kunden, Bestellungen und Produkte lesen und die unten beschriebenen Einmal-Rabattcodes erstellen. MailInApp ändert nie Ihre Produkte, Bestellungen oder Kunden. Um Bestellungen zu erreichen, die älter als etwa 60 Tage sind, fügen Sie auch read_all_orders hinzu: Für Ihre eigene App gewährt Shopify ihn ohne Prüfung.
  • Webhooks API version: Lassen Sie die Voreinstellung.

Das Formular Create an app, mit hervorgehobener App URL, dem nicht angehakten Feld Embed app in Shopify admin, den Scopes und der Schaltfläche Create app

Klicken Sie auf Create app. Shopify bittet Sie, die erste Version zu veröffentlichen: Klicken Sie auf Release.

Der Dialog Release version, mit hervorgehobener Schaltfläche Release

Schritt 3: Die App in Ihrem Shop installieren

Klicken Sie auf der Seite Overview der App in der Karte Installs auf Test app und wählen Sie Ihren Shop.

Die Overview-Seite der App, mit hervorgehobener Schaltfläche Test app

Shopify zeigt seinen Installationsbildschirm mit den Zugriffsrechten, die die App braucht. Dort steht auch, dass die App nicht geprüft wurde. Das ist zu erwarten, denn die App gehört Ihnen und durchläuft nie den App Store. Klicken Sie auf Install.

Shopifys Bildschirm Install app, mit hervorgehobener Schaltfläche Install

Ihr Shop führt die App jetzt unter Einstellungen → Apps.

Schritt 4: Die Schlüssel in MailInApp einfügen

Zurück auf der Seite Overview der App im Dev Dashboard enthält die Karte Credentials die Client ID und das Client secret. Das Secret ist verborgen; die Kopieren-Schaltfläche daneben kopiert es.

Die Karte Credentials auf der Overview-Seite der App, mit den Feldern Client ID und Client secret

Öffnen Sie in MailInApp Einstellungen → Integrationen. Geben Sie in der Shopify-Karte Ihre Shop-Adresse ein (your-store.myshopify.com), fügen Sie Client ID und Client secret ein und klicken Sie auf Shopify verbinden. MailInApp bittet Sie unter Umständen zuerst, sich erneut anzumelden, da die Schlüssel vollen Zugriff auf die Daten Ihres Shops geben.

Die Shopify-Karte unter Einstellungen → Integrationen, mit ausgefüllter Shop-Adresse und hervorgehobener Schaltfläche „Shopify verbinden“

MailInApp prüft die Schlüssel bei Shopify, verschlüsselt das Client secret und zeigt es nie wieder an. Dann erstellt es eine Kontaktliste für den Shop und synchronisiert im Hintergrund Ihre Kunden (bis zu 5.000 in diesem ersten Durchlauf; spätere kommen an, sobald sie angelegt werden) und Ihren Produktkatalog.

Lassen Sie die IP allowlist in den Einstellungen Ihrer App ausgeschaltet. Ist sie aktiv, lehnt Shopify die Anfragen von MailInApp ab.

Das Verbinden von Shopify ist auf jedem Tarif kostenlos, einschließlich Free. Ihr MailInApp-Tarif wird wie gewohnt von MailInApp abgerechnet, unter Einstellungen → Tarif. Ihr gesamter Produktkatalog wird auf jedem Tarif synchronisiert, und jeder Tarif enthält ein monatliches Kontingent an Shop-Rabattcodes.

Wenn die Verbindung fehlschlägt

Die Shopify-Karte sagt, was schiefgelaufen ist:

  • Shopify hat diese Client ID und dieses Client secret nicht akzeptiert: Kopieren Sie beide erneut aus der Karte Credentials. Wenn Sie ein neues Secret erzeugt haben, verwenden Sie das neue.
  • Die App ist in diesem Store nicht installiert: Führen Sie Schritt 3 erneut aus (Test app, dann Install).
  • Ihrer App fehlen diese Zugriffs-Scopes: Öffnen Sie im Dev Dashboard die Versions der App, erstellen Sie eine neue Version mit den Scopes aus Schritt 2, veröffentlichen Sie sie und verbinden Sie dann erneut.
  • Diese App gehört zu einer anderen Shopify-Organisation: Erstellen Sie die App wie in Schritt 1 im Admin Ihres eigenen Shops, nicht über ein anderes Partner- oder Entwicklerkonto.
  • Das ist keine Shopify-Store-Adresse: Verwenden Sie die myshopify.com-Adresse, die in den Einstellungen unter dem Namen Ihres Shops steht, nicht Ihre eigene Domain.

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 erstellen, der beim Checkout Ihres eigenen Shops eingelöst wird (siehe Rabattangebot). Neue Bestellungen synchronisieren automatisch über den orders/paid-Webhook. Für Bestellungen von vor der Verbindung führen Sie einmal Bestellhistorie nachträglich abrufen unter Einstellungen → Integrationen aus; Shopify beschränkt das auf ungefähr die letzten 60 Tage. Ein aus Ihrem Katalog importierter Produkt-Block kann unabhängig davon seinen eigenen Rabatt pro Produkt erstellen, beschränkt auf genau diesen Artikel und ohne Zielgruppenfilter: 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. Es ist 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.

Shop-Bewertungen

Shopify speichert selbst keine Bewertungen, daher liest MailInApp sie aus Judge.me, der Bewertungs-App Ihres Shops:

  1. Öffnen Sie in Judge.me Settings → Integrations und klicken Sie auf View API token. Kopieren Sie das private Token.
  2. Öffnen Sie in MailInApp Einstellungen → Integrationen. Fügen Sie auf der Karte Ihres Shops unter Judge.me das Token ein und klicken Sie auf Judge.me verbinden.

MailInApp prüft das Token bei Judge.me und synchronisiert dann Ihre Bewertungen, danach bei jeder Shop-Synchronisation erneut. Es behält nur die in Ihrem Shop veröffentlichten Bewertungen (nicht ausgeblendet und nicht auf Freigabe wartend in Judge.me), höchstens die 5.000 neuesten. Eine Bewertung, die Sie in Judge.me ausblenden oder löschen, ist nach der nächsten Synchronisation weg. MailInApp speichert nie die E-Mail-Adresse einer verfassenden Person und zeigt Namen als Vornamen mit Initiale des Nachnamens. Die Karte zeigt, wie viele Bewertungen synchronisiert sind, und Bewertungen jetzt synchronisieren synchronisiert sie sofort.

Das Token dient nur zum Lesen von Bewertungen. Judge.me trennen löscht das Token und die synchronisierten Bewertungen, ebenso das Trennen des Shops. Sternebewertungen importierter Produkte brauchen das Token nicht: Sie stammen aus der Bewertung, die Judge.me bereits an jedem Produkt in Shopify speichert. Siehe Shop-Bewertungen zu Sternen, Bewertungen in E-Mails und Veröffentlichung.

Verbindungsstatus & Schlüssel aktualisieren

MailInApp tauscht die Schlüssel Ihrer App gegen ein kurzlebiges Shopify-Zugriffstoken (etwa einen Tag gültig) und holt sich selbstständig ein neues, bevor es abläuft. Im Normalbetrieb ist nichts zu tun.

Wenn die Schlüssel nicht mehr funktionieren, hält MailInApp die Synchronisierung an, und die Shopify-Karte unter Einstellungen → Integrationen zeigt Handlungsbedarf und sagt, warum:

  • Die Schlüssel Ihrer Shopify-App funktionieren nicht mehr: Das Secret wurde widerrufen oder die App gelöscht. Klicken Sie auf Schlüssel aktualisieren und fügen Sie die aktuelle Client ID und das aktuelle Client secret der App ein.
  • Ihre Shopify-App ist nicht mehr im Store installiert: Die App wurde aus Ihrem Shop deinstalliert. Installieren Sie sie über ihre Overview-Seite erneut (Test app). Die Schlüssel bleiben gleich, daher verbindet sich MailInApp innerhalb von 6 Stunden selbstständig neu und richtet seine Webhooks wieder ein. Um sofort neu zu verbinden, klicken Sie auf Schlüssel aktualisieren und fügen Sie sie ein.

Um das Client secret zu ändern (zum Beispiel als regelmäßige Sicherheitsmaßnahme), gehen Sie schrittweise vor, damit der Shop nie getrennt wird:

  1. Öffnen Sie im Dev Dashboard die Settings der App und klicken Sie auf Generate new secret. Beide Secrets funktionieren, bis Sie das alte widerrufen.
  2. Klicken Sie in MailInApp in der Shopify-Karte auf Schlüssel aktualisieren und fügen Sie das neue Secret ein.
  3. Widerrufen Sie zurück im Dev Dashboard das alte Secret.

Shopify signiert seine Webhooks weiter mit dem alten Secret, bis Sie es widerrufen, und MailInApp akzeptiert in der Zwischenzeit beide, egal wie lange das dauert. Mit Schlüssel aktualisieren stellen Sie einen Shop auch auf eine andere Ihrer Apps um: Fügen Sie die Client ID und das Secret dieser App ein.

Trennen

Trennen unter Einstellungen → Integrationen stoppt die Synchronisierung und jede weitere Webhook-Verarbeitung sofort. MailInApp entfernt seine Webhooks aus Ihrer App und löscht die gespeicherten Schlüssel. Danach können Sie die App aus Ihrem Shop deinstallieren oder im Dev Dashboard löschen.

Wenn Sie die App deinstallieren, ohne vorher zu trennen, wird der Shop nur pausiert: Die Karte meldet, dass die App nicht installiert ist, und eine Neuinstallation macht dort weiter, wo sie aufgehört hat. Bleibt die App 30 Tage lang deinstalliert, löscht MailInApp die gespeicherten Schlüssel und trennt den Shop. Um einen getrennten Shop wieder zu verbinden, füllen Sie das Formular in der Shopify-Karte aus. Es beginnt mit der Adresse des Shops, und der Shop behält seine Kontaktliste.

Rabattcodes, die MailInApp bereits in Ihrem Shop erstellt hat (sie beginnen mit MIA-), bleiben in Shopify, wenn Sie die App deinstallieren oder trennen, und gelten weiter, bis sie ablaufen. Codes in bereits versendeten E-Mails funktionieren also weiter. Der Deinstallationsbildschirm von Shopify sagt, dass die Rabatte der App gelöscht werden; gemeint sind Rabatte, die eine App selbst ausführt, und solche erstellt MailInApp nicht. Um die Codes vorzeitig zu beenden, löschen Sie sie in der Shopify-Verwaltung unter Discounts.

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. Löschen Sie die Liste selbst, wenn Sie sie nicht mehr brauchen.

MailInApp verwaltet die Kunden Ihres Shops in Ihrem Auftrag. Ihre eigene App leitet Shopifys Anfragen zur Löschung von Kundendaten nicht an MailInApp weiter. Wenn ein Kunde Sie bittet, seine Daten zu löschen, löschen Sie ihn daher auch in MailInApp, über sein Kontaktprofil (siehe Daten eines einzelnen Empfängers exportieren oder löschen). Dasselbe gilt für eine Deinstallation: Shopifys Deinstallationsbildschirm weist darauf hin, dass der Entwickler der App aufgefordert wird, Kundendaten innerhalb von 48 Stunden zu löschen. Bei Ihrer eigenen App sind Sie dieser Entwickler, und Shopify leitet diese Anfrage nicht an MailInApp weiter. Löschen Sie die Kontaktliste des Shops daher selbst, wenn sie weg soll.