Integrationen
Shopify mit einer eigenen App
Verbinden Sie einen Shopify-Shop mit AmICited über Ihre eigene App aus dem Shopify Dev Dashboard statt über die App-Store-App: Scopes, Client ID und Secret sowie die Einschränkungen.
Üblicherweise wird Shopify über die FlowHunt-App aus dem Shopify App Store verbunden (siehe E-Commerce-Shops). Wenn Sie keine öffentliche App in Ihrem Shop möchten oder Ihre Shop-Richtlinien Installationen aus dem App Store nicht zulassen, können Sie die Verbindung über eine eigene App (Custom App) herstellen, die Sie selbst im Shopify Dev Dashboard anlegen.
Sobald sie verbunden ist, funktioniert eine eigene App genauso wie eine Installation aus dem App Store: Importangebot, nachträglicher Import von Bestellungen und Produkten, Shop-Berichte, Link-Building und CMS.
E-Commerce-Integrationen sind ab dem Pro-Tarif verfügbar, und nur Workspace-Administratoren können sie verbinden.
Bevor Sie beginnen#
- Verwenden Sie die eigene Shopify-Organisation des Shops. Die App muss zur selben Shopify-Organisation gehören wie der Shop. Eine Agentur kann ihre eigene App nicht für den Shop eines Kunden verwenden; die App muss daher der Kunde anlegen.
- Zahlung per Karte. Workspaces, die über Shopify abgerechnet werden, können keine eigene App verwenden. Stellen Sie den Tarif zuerst auf Kartenzahlung um.
- Shopify-Berechtigungen. Sie müssen im Dev Dashboard des Shops Apps anlegen dürfen (als Shop-Inhaber oder mit einem Mitarbeiterkonto, das Apps entwickeln darf).
Die App in Shopify anlegen#
App-Entwicklung im Shopify-Adminbereich öffnen
Klicken Sie im Shopify-Adminbereich auf Settings, dann auf Apps und anschließend auf Develop apps, und klicken Sie auf Build apps in Dev Dashboard. Sie können auch direkt das Shopify Dev Dashboard öffnen und sich mit dem Konto anmelden, dem der Shop gehört.
App anlegen
Öffnen Sie im Dev Dashboard Apps und klicken Sie auf Create app. Wenn Ihre Organisation bereits Apps hat, klicken Sie oben rechts auf Create app und wählen Sie Create app manually.
App-Angaben und Scopes ausfüllen
- App name (1): ein Name, den Sie wiedererkennen, zum Beispiel „AmICited“.
- App URL (2):
https://app.flowhunt.io/. Deaktivieren Sie Embed app in Shopify admin; die App hat in Shopify keine eigene Oberfläche. - Allowed redirection URL(s): leer lassen. AmICited meldet sich mit der Client ID und dem Client Secret der App an, Shopify leitet also nie dorthin zurück. Lassen Sie Use legacy install flow deaktiviert.
- Scopes (3, unter API access): Fügen Sie diese Liste ein. Es sind dieselben Scopes, die auch die App-Store-App anfordert, sodass die eigene App alle AmICited-Funktionen erhält – mit Ausnahme der Bestellhistorie, die älter als 60 Tage ist (siehe unten):
read_orders,write_orders,read_products,write_products,read_customers,write_customers,read_inventory,write_inventory,read_locations,write_price_rules,read_content,write_content,read_themes,write_themes,read_localesLassen Sie Webhooks API version unverändert.
Sie setzen lieber Häkchen, statt Text einzufügen? Klicken Sie über dem Feld Scopes auf Select from list, suchen Sie nach jedem Scope aus der obigen Liste (1), setzen Sie das Häkchen und klicken Sie auf Done (2).
App erstellen
Sobald Name, URL und Scopes ausgefüllt sind, klicken Sie oben rechts im Formular auf Create app (4 im Screenshot des Formulars oben). Shopify legt die App an und veröffentlicht ihre erste Version.
Prüfen, ob die Version aktiv ist
Öffnen Sie Versions im App-Menü: Die erste Version ist als Active markiert. Wenn Sie die Scopes später ändern, klicken Sie auf Create version, damit die Änderung wirksam wird.
Distribution auf benutzerdefiniert stellen
Eine eigene App muss auf Ihren Shop beschränkt werden, bevor sie dort installiert werden kann.
- Klicken Sie in der Overview der App auf die Karte Distribution (Manage custom install link). Shopify öffnet das Partners Dashboard; wählen Sie bei Nachfrage das Konto, das Sie für den Shop verwenden.
- Wählen Sie Custom distribution (1) und klicken Sie auf Select (2). Die Distributionsmethode lässt sich in Shopify danach nicht mehr ändern.
- Geben Sie unter Store domain die Adresse
your-store.myshopify.comIhres Shops ein (1; siehe Shop-Adresse ermitteln unten) und klicken Sie auf Generate link (2). Allow multi-store install for one Plus organization ist nur relevant, wenn Ihr Shop zu einer Shopify-Plus-Organisation mit mehreren Shops gehört.
App in Ihrem Shop installieren
Die App kann erst Daten lesen, wenn sie im Shop installiert ist.
- Öffnen Sie im Dev Dashboard die Overview der App und klicken Sie oben auf der Karte Installs auf Install app. In manchen Dashboards heißt diese Schaltfläche Test app, wie im Screenshot unten. Sie können auch das Menü ⋯ in der Zeile der App in der Liste Apps öffnen und Install app wählen.
- Wählen Sie den Shop aus, den Sie verbinden möchten.
- Prüfen Sie die Zugriffsrechte, die die App anfordert, und klicken Sie auf Install.
Der Bildschirm warnt: „This app hasn’t been reviewed“. Das ist zu erwarten: Es ist Ihre eigene App, keine aus dem App Store.
Client ID und Client Secret kopieren
Öffnen Sie im Dev Dashboard die Settings der App. Kopieren Sie unter Credentials die Client ID und das Client secret (über die Kopier-Schaltflächen neben den Feldern). Behandeln Sie das Secret wie ein Passwort.
Eigene Apps importieren die Bestellungen der letzten 60 Tage
Shopify gibt Bestellungen, die älter als 60 Tage sind, nur an Apps mit dem Scope read_all_orders heraus, und das Dev Dashboard lehnt diesen Scope bei einer eigenen App ab („Contains invalid scopes: read_all_orders“). Eine Verbindung über eine eigene App importiert daher die Bestellungen der letzten 60 Tage, und die Shop-Berichte beginnen ab diesem Zeitpunkt. Das Importangebot kann trotzdem einen längeren Zeitraum anbieten; der Import selbst endet jedoch bei 60 Tagen. Wenn Sie die vollständige Bestellhistorie benötigen, verbinden Sie den Shop stattdessen über die App-Store-App.
In AmICited verbinden#
Shop-Adresse ermitteln
Öffnen Sie im Shopify-Adminbereich Settings. Die Shop-Adresse (
your-store.myshopify.com) wird oben im Menü unter dem Shopnamen angezeigt.
Shopify-Dialog öffnen
Gehen Sie zu Datenquellen, klicken Sie unter Onlineshops auf Connect Shopify Store und dann auf Use a custom app instead (1 im Screenshot unten).
Shop und Zugangsdaten eingeben
Geben Sie Store address, Client ID und Client secret (2) ein und klicken Sie auf Connect store (3).
Domain wählen und Import bestätigen
Ordnen Sie den Shop einer Domain zu und wählen Sie, wie viel Bestellhistorie importiert werden soll – genauso wie bei einer Installation aus dem App Store. Jede Option zeigt vor der Bestätigung die voraussichtliche Zeilenanzahl und die einmaligen Kosten.
Richten Sie anschließend Kundendaten und Shop-Einstellungen wie bei jedem anderen Shop ein.
Unterschiede bei einer eigenen App#
Eigene Apps erhalten keine Shopify-Webhooks. Wenn Sie in Shopify ein Produkt oder eine Seite bearbeiten, wendet das Link-Building seine Links daher nicht sofort neu an. Sie werden beim nächsten Lauf der Regel erneut angewendet. Die Verbindung bricht innerhalb von etwa einem Tag ab, und der Workspace erhält eine Benachrichtigung. Um die Verbindung wiederherzustellen, öffnen Sie denselben Dialog, wählen Update credentials und geben die aktuelle Client ID und das aktuelle Client Secret der App ein. Ältere Bestellungen erfordern den Shopify-Scope Nein. Die App muss zur selben Shopify-Organisation gehören wie der Shop, daher legt jeder Kunde seine eigene App an.Warum werden Links nicht sofort neu angewendet, wenn ich ein Produkt bearbeite?
Was passiert, wenn die App gelöscht oder deinstalliert wird?
Warum reicht der Import nur 60 Tage zurück?
read_all_orders, und das Dev Dashboard akzeptiert ihn bei einer eigenen App nicht. Eine Verbindung über eine eigene App importiert daher die Bestellungen der letzten 60 Tage; neue Bestellungen kommen ab dann laufend hinzu. Für die vollständige Historie verwenden Sie die App-Store-App.Kann eine Agentur eine App für alle ihre Kunden verwenden?