Convalida della categoria
Le categorie di prodotto descrivono cos'è un articolo, solitamente come una gerarchia da una radice ampia a una foglia specifica, ad esempio: ["Footwear", "Athletic", "Running Shoes"]. Categorie accurate mantengono il tuo catalogo pulito e alimentano processi a valle come la classificazione e la conformità commerciale, in cui un articolo classificato in modo errato può produrre il risultato sbagliato.
I cataloghi accumulano errori di categoria nel tempo, a causa dell'inserimento manuale, dei feed dei fornitori o delle migrazioni tra sistemi. Zonos La convalida della categoria controlla se le categorie assegnate a un elemento descrivono effettivamente quell'elemento e, in caso contrario, suggerisce categorie migliori tratte dalle categorie già utilizzate dall'organizzazione.
Come funziona
Zonos La convalida della categoria utilizza l'intelligenza artificiale per giudicare se la gerarchia di categorie fornita descrive correttamente un articolo, in base alla sua name e tutti i dettagli aggiuntivi forniti come brand, material, E description.
Per ogni elemento restituisce a verdict Di CORRECT O WRONG insieme a un punteggio di confidenza. Quando ci sarà il verdetto WRONG, restituisce un elenco classificato delle categorie suggerite in modo da poter correggere l'assegnazione. I suggerimenti vengono estratti dall'albero delle categorie della tua organizzazione, ovvero l'insieme di percorsi di categorie utilizzati dalla tua organizzazione, e tutte le categorie inviate vengono aggiunte automaticamente a quell'albero, in modo che un albero ben gestito produca suggerimenti migliori nel tempo.
Si tratta di un endpoint batch: puoi convalidare molti elementi in un'unica richiesta e i risultati vengono restituiti nello stesso ordine dell'input.
Verdetto e fiducia
Ogni risultato include a verdict:
CORRECT- l'articolo appartiene plausibilmente alle categorie assegnate.WRONG— l'articolo non appartiene alle categorie assegnate.
Ogni risultato include anche a confidenceScore fra 0.0 E 1.0 indicando quanto il modello è fiducioso nel verdetto restituito. Il punteggio riflette la certezza del verdetto stesso, quindi una sicurezza WRONG il risultato ha un valore elevato confidenceScore altrettanto con sicurezza CORRECT uno lo fa. Quando ci sarà il verdetto WRONG, IL suggestedCategories L'elenco contiene gerarchie di categorie alternative, ciascuna con a confidence valore e ordinati dal più probabile al meno probabile. Quando ci sarà il verdetto CORRECT, suggestedCategories è vuoto.
Ti consigliamo di utilizzare il punteggio di confidenza per decidere quali risultati accettare automaticamente e quali indirizzare alla revisione manuale.
Convalida le categorie
Per convalidare le categorie, utilizzare il file categoriesValidate mutazione. Ogni articolo richiede a name e il categories gerarchia da convalidare. Facoltativamente puoi includere brand, material, description, amount, currencyCode, globalTradeItemNumber, E imageUrl per migliorare la precisione. Invia più elementi in un'unica richiesta per la convalida in blocco.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}Nell'esempio precedente, le categorie del primo articolo vengono confermate come CORRECT con grande fiducia e senza suggerimenti. Il secondo elemento è contrassegnato in modo sicuro WRONG, e il suggestedCategories L'elenco propone le categorie più adatte classificate in base alla confidenza.
Gestisci il tuo albero delle categorie
L'albero delle categorie della tua organizzazione è l'insieme dei percorsi delle categorie che Zonos conosce utilizzati dalla tua organizzazione. La convalida della categoria disegna il suo suggestedCategories da questo albero, quindi mantenerlo accurato e completo migliora direttamente la qualità dei suggerimenti. Categorie a cui ti invii categoriesValidate vengono aggiunti all'albero automaticamente, ma puoi anche gestirli direttamente.
Ogni categoria è una gerarchia archiviata come file path matrice, dalla radice ampia alla foglia specifica, ad esempio, ["Footwear", "Athletic", "Running Shoes"].
Elenca le tue categorie
Usa il categories query per recuperare l'albero delle categorie della tua organizzazione. I risultati sono impaginati.
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}Aggiungi categorie
Usa il categoriesCreate mutazione per aggiungere uno o più percorsi di categoria al tuo albero. Ciò è utile per seminare l'albero prima della convalida in modo che i suggerimenti possano attingere alla tassonomia completa.
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}Aggiorna o rimuovi categorie
Usa il categoryUpdate mutazione per correggere una categoria path dal suo id, o il categoryDelete mutazione per rimuovere una categoria che non si applica più. L'eliminazione delle categorie obsolete o errate mantiene i suggerimenti pertinenti.
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}Per rimuovere una categoria, passala id al categoryDelete mutazione. Ritorna SUCCESS O FAILURE.
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Convalida della categoria
Controlla se le categorie assegnate a un articolo si adattano al prodotto e ottieni suggerimenti migliori sulle categorie quando non lo fanno.