Una categoria è una designazione che descrive un'entità. Ad esempio, se venisse creata un'entità di sede per Yext, la categoria sarebbe azienda di software.

Le categorie sono principalmente utilizzate nei Listing, dove aiutano publisher come Google a indicizzare correttamente aziende e professionisti del settore. Sono strutturate in modo gerarchico e in genere sono composte da una categoria principale e da categorie secondarie. Ad esempio, un'entità per un professionista sanitario specializzato in dermatologia potrebbe avere una categoria di Salute e medicina > Specializzazioni mediche > Dermatologia.

Le categorie sono inoltre limitate a un tipo di entità, il che significa che alle entità possono essere assegnate solo categorie rilevanti per il loro tipo di entità. Ad esempio, la categoria "Ristorante" non può essere assegnata a un'entità Evento.

A ciascuna entità può essere assegnata una categoria principale e fino a nove categorie aggiuntive, per un totale di 10 categorie di base. (10 categorie è il numero massimo di categorie per entità che Google e altri publisher generalmente accettano.)

L'aggiunta di categorie alle tue entità è un passaggio importante per garantire che i listings delle tue entità compaiano nelle ricerche pertinenti. Tutte le categorie elencate in Yext sono predefinite per garantire che le entità siano elencate correttamente nei vari siti dei publisher.

Modifica il campo Categoria su un'entità

1. Fai clic su Knowledge Graph nella barra di navigazione, quindi su Entità.
2. Fai clic sull'entità da modificare.
   • Per modificare più entità contemporaneamente, consulta l'articolo Modificare le entità in blocco.
3. Fai clic sul campo Categorie.

Segua i passaggi indicati per apportare le modifiche desiderate.

Aggiungi una categoria 

1. Fai clic su + Aggiungi una categoria.
2. Inserisci le prime lettere della categoria desiderata nella casella di testo e selezionala dall'elenco.

Elimina una categoria

1. Fai clic sull'icona del cestino accanto alla categoria che desideri eliminare. Riordina le categorie
2. Trascina e rilascia le categorie su un'entità nell'ordine che preferisci.
   • Le categorie andrebbero ordinate per importanza. La prima categoria è quella principale.

Salva modifiche

1. Dopo aver apportato le modifiche, fai clic su Salva. Prima di procedere, leggi l'avviso.
2. Fai clic su Vorrei modificare le mie categorie per salvare le modifiche.

Sostituire la categoria di un'entità

Yext utilizza il campo Categoria sulle entità per abbinare l'entità alla categoria più appropriata su ciascun publisher. Ciascun publisher ha il proprio insieme di categorie. 

Su Yext, è possibile vedere esattamente come è categorizzata un'entità su ciascun publisher e apportare modifiche se desiderato. Puoi anche sostituire queste mappature per i singoli publisher.

1. Fai clic su Knowledge Graph nella barra di navigazione, quindi su Entità.
2. Fai clic sull'entità da modificare.
   • Per modificare più entità contemporaneamente, consulta l'articolo Modificare le entità in blocco.
3. Fai clic per espandere il campo Categorie. Poi, clicca su Avanzate in basso a destra dell'area del campo.
   
   

5. La finestra modale di Gestione avanzata delle categorie elenca le categorie in cui l'entità scelta appare per ciascun publisher. I publisher sono elencati nella barra laterale sinistra e il numero accanto a ciascun publisher indica in quante categorie l'entità è attualmente elencata.
   
   
   
    
6. Fai clic su un publisher per visualizzare le categorie. Per aggiungere altre categorie per quel publisher, o modificare le categorie, seleziona la casella Sostituisci categorie per [Nome del publisher].
   • Per aggiungere una categoria all'elenco, fai clic su Aggiungi una categoria.
   • Per eliminare una categoria, fai clic sull'icona del cestino accanto alla categoria che desideri rimuovere.
7. Una volta finito, fai clic su Applica.

Esportare un elenco di categorie

Le categorie aiutano a inserire la tua attività nella categoria corretta all'interno della rete Publisher Network. Yext dispone di un elenco predeterminato di categorie mappate alle categorie di ogni sito della rete Publisher Network. Può esportare un elenco di categorie idonee per ogni entità e per ciascun paese disponibile su Yext.

Per esportare un elenco di categorie:

1. Fai clic su Knowledge Graph nella barra di navigazione, quindi su Configurazione.
2. Fai clic su Liste di categoria.
3. Seleziona il tipo di entità e il Paese per il quale desideri creare un elenco di categorie idonee.
4. Seleziona la lingua del download.
5. Fai clic sul pulsante Scarica per esportare l'elenco delle categorie.

Puoi utilizzare questa esportazione per aggiornare in blocco entità nuove o esistenti. Consulta la documentazione Carica entità in blocco tramite Caricamento entità per saperne di più.

Permessi di gestione delle categorie

Liste della categoria

Una lista delle categorie è un elenco consolidato di categorie disponibili. Ogni publisher ha la propria lista delle categorie, con la propria tassonomia di nomi di categorie e ID interni (ad esempio, la categoria "Studio contabile" di Google ha un ID gcid:accounting_firm).

Yext gestisce una lista delle categorie e memorizza anche vari elenchi di categorie dei publisher per mappare correttamente le categorie su un'entità tra diversi publisher. Sebbene queste liste non siano esposte nella piattaforma, molti publisher rendono disponibili al pubblico le proprie liste delle categorie.

Di seguito sono riportate alcune liste delle categorie di publisher comunemente utilizzate:

• Profilo dell'attività su Google 
• Bing Places per le aziende 
• Yelp  > Ottieni tutti gli endpoint delle categorie 

Mappature delle categorie

Le mappature delle categorie aggiornano le categorie sulle entità tra le liste delle categorie dei publisher, in modo che la categoria rimanga coerente da un publisher all'altro. Yext gestisce queste mappature di categorie tra la lista delle categorie Yext e le liste delle categorie dei singoli publisher.

Una volta che una categoria è assegnata a un'entità, Yext determina a quali categorie negli elenchi dei publisher mappare la categoria assegnata.

Elenco delle categorie di base e delle sostituzioni delle categorie

Come menzionato sopra, Yext gestisce la propria lista delle categorie e le associa alle diverse liste dei publisher. Se una mappatura viene determinata come errata, è disponibile anche un'opzione per sostituire una mappatura di categoria.

La lista delle categorie base (o "lista base") esiste in ogni account Yext e elenca le categorie disponibili per l'assegnazione alle entità. Le categorie della lista di base sono quelle che compaiono quando si effettua una ricerca nel campo Categorie su un'entità.

Sostituzioni delle categorie

Se un utente o un publisher non è d'accordo con una mappatura delle categorie in Yext, o se una categoria della lista base non può essere mappata a un determinato publisher, la categoria può essere modificata con una sostituzione di categoria. Le sostituzioni di categoria consentono a un utente o a un sistema (ad esempio un connettore o un'app) di specificare una categoria direttamente dalla lista delle categorie di un publisher, sostituendo la mappatura configurata da Yext.

Ad esempio: la categoria principale di una sede in Yext è impostata su "Servizi alle imprese > Servizi informatici", che Yext mappa alla categoria "Assistenza e servizi informatici" su Google. Se desiderassi modificare questa impostazione per utilizzare piuttosto la categoria "Servizi di riparazione computer" su Google, potresti sostituire la categoria del profilo dell'attività su Google.

Impatto della categoria sugli attributi Google

Le categorie possono anche influenzare gli attributi di Google. I campi per gli attributi di Google appariranno solo per le entità con listing sincronizzati con il profilo dell'attività su Google. Gli attributi disponibili variano in base alla categoria, al paese e al profilo linguistico.

Ad esempio, un'entità Ristorante con la categoria «Ristorante messicano» potrebbe avere attributi come:

• È disponibile il guardaroba.
• Menu per bambini
• Ha un bar in loco.
• Ha la consegna senza contatto.

Google aggiungerà attributi e li renderà disponibili per le categorie nel tempo. Se cambi la categoria della tua entità, potresti vedere un cambiamento negli attributi disponibili.

Connettori

Quando si importano dati tramite un connettore, è possibile mappare i valori delle colonne al campo Categorie nella fase di mappatura.

Se stai raccogliendo dati di Listings da un publisher supportato, puoi impostare la categoria Yext con la trasformazione Associa le categorie del publisher. Questo converte l'ID della categoria del publisher nell'ID della categoria Yext mappato. Ad esempio, questa trasformazione convertirà la categoria gcid:apartment_building dal profilo dell'attività su Google all'ID categoria corrispondente su Yext 1686.

Puoi anche sostituire le mappature delle categorie nei Connettori. Nella fase di mappatura della configurazione del connettore, mappa l'ID della categoria publisher al campo secondario appropriato per l'endpoint publisher desiderato.

Attualmente, i connettori supportano solo la mappatura alle seguenti liste di categorie:

• Elenco delle categorie di base (Yext)
• Apple
• Bing
• Argomenti di Facebook Place
• Profilo dell'attività su Google
• Listing su TripAdvisor

Note generali sulle categorie nei connettori:

• Le categorie sono assegnate nell'ordine di ricezione dal connettore. La prima categoria ricevuta dal connettore sarà la categoria principale, e tutte le categorie successive saranno trattate come categorie aggiuntive.
• Connettori offre una fonte nativa per il profilo dell'attività su Google. Se stai acquisendo dati dal profilo dell'attività su Google, dai un'occhiata al documento di riferimento del profilo dell'attività su Google.

Suggerimenti API

Le sostituzioni di categoria possono essere visualizzate nell'API Suggerimenti. I publisher inviano comunemente le categorie di sostituzione tramite il sistema Suggerimenti, via Suggerimenti dei publisher. L'API Suggerimenti restituisce suggerimenti sulle sostituzioni di categoria oltre alle categorie della lista base.

Tieni presente che per visualizzare le sostituzioni di categoria nell'API Suggerimenti, il parametro v deve essere maggiore o uguale a 20230401.

Utilizza l'endpoint Ottieni o Elenca per visualizzare i suggerimenti. Ecco un esempio di risposta:

"response": {
       "suggestions": [
           {
               "uid": "12345678",
               "accountId": "1234567",
               "createdDate": "2023-02-02T13:53:54Z",
               "lastUpdatedDate": "2023-02-02T13:53:54Z",
               "source": {
                   "appId": "12345"
               },
               "entityFieldSuggestion": {
                   "entity": {
                       "id": "my-entity",
                       "uid": "12345678",
                       "type": "location",
                       "folderId": "",
                       "labels": []
                   },
                   "existingContent": {
                       "categories": {
                           "yext": [
                               "1"
                           ],
                           "apple": [
                               "localservices.itservices"
                           ],
                           "googleBusinessProfile": [
                               "gcid:software_training_institute"
                           ]
                       }
                   },
                   "suggestedContent": {
                       "categories": {
                           "yext": [
                               "2"
                           ],
                           "apple": [
                               "localservices.itservices",
                               "professional.softwaredevelopment"
                           ],
                           "bing": [
                               "123456",
                               "234567"
                           ],
                           "googleBusinessProfile": [
                               "gcid:software_company"
                           ]
                       }
                   }
               },
               "status": "PENDING",
               "locked": false,
               "comments": []
           }
	}
}

Presta attenzione alla struttura dell'oggetto categorie:

{
	"categories": {
		"yext":["2"],
		"googleBusinessProfile":["gcid:software_company"]
	}
}

L'oggetto categories include:

• ID della lista base (di solito yext). La lista base viene sempre restituita.
  • ID di categoria Yext (numerico)
• ID dell'elenco dei publisher (ad esempio, googleBusinessProfile)
  • Array di valori corrispondenti agli ID delle categorie dei publisher. Questi sono determinati dal publisher (ad esempio, gcid:software_company).

L'oggetto categories include una proprietà per il particolare elenco di categorie solo se è specificamente imposta. Pertanto, il numero di proprietà nell'oggetto è pari a 1 + il numero di sostituzioni configurate.

Utilizza l'endpoint Upsert per creare un suggerimento. Ecco un esempio di richiesta:

"entityFieldSuggestion": {
       "entity": {
           "uid": "{entity_uid}"
       },
       "suggestedContent": {
           "categories": {
               "googleBusinessProfile": [
                   "gcid:software_company"
               ],
		    "yext":["291","1234"]
           }
       }
   }

I suggerimenti di categoria effettuati tramite l'API Suggerimenti sono parziali. In altre parole, le categorie fornite per proprietà (ad esempio, googleBusinessProfile) sono considerate complete, ma qualsiasi proprietà lasciata fuori dal payload della richiesta rimarrà intatta.

Per ulteriori informazioni sull'invio di richieste all'API Suggerimenti, consulta la documentazione dell'API Suggerimenti.