Wie Sie die Anbindung der Onlineshop-Plattform Shopify an Mergado Editor sicherstellen#

Wie generieren Sie Shopify-API-Daten für Mergado (ab 1. Januar 2026)?#

Wichtige Anweisungen zur Anbindung#

  1. Tragen Sie in das Feld URLs > App URL ein: https://app.mergado.com/ 💡Diese URL-Adresse müssen Sie in das Feld App URL eintragen, wenn Sie eine benutzerdefinierte App in Shopify erstellen.

  2. Mindestberechtigungen (Scopes), die Mergado benötigt. ⚠️ Ohne diese Berechtigungen funktioniert die Integration nicht.

write_products,read_products,write_markets,read_markets,read_metaobjects
  1. Berechtigungen (Scopes), falls Sie auch Mergado Marketplaces nutzen möchten
read_customers,write_customers,write_orders,read_orders,read_products,read_shipping,write_shipping,write_order_edits,read_order_edits

Diese Anleitung folgt strikt der offiziellen Shopify-Dokumentation und der aktuellen Benutzeroberfläche zur App-Erstellung mithilfe des Shopify Developer Dashboard.

Offizielle Quellen: https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard

Für wen ist diese Anleitung gedacht?#

Dieser Artikel richtet sich an:

  • Shopify-Händler, die ihren Onlineshop mit Mergado verbinden möchten
  • Agenturen und Entwickler, die die Integration Shopify ↔ Mergado für Kunden einrichten
  • alle, die einen Shopify-API-Zugriffstoken benötigen

Sie erstellen eine eigene (custom) API-App für einen konkreten Onlineshop. Die App muss nicht im Shopify App Store veröffentlicht werden.

Was benötigen Sie?#

  • ein Shopify-Konto mit Admin-Zugriff auf den Onlineshop
  • Zugriff auf das Shopify Developer Dashboard

Bevor Sie beginnen: Prüfen Sie die Markets-Einstellungen#

⚠️ Dieser Schritt ist notwendig, damit Mergado Produkte für die einzelnen Märkte importieren kann.

Bereits vor der App-Erstellung empfehlen wir, die Markets-Einstellungen in der Shopify-Administration zu prüfen.

Was eingerichtet werden muss#

Für jeden Markt (Market), aus dem Sie Produkte in Mergado importieren möchten, muss:

  • eine Domain zugewiesen sein
  • eine Sprache zugewiesen sein
  • beide Werte müssen explizit im Bereich Customized hinzugefügt sein

Es genügt nicht, dass sie nur aus dem Bereich Inherited übernommen oder als Primary eingestellt sind.

Vorgehen in der Shopify-Administration#

  1. Öffnen Sie die Shopify-Administration
  2. Klicken Sie im linken Hauptmenü auf Markets
  3. Öffnen Sie einen konkreten Markt (z. B. Czechia)
  4. Scrollen Sie zum Bereich Inherited
  5. Klicken Sie bei Domain / language auf das Symbol +
  6. Im modalen Fenster:
  • markieren Sie die gewünschte Domain
  • markieren Sie die gewünschte Sprache
  1. Bestätigen Sie mit einem Klick auf Done
  2. Prüfen Sie, dass Domain / language in den Bereich Customized verschoben wurde
  3. Bestätigen Sie die Änderungen mit einem Klick auf Save :warning:

Wenn Domain / language nur im Bereich Inherited verbleibt, liefert die Shopify-API keine Daten für diesen Markt, und Mergado kann keine Produkte importieren.

Schritt 1: Öffnen Sie das Shopify Developer Dashboard#

Zum Shopify Developer Dashboard gelangen Sie auf zwei Wegen:

Variante A: Direkter Zugriff#

  1. Öffnen Sie https://dev.shopify.com/
  2. Melden Sie sich mit Ihrem Shopify-Konto an
  3. Öffnen Sie im linken Menü den Bereich Apps

Variante B: Über die Shopify-Administration#

  1. Öffnen Sie die Shopify-Administration Ihres Onlineshops
  2. Gehen Sie zu Settings → Apps
  3. Klicken Sie auf Develop apps
  4. Klicken Sie auf Build apps in Dev Dashboard

Schritt 2: Erstellen Sie eine neue App#

  1. Stellen Sie sicher, dass Sie sich im Bereich Apps befinden
  2. Klicken Sie auf Create app
  3. Wählen Sie Start from Dev Dashboard
  4. Geben Sie einen App-Namen ein (z. B. Mergado integration)
  5. Klicken Sie auf Create

Nach der App-Erstellung werden Sie zum Reiter Versions weitergeleitet.

Schritt 3: Erstellen Sie eine App-Version und richten Sie die Berechtigungen (Scopes) ein#

Jede App muss mindestens eine Version haben, damit sie in einem Onlineshop installiert werden kann.

3.1 Einrichtung der App-URL und Einbettung#

  1. Suchen Sie im Bereich URLs das Feld App URL
  2. Ersetzen Sie den Standardwert https://example.com durch:
https://app.mergado.com

Dieser Schritt ist für die korrekte Funktion der Integration mit Mergado notwendig. Bleibt der Standardwert bestehen, funktioniert die Autorisierung nicht korrekt.

  1. Deaktivieren Sie unter dem Feld App URL die Option Embed app in Shopify admin

3.2 Einrichtung der Zugriffsberechtigungen#

  1. Klicken Sie im Bereich Access auf Select scopes
  2. Suchen und markieren Sie im modalen Fenster:
    • read_products
    • write_products
    • read_markets
    • write_markets
    • read_metaobjects
  3. Bestätigen Sie mit einem Klick auf Done

Diese Berechtigungen sind notwendig, damit Mergado Produkte und marktspezifische Daten laden kann.

3.3 Veröffentlichung (Release) der Version#

  1. Scrollen Sie auf der Seite nach unten
  2. Klicken Sie auf Release
  3. Im Bestätigungsfenster können Sie den Versionsnamen leer lassen
  4. Bestätigen Sie mit einem Klick auf Release

Die App-Version ist nun veröffentlicht und bereit zur Installation.

Schritt 4: Installieren Sie die App im Onlineshop#

  1. Öffnen Sie im linken Menü Home
  2. Klicken Sie rechts oben auf Install app
  3. Wählen Sie den Shopify-Onlineshop, den Sie mit Mergado verbinden möchten
  4. Sie werden zur Shopify-Administration weitergeleitet
  5. Bestätigen Sie die Installation mit einem Klick auf Install

Die App ist nun im Onlineshop installiert.

Schritt 5: Beschaffen Sie die API-Zugriffsdaten (Client ID und Token)#

Nach der Installation der App müssen Sie zwei Werte beschaffen, die Sie für die Integration mit Mergado verwenden:

  1. Client ID
  2. API-Zugriffstoken (Secret)

Vorgehen:

  1. Kehren Sie zum Shopify Developer Dashboard zurück
  2. Öffnen Sie Ihre App
  3. Gehen Sie zu Settings
  4. Im Bereich Credentials:
  • kopieren Sie den Wert Client ID (das Feld befindet sich über dem Wert Secret)
  • kopieren Sie den Wert Secret

Client ID dient zur Identifizierung der App, Secret fungiert als API-Zugriffstoken. Für die korrekte Funktion der Integration mit Mergado sind beide Werte notwendig.

Schritt 6: Beschaffen Sie die Onlineshop-URL#

  1. Öffnen Sie die Shopify-Administration des verbundenen Onlineshops
  2. Öffnen Sie im linken Menü Home
  3. Kopieren Sie im Bereich Domains die Onlineshop-URL

Beispiel:

your-store.myshopify.com

Schritt 7: Verbinden Sie Shopify mit Mergado#

  1. Öffnen Sie Mergado
  2. Erstellen Sie ein neues Projekt
  3. Wählen Sie als Datenquelle Shopify
  4. Füllen Sie aus:
    • Shopify URL → tragen Sie die Onlineshop-URL ein
    • Client ID → tragen Sie die kopierte Client ID aus dem Shopify Developer Dashboard ein
    • Client Secret → tragen Sie das kopierte Secret ein
  5. Klicken Sie auf Log in

FAQ#

Nach der Auswahl eines Markets lädt die Sprache nicht. Warum?#

Die häufigste Ursache liegt in den Einstellungen des Bereichs Markets in der Shopify-Administration.

Wenn Domain / language nur im Bereich Inherited aufgeführt und nicht im Bereich Customized hinzugefügt ist, liefert die Shopify-API für diesen Markt keine Daten. Dadurch lädt die Sprache in Mergado nach der Auswahl eines Markets nicht.

Lösung:

  • Öffnen Sie Shopify admin → Markets
  • Öffnen Sie den konkreten Markt
  • Klicken Sie bei Domain / language auf +
  • Wählen Sie Domain und Sprache
  • Klicken Sie auf Done und dann auf Save
  • Prüfen Sie, dass die Position in den Bereich Customized verschoben wurde
  • Weitere Infos siehe Abschnitt: Bevor Sie beginnen: Prüfen Sie die Markets-Einstellungen

Mergado lädt den Wert einiger Metafelder nicht korrekt. Warum?#

Wenn bei einigen Metafeldern der korrekte Name (Key) angezeigt wird, der Wert (Value) jedoch als ID erscheint (z. B. ["gid://shopify/Metaobject/94942036012"]) oder die Meldung „Missing required scope“ erscheint, fehlt der App die Berechtigung zum Lesen von Metaobjekten.

Sie müssen einen weiteren Scope hinzufügen:

read_metaobjects

Vorgehen:

  1. Gehen Sie zum Shopify Developer Dashboard
  2. Öffnen Sie die für die Integration mit Mergado erstellte App
  3. Gehen Sie im linken Menü zu Versions
  4. Klicken Sie auf New version
  5. Fügen Sie im Bereich Scopes den neuen Scope read_metaobjects hinzu
  6. Bestätigen Sie die Änderungen und schließen Sie die neue Version mit einem Klick auf Release ab

Nach der Veröffentlichung der neuen Version müssen Sie die Anbindung erneut autorisieren.

Erneute Autorisierung in Mergado:

  1. Öffnen Sie die Erweiterung Mergado Keychain
  2. Entfernen Sie die bestehende Verbindung
  3. Tragen Sie die Autorisierungsdaten erneut ein:
  • Shopify URL
  • Client ID
  • Secret
  1. Melden Sie sich erneut an (Log in)

Nach dem Hinzufügen des Scopes und der erneuten Autorisierung werden die Metafeldwerte korrekt geladen.

Related articles

Was this article helpful?