Le categorie di prodotto descrivono cos'è un articolo, solitamente come una gerarchia che va da una radice generica a una foglia specifica, ad esempio ["Footwear", "Athletic", "Running Shoes"]. Categorie accurate mantengono il catalogo pulito e alimentano processi a valle come la classificazione e la conformità commerciale, dove un articolo classificato in modo errato può produrre un risultato sbagliato.
I cataloghi accumulano errori di categoria nel tempo, a causa di inserimenti manuali, feed dei fornitori o migrazioni tra sistemi. La convalida delle categorie di Zonos verifica se le categorie assegnate a un articolo lo descrivono effettivamente e, quando non lo fanno, suggerisce categorie migliori tratte da quelle già utilizzate dalla tua organizzazione.
La convalida delle categorie di Zonos utilizza l'IA per stabilire se la gerarchia di categorie fornita descrive correttamente un articolo, in base al name dell'articolo e a eventuali altri dettagli forniti, come brand, material e description.
Per ogni articolo restituisce un verdict pari a CORRECT o WRONG, insieme a un punteggio di confidenza. Quando il verdetto è WRONG, viene restituito un elenco classificato di categorie suggerite, in modo da poter correggere l'assegnazione. I suggerimenti provengono dall'albero delle categorie della tua organizzazione, ovvero l'insieme dei percorsi di categoria che la tua organizzazione utilizza, e tutte le categorie che invii vengono aggiunte automaticamente a quell'albero, così un albero ben mantenuto produce suggerimenti migliori nel tempo.
Si tratta di un endpoint batch: puoi convalidare molti articoli in un'unica richiesta e i risultati vengono restituiti nello stesso ordine dell'input.
CORRECT — è plausibile che l'articolo appartenga alle categorie assegnate.
WRONG — l'articolo non appartiene alle categorie assegnate.
Ogni risultato include anche un confidenceScore compreso tra 0.0 e 1.0, che indica quanto il modello sia fiducioso nel verdetto restituito. Il punteggio riflette la certezza del verdetto in sé, quindi un risultato WRONG con alta sicurezza ha un confidenceScore elevato tanto quanto un risultato CORRECT con alta sicurezza. Quando il verdetto è WRONG, l'elenco suggestedCategories contiene gerarchie di categorie alternative, ciascuna con un valore confidence, ordinate dalla più probabile alla meno probabile. Quando 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.
Per convalidare le categorie, utilizza la mutazione categoriesValidate. Ogni articolo richiede un name e la gerarchia categories da convalidare. Facoltativamente puoi includere brand, material, description, amount, currencyCode, globalTradeItemNumber e imageUrl per migliorare la precisione. Invia più articoli in un'unica richiesta per convalidarli in blocco.
Nell'esempio precedente, le categorie del primo articolo vengono confermate come CORRECT con un'elevata sicurezza e senza suggerimenti. Il secondo articolo viene contrassegnato con sicurezza come WRONG e l'elenco suggestedCategories propone categorie più adatte, classificate in base alla confidenza.
L'albero delle categorie della tua organizzazione è l'insieme dei percorsi di categoria che Zonos sa essere utilizzati dalla tua organizzazione. La convalida delle categorie ricava i suoi suggestedCategories da questo albero, quindi mantenerlo accurato e completo migliora direttamente la qualità dei suggerimenti. Le categorie che invii a categoriesValidate vengono aggiunte automaticamente all'albero, ma puoi anche gestirlo direttamente.
Ogni categoria è una gerarchia memorizzata come array path, dalla radice generica alla foglia specifica, ad esempio ["Footwear", "Athletic", "Running Shoes"].
Elenca le tue categorie
Utilizza la query categories per recuperare l'albero delle categorie della tua organizzazione. I risultati sono impaginati.
1queryCategories{
2 categories(first:50){
3 totalCount
4 edges {
5 node {
6 id
7 path
8}
9}
10}
11}
Aggiungi categorie
Utilizza la mutazione categoriesCreate per aggiungere uno o più percorsi di categoria al tuo albero. Questo è utile per popolare l'albero prima della convalida, in modo che i suggerimenti possano attingere all'intera tassonomia.
Utilizza la mutazione categoryUpdate per correggere il path di una categoria tramite il suo id, oppure la mutazione categoryDelete per rimuovere una categoria non più valida. Eliminare le categorie obsolete o errate mantiene i suggerimenti pertinenti.
Convalida delle categorie
Convalida delle categorie
Controlla se le categorie assegnate a un articolo si adattano al prodotto e ottieni suggerimenti migliori sulle categorie quando non lo fanno.
Convalida delle categorie
Le categorie di prodotto descrivono cos'è un articolo, solitamente come una gerarchia che va da una radice generica a una foglia specifica, ad esempio
["Footwear", "Athletic", "Running Shoes"]. Categorie accurate mantengono il catalogo pulito e alimentano processi a valle come la classificazione e la conformità commerciale, dove un articolo classificato in modo errato può produrre un risultato sbagliato.I cataloghi accumulano errori di categoria nel tempo, a causa di inserimenti manuali, feed dei fornitori o migrazioni tra sistemi. La convalida delle categorie di Zonos verifica se le categorie assegnate a un articolo lo descrivono effettivamente e, quando non lo fanno, suggerisce categorie migliori tratte da quelle già utilizzate dalla tua organizzazione.
Come funziona
La convalida delle categorie di Zonos utilizza l'IA per stabilire se la gerarchia di categorie fornita descrive correttamente un articolo, in base al
namedell'articolo e a eventuali altri dettagli forniti, comebrand,materialedescription.Per ogni articolo restituisce un
verdictpari aCORRECToWRONG, insieme a un punteggio di confidenza. Quando il verdetto èWRONG, viene restituito un elenco classificato di categorie suggerite, in modo da poter correggere l'assegnazione. I suggerimenti provengono dall'albero delle categorie della tua organizzazione, ovvero l'insieme dei percorsi di categoria che la tua organizzazione utilizza, e tutte le categorie che invii vengono aggiunte automaticamente a quell'albero, così un albero ben mantenuto produce suggerimenti migliori nel tempo.Si tratta di un endpoint batch: puoi convalidare molti articoli in un'unica richiesta e i risultati vengono restituiti nello stesso ordine dell'input.
Verdetto e confidenza
Ogni risultato include un
verdict:CORRECT— è plausibile che l'articolo appartenga alle categorie assegnate.WRONG— l'articolo non appartiene alle categorie assegnate.Ogni risultato include anche un
confidenceScorecompreso tra0.0e1.0, che indica quanto il modello sia fiducioso nel verdetto restituito. Il punteggio riflette la certezza del verdetto in sé, quindi un risultatoWRONGcon alta sicurezza ha unconfidenceScoreelevato tanto quanto un risultatoCORRECTcon alta sicurezza. Quando il verdetto èWRONG, l'elencosuggestedCategoriescontiene gerarchie di categorie alternative, ciascuna con un valoreconfidence, ordinate dalla più probabile alla meno probabile. Quando 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, utilizza la mutazione
categoriesValidate. Ogni articolo richiede unnamee la gerarchiacategoriesda convalidare. Facoltativamente puoi includerebrand,material,description,amount,currencyCode,globalTradeItemNumbereimageUrlper migliorare la precisione. Invia più articoli in un'unica richiesta per convalidarli in blocco.mutation CategoriesValidate($input: [CategoryValidateInput!]!) {categoriesValidate(input: $input) {idnamecategoriesverdictconfidenceScoresuggestedCategories {categoryconfidence}}}Nell'esempio precedente, le categorie del primo articolo vengono confermate come
CORRECTcon un'elevata sicurezza e senza suggerimenti. Il secondo articolo viene contrassegnato con sicurezza comeWRONGe l'elencosuggestedCategoriespropone 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 di categoria che Zonos sa essere utilizzati dalla tua organizzazione. La convalida delle categorie ricava i suoi
suggestedCategoriesda questo albero, quindi mantenerlo accurato e completo migliora direttamente la qualità dei suggerimenti. Le categorie che invii acategoriesValidatevengono aggiunte automaticamente all'albero, ma puoi anche gestirlo direttamente.Ogni categoria è una gerarchia memorizzata come array
path, dalla radice generica alla foglia specifica, ad esempio["Footwear", "Athletic", "Running Shoes"].Elenca le tue categorie
Utilizza la query
categoriesper recuperare l'albero delle categorie della tua organizzazione. I risultati sono impaginati.query Categories {categories(first: 50) {totalCountedges {node {idpath}}}}Aggiungi categorie
Utilizza la mutazione
categoriesCreateper aggiungere uno o più percorsi di categoria al tuo albero. Questo è utile per popolare l'albero prima della convalida, in modo che i suggerimenti possano attingere all'intera tassonomia.mutation CategoriesCreate($input: [CategoryCreateInput!]!) {categoriesCreate(input: $input) {idpath}}Aggiorna o rimuovi categorie
Utilizza la mutazione
categoryUpdateper correggere ilpathdi una categoria tramite il suoid, oppure la mutazionecategoryDeleteper rimuovere una categoria non più valida. Eliminare le categorie obsolete o errate mantiene i suggerimenti pertinenti.mutation CategoryUpdate($input: CategoryUpdateInput!) {categoryUpdate(input: $input) {idpath}}Per rimuovere una categoria, passa il suo
idalla mutazionecategoryDelete. RestituisceSUCCESSoFAILURE.mutation CategoryDelete($id: ID!) {categoryDelete(id: $id)}CategoryCreateInput CategoryUpdateInput CategoryValidateInput
categoriesCreate categoriesValidate categoryDelete categoryUpdate
Questa pagina è stata utile?