Hier ist die strukturelle Tatsache, die die meisten Teams an Shopifys Agentenoberfläche übersehen: Es gibt nicht einen Katalog. Es gibt zwei.
Sie liegen auf unterschiedlichen Endpunkten, liefern unterschiedliche Felder, akzeptieren unterschiedliche Filter und ranken nach unterschiedlicher Logik. Dieselbe Optimierungsarbeit auf beide anzuwenden, trifft keinen von beiden.
Die wichtigsten Punkte
- Global Catalog (
catalog.shopify.com/api/ucp/mcp) umfasst das gesamte Ökosystem, clustert Angebote nach UPID und akzeptiert neun Filterfamilien. - Storefront Catalog (
{ihredomain}/api/ucp/mcp) liefert nur Ihre Produkte und akzeptiert drei Filter: categories, price, available. - UPID-Clustering bedeutet, dass in Commodity-Kategorien die Buy Box zurück ist — nur ist der Schiedsrichter jetzt ein Agent.
ships_fromfiltert nach dem Herkunftsland des Händlers. Grenzüberschreitende Verkäufer lassen sich mit einem Aufruf ausschließen.attributesakzeptiert nur Color, Size und Target gender. Jeder andere Attributname wird ignoriert und inmessageszurückgemeldet.

Global Catalog: das Schlachtfeld über Händler hinweg
Zwei Mechanismen definieren ihn.
Clustering nach UPID. Offizieller Wortlaut: „Results are clustered by Universal Product ID (UPID) and include offers from multiple merchants." Identische Produkte fallen in ein Cluster, und mehrere Händlerangebote konkurrieren darin. Wer Commodity-Ware oder breit distribuierte Produkte verkauft, präsentiert kein Produkt mehr, sondern ein Angebot gegen namentlich genannte Wettbewerber — und Marke, Preis, Bewertung und Fulfillment entscheiden.
Der Katalog hat außerdem begonnen, Bestände von Händlern zu indexieren, die gar nicht auf Shopify sind, markiert als source: "external".
Neun Filterfamilien. Das ist die eigentliche Optimierungsoberfläche:
Filter |
|---|