Kategorievalidierung
Produktkategorien beschreiben, worum es sich bei einem Artikel handelt – in der Regel als Hierarchie von einer breiten Wurzelkategorie bis zu einer spezifischen Endkategorie, zum Beispiel ["Footwear", "Athletic", "Running Shoes"]. Genaue Kategorien halten Ihren Katalog sauber und speisen nachgelagerte Prozesse wie Klassifizierung und Handels-Compliance, bei denen ein falsch kategorisierter Artikel zum falschen Ergebnis führen kann.
Kataloge sammeln im Laufe der Zeit Kategoriefehler an – durch manuelle Eingabe, Lieferanten-Feeds oder Migrationen zwischen Systemen. Zonos Category Validation prüft, ob die einem Artikel zugewiesenen Kategorien diesen Artikel tatsächlich beschreiben, und schlägt bei Abweichungen bessere Kategorien vor, die aus den Kategorien stammen, die Ihre Organisation bereits verwendet.
Funktionsweise
Zonos Category Validation nutzt KI, um zu beurteilen, ob die von Ihnen bereitgestellte Kategoriehierarchie einen Artikel korrekt beschreibt – basierend auf dem name des Artikels und allen weiteren Details, die Sie angeben, wie brand, material und description.
Für jeden Artikel gibt es ein verdict von CORRECT oder WRONG zusammen mit einem Konfidenzwert zurück. Wenn das Urteil WRONG lautet, wird eine rangierte Liste vorgeschlagener Kategorien zurückgegeben, damit Sie die Zuweisung korrigieren können. Vorschläge stammen aus dem Kategoriebaum Ihrer Organisation – der Menge der Kategoriepfade, die Ihre Organisation verwendet – und alle von Ihnen übermittelten Kategorien werden automatisch zu diesem Baum hinzugefügt, sodass ein gut gepflegter Baum im Laufe der Zeit bessere Vorschläge liefert.
Dies ist ein Batch-Endpunkt – Sie können viele Artikel in einer einzigen Anfrage validieren, und die Ergebnisse werden in derselben Reihenfolge wie die Eingabe zurückgegeben.
Urteil und Konfidenz
Jedes Ergebnis enthält ein verdict:
CORRECT— der Artikel gehört plausibel zu den zugewiesenen Kategorien.WRONG— der Artikel gehört nicht zu den zugewiesenen Kategorien.
Jedes Ergebnis enthält außerdem einen confidenceScore zwischen 0,0 und 1,0, der angibt, wie sicher das Modell in dem zurückgegebenen Urteil ist. Der Wert spiegelt die Sicherheit im Urteil selbst wider – ein sicheres WRONG-Ergebnis hat also einen hohen confidenceScore, genau wie ein sicheres CORRECT-Ergebnis. Wenn das Urteil WRONG lautet, enthält die Liste suggestedCategories alternative Kategoriehierarchien, jeweils mit einem confidence-Wert und sortiert von der wahrscheinlichsten zur unwahrscheinlichsten. Wenn das Urteil CORRECT lautet, ist suggestedCategories leer.
Wir empfehlen, den Konfidenzwert zu nutzen, um zu entscheiden, welche Ergebnisse automatisch akzeptiert und welche zur manuellen Prüfung weitergeleitet werden.
Kategorien validieren
Um Kategorien zu validieren, verwenden Sie die Mutation categoriesValidate. Jeder Artikel erfordert einen name und die zu validierende categories-Hierarchie. Sie können optional brand, material, description, amount, currencyCode, globalTradeItemNumber und imageUrl angeben, um die Genauigkeit zu verbessern. Übermitteln Sie mehrere Artikel in einer einzigen Anfrage, um in großen Mengen zu validieren.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}Im obigen Beispiel werden die Kategorien des ersten Artikels als CORRECT mit hoher Konfidenz bestätigt und ohne Vorschläge zurückgegeben. Der zweite Artikel wird mit hoher Sicherheit als WRONG markiert, und die Liste suggestedCategories schlägt besser passende Kategorien vor, sortiert nach Konfidenz.
Ihren Kategoriebaum verwalten
Der Kategoriebaum Ihrer Organisation ist die Menge der Kategoriepfade, die Zonos kennt und die Ihre Organisation verwendet. Category Validation bezieht seine suggestedCategories aus diesem Baum – eine genaue und vollständige Pflege verbessert daher direkt die Qualität der Vorschläge. Kategorien, die Sie an categoriesValidate übermitteln, werden automatisch zum Baum hinzugefügt, Sie können ihn aber auch direkt verwalten.
Jede Kategorie ist eine Hierarchie, die als path-Array gespeichert wird – von breiter Wurzel bis spezifischer Endkategorie, zum Beispiel ["Footwear", "Athletic", "Running Shoes"].
Ihre Kategorien auflisten
Verwenden Sie die Abfrage categories, um den Kategoriebaum Ihrer Organisation abzurufen. Die Ergebnisse sind paginiert.
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}Kategorien hinzufügen
Verwenden Sie die Mutation categoriesCreate, um einen oder mehrere Kategoriepfade zu Ihrem Baum hinzuzufügen. Dies ist nützlich, um den Baum vor der Validierung zu befüllen, damit Vorschläge auf Ihrer vollständigen Taxonomie basieren können.
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}Kategorien aktualisieren oder entfernen
Verwenden Sie die Mutation categoryUpdate, um den path einer Kategorie anhand ihrer id zu korrigieren, oder die Mutation categoryDelete, um eine Kategorie zu entfernen, die nicht mehr zutrifft. Das Entfernen veralteter oder falscher Kategorien hält Vorschläge relevant.
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}Um eine Kategorie zu entfernen, übergeben Sie deren id an die Mutation categoryDelete. Sie gibt SUCCESS oder FAILURE zurück.
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Category Validation
Prüfen Sie, ob die zugewiesenen Kategorien eines Artikels zum Produkt passen, und erhalten Sie bessere Kategorievorschläge, wenn dies nicht der Fall ist.