Shopify-Store mit einer benutzerdefinierten App (Admin-API) verbinden

Wenn Ihr Store auf Shopify läuft, können Sie ihn verbinden, indem Sie eine benutzerdefinierte App erstellen und deren Admin-API-Zugriffstoken in das Panel einfügen. Danach werden Titel- und Meta-Beschreibungsregeln mit exaktem Pfad in die SEO-Felder Ihrer Produkte, Seiten und Kategoriensammlungen (Collections) geschrieben, und Blogbeiträge aus dem Content Studio werden dem Blog Ihres Stores als Artikel hinzugefügt.

#Voraussetzungen

• Ein Shopify-Administrator-Konto, das Apps entwickeln darf.
• Die Domain Ihres Stores in der Form my-store.myshopify.com.
• Für die Blog-Veröffentlichung mindestens ein Blog im Store.

#Admin-API-Token abrufen

1. Gehen Sie in der Shopify-Adminoberfläche zu Einstellungen → Apps und Vertriebskanäle → Apps entwickeln und aktivieren Sie die Entwicklung benutzerdefinierter Apps mit "Entwicklung benutzerdefinierter Apps zulassen".
2. Klicken Sie auf App erstellen, geben Sie ihr einen Namen (z. B. SEOAsist) und öffnen Sie Admin-API-Bereiche konfigurieren.
3. Wählen Sie diese Zugriffsbereiche (Scopes) aus: read_products, write_products, read_content, write_content, read_online_store_pages.
4. Klicken Sie auf App installieren, enthüllen und kopieren Sie dann das Admin-API-Zugriffstoken (shpat_…). Shopify zeigt es nur einmal an.

#Panel mit Ihrem Store verbinden

1. Öffnen Sie die Website unter Websites und wechseln Sie zum Reiter Behebungskanäle.
2. Geben Sie in der Shopify-Karte unter Store-Domain my-store.myshopify.com ein.
3. Fügen Sie das Token, das mit shpat_ beginnt, in Admin-API-Zugriffstoken ein.
4. Klicken Sie auf Verbinden. Das Panel ruft Ihre Store-Details mit dem Token ab; bei Erfolg sehen Sie "Shopify verbunden" und der Status wechselt zu Verbunden. Das Token wird verschlüsselt gespeichert.

#SEO-Regeln in den Store schreiben

1. Definieren Sie zuerst eine Titel- oder Meta-Beschreibung-Pixel-Regel mit dem Übereinstimmungstyp Exakter Pfad: /products/…, /pages/… oder /collections/….
2. Überprüfen Sie die Anzahl der berechtigten Regeln im Abschnitt SEO-Regeln übertragen der Shopify-Karte.
3. Klicken Sie auf SEO-Regeln übertragen. Das Panel gleicht Produkte, Seiten und Collections über den Handle ab und schreibt die Werte in die SEO-Metafelder von Shopify (global.title_tag / global.description_tag).
4. Die Benachrichtigung teilt Ihnen mit, wie viele Ressourcen gescannt und wie viele Regeln angewendet wurden.

#Blogbeiträge veröffentlichen

Wählen Sie im Content-Studio Shopify als Kanal für einen Blogbeitrag aus und veröffentlichen Sie ihn. Der Beitrag wird dem ersten Blog des Stores als Artikel hinzugefügt, als Entwurf oder live. Titel, Haupttext, Zusammenfassung, Tags, Beitragsbild, Meta-Titel und Meta-Beschreibung werden mitübertragen. Nur Blogbeiträge können auf Shopify veröffentlicht werden.

In Organisationen, die über CoSuite abgerechnet werden, sind Websites außerhalb des CoSuite-Website-Kontingents schreibgeschützt, sodass Regel-Übertragungen und Veröffentlichungen für diese abgelehnt werden. Organisationen, die ihren eigenen Tarife bezahlen, haben keine solche Einschränkung.

#Überprüfung

• Die Karte zeigt Verbunden zusammen mit dem Store-Namen, der Domain, dem Shopify-Tarif und der primären Sprache an.
• Nach dem Klicken auf SEO-Regeln übertragen aktualisiert sich das Datum der "letzten Übertragung".
• In Shopify zeigt der Suchmaschinen-Eintragsbereich des Produkts den neuen Titel und die neue Beschreibung an.

#FAQ

#Warum erhalte ich "Die Store-Domain muss wie my-store.myshopify.com aussehen"?

Das Panel akzeptiert nur Domains, die auf .myshopify.com enden. Geben Sie die myshopify.com-Adresse ein, die Shopify Ihnen zugewiesen hat, nicht Ihre benutzerdefinierte Domain (z. B. www.mystore.com).

#Was bedeutet "Ungültiges Token"?

Der eingefügte Wert sieht nicht wie ein Admin-API-Token einer benutzerdefinierten App aus. Das Token beginnt mit shpat_; kopieren Sie das Admin-API-Zugriffstoken, nicht den API-Schlüssel oder das API-Geheimnis.

#Ich erhalte beim Verbinden HTTP 401 oder 403. Was soll ich tun?

Das Token ist ungültig oder der App fehlen die erforderlichen Berechtigungen (Scopes). Vergleichen Sie die Admin-API-Bereiche der App mit der obigen Liste, installieren Sie die App neu und verbinden Sie sie über Token rotieren / erneut verbinden mit dem neuen Token.

#Ich habe meine Regeln übertragen, aber es heißt, 0 Regeln wurden angewendet. Warum?

Der Pfad der Regel stimmt möglicherweise nicht exakt mit dem Handle eines Produkts, einer Seite oder einer Collection im Store überein, oder die Regel verwendet einen anderen Übereinstimmungstyp als exakt. Stellen Sie sicher, dass der Pfad wie /products/handle aussieht und die Regel aktiviert ist.

#Die Veröffentlichung eines Blogbeitrags schlägt mit "Der Store hat keinen Blog" fehl. Was nun?

Ihr Store hat noch keinen Blog. Erstellen Sie einen in Shopify unter Onlinestore → Blogbeiträge und veröffentlichen Sie ihn dann erneut.

#Werden die in meinen Store geschriebenen SEO-Felder durch das Trennen der Verbindung entfernt?

Nein. Trennen entfernt nur die Verbindung; bereits in den Store geschriebene SEO-Felder bleiben unverändert erhalten.