Produktkennungen und Varianten#
Das Zielelement im Onlineshop muss dasselbe Produkt identifizieren wie der Händlerkatalog. Die meisten Integrationsfehler entstehen, wenn diese beiden Werte nicht übereinstimmen.
Wählen Sie eine stabile Kennung#
Verwenden Sie den productCode, der beim vorbereiteten Produkt angezeigt wird. Im Shopify-Tutorial ist dies die SKU der Variante. Die Anfragefelder der Product Import API sind in der Importreferenz definiert; ersetzen Sie diese Feldnamen nicht durch Attributnamen des Onlineshops.
Halten Sie Kennungen identisch, einschließlich der Groß-/Kleinschreibung. Generieren Sie sie nicht aus veränderbaren Anzeigennamen und nehmen Sie nicht an, dass die interne Produkt-ID einer Plattform einer SKU entspricht.
Die ausgewählte Variante zuordnen#
| Storefront-Zustand | Zielverhalten |
|---|---|
| Eine vorbereitete Variante ist ausgewählt | Setzen Sie ihren exakten productCode |
| Die Auswahl ändert sich | Aktualisieren Sie das Ziel und räumen Sie veralteten SDK-Zustand gemäß Ihrer Integrationsanleitung auf |
| Es existiert keine SKU oder kein passendes Produkt | Halten Sie den erstellten Button verborgen oder deaktiviert |
| Eine Produktkarte verweist auf eine Standardvariante | Verwenden Sie die Kennung dieser Variante konsistent |
Verbinden Sie für Shopify die Synchronisierungshilfe des Tutorials mit dem tatsächlichen Callback Ihres Themes für Variantenänderungen. Folgen Sie für andere Onlineshops der Anleitung zu dynamischen Seiten.
Validieren Sie die Zuordnung#
Wählen Sie zwei Varianten mit sichtbar unterschiedlichen Produkten. Notieren Sie ihre Katalogcodes, untersuchen Sie jedes gerenderte data-product-code in den Browser-Entwicklertools und öffnen Sie dann den Viewer für jedes. Wiederholen Sie dies nach der Navigation ohne vollständiges Neuladen der Seite.
Wenn sich eine Kennung in Ihrem Quellsystem ändert, koordinieren Sie den Katalogimport und die Storefront-Veröffentlichung. Eine erfolgreiche HTTP-Importantwort ist nur eine Annahme; untersuchen Sie den Auftragsstatus und Elementfehler, bevor Sie sich auf den neuen Code verlassen.