Gérer les catégories sur les entités

Une catégorie est une désignation qui décrit une entité. Par exemple, si une entité d'établissement était créée pour Yext, sa catégorie serait éditeur de logiciels.

Les catégories sont principalement utilisées dans les listings, où elles aident les annuaires comme Google à indexer correctement les entreprises et les professionnels du secteur. Elles sont structurées hiérarchiquement et sont généralement composées d'une catégorie mère et de sous-catégories. Par exemple, une entité destinée à un professionnel de santé spécialisé en dermatologie pourrait appartenir à la catégorie Santé & médecine > Médecine spécialisée > Dermatologie.

Les catégories sont également limitées à un type d'entité, ce qui signifie que les entités peuvent uniquement se voir attribuer des catégories pertinentes pour leur type d'entité. Par exemple, la catégorie « Restaurant » ne peut pas être attribuée à une entité de type Événement.

Chaque entité peut se voir attribuer une catégorie principale et jusqu'à neuf catégories supplémentaires, soit un total de 10 catégories de base. (10 catégories correspondent au nombre maximal de catégories par entité généralement accepté par Google et les autres annuaires.)

L'ajout de catégories à vos entités est une étape importante pour vous assurer que les fiches de vos entités apparaîtront dans les recherches pertinentes. Toutes les catégories que vous voyez dans Yext sont prédéterminées pour garantir que les entités sont correctement répertoriées sur les sites d'annuaire.

Modifier le champ Catégorie d'une entité

Cliquez sur Knowledge Graph dans la barre de navigation, puis sur Entités.
Cliquez sur l'entité que vous souhaitez modifier.
- Pour modifier plusieurs entités en même temps, consultez l'article Modifier plusieurs entités à la fois.
Cliquez sur le champ Catégories.

Suivez les étapes ci-dessous pour apporter les modifications souhaitées :

Ajouter une catégorie

Cliquez sur Ajouter une catégorie.
Dans la zone de texte, saisissez les premières lettres de la catégorie souhaitée, puis sélectionnez-la dans la liste qui apparaît.

Supprimer une catégorie

Cliquez sur l'icône de la corbeille à côté de la catégorie que vous souhaitez supprimer. Réorganiser les catégories
Glissez-déposez les catégories d'une entité dans votre ordre préféré.
- Les catégories doivent être classées par ordre d'importance. La première catégorie est la catégorie primaire.

Enregistrer les modifications

Après avoir effectué vos modifications, cliquez sur Enregistrer. Lisez le message d'avertissement avant de continuer.
Cliquez sur Je souhaite modifier mes catégories pour enregistrer vos modifications.

Remplacer la catégorie d'une entité

Yext utilise le champ Catégorie des entités pour faire correspondre l'entité à la catégorie la plus pertinente de chaque annuaire. Chaque annuaire dispose de son propre ensemble de catégories.

Dans Yext, vous pouvez voir exactement comment une entité est classée chez chaque annuaire et apporter des modifications si besoin. Vous pouvez également remplacer ces mappages pour des annuaires individuels.

Cliquez sur Knowledge Graph dans la barre de navigation, puis sur Entités.
Cliquez sur l'entité que vous souhaitez modifier.
- Pour modifier plusieurs entités en même temps, consultez l'article Modifier plusieurs entités à la fois.
Cliquez pour développer le champ Catégories. Ensuite, cliquez sur Avancé en bas à droite de la zone de champ.

La fenêtre modale Gestion des catégories avancée répertorie les catégories dans lesquelles l'entité choisie apparaît individuellement pour chaque annuaire. Les annuaires sont répertoriés dans la barre latérale gauche, et le nombre en regard de chaque annuaire indique le nombre de catégories dans lesquelles l'entité est actuellement répertoriée.
Cliquez sur un annuaire pour voir les Catégories. Pour ajouter d'autres catégories pour cet annuaire ou modifier les catégories, cochez la case Remplacer les catégories pour [Nom de l'annuaire].
- Pour ajouter une catégorie à la liste, Ajouter une catégorie.
- Pour supprimer une catégorie, cliquez sur l'icône de la corbeille en regard de la catégorie que vous souhaitez supprimer.
Lorsque vous avez terminé, cliquez sur Appliquer.

Exporter une liste de catégories

Les catégories servent à répertorier votre entreprise sur l'ensemble du réseau d'éditeurs. Yext dispose d'une liste de catégories prédéterminées qui sont mappées aux catégories de chaque site du réseau d'annuaires. Vous pouvez exporter une liste de catégories éligibles pour chaque entité et chaque pays disponible à partir de Yext.

Pour exporter une liste de catégories :

Cliquez sur Knowledge Graph dans la barre de navigation, puis sur Configuration.
Cliquez sur Listes de catégories.
Sélectionnez le Type d'entité et le Pays pour lesquels vous souhaitez obtenir une liste de catégories éligibles.
Sélectionnez la Langue du téléchargement.
Cliquez sur le bouton Télécharger pour exporter la liste de catégories.

Vous pouvez utiliser cette exportation pour mettre à jour des entités nouvelles ou existantes en bloc. Pour en savoir plus, consultez l'article Charger des entités en bloc via le chargement d'entités.

Autorisations de gestion des catégories

Vous aurez besoin des autorisations suivantes pour gérer les catégories :

Accès en modification au champ Catégories
Facultatif : accès permettant de modifier les catégories (par défaut, les clients Yext ne peuvent pas modifier les catégories une fois qu'elles sont définies. Pour obtenir l'accès permettant de modifier les catégories, veuillez contacter votre responsable de la réussite client.)

Listes de catégories

Une liste de catégories est une liste regroupant toutes les catégories disponibles. Chaque annuaire dispose de sa propre liste de catégories, avec sa propre taxonomie de noms de catégories et d'identifiants internes (par exemple, la catégorie « cabinet comptable » de Google a pour identifiant gcid:accounting_firm).

Yext tient à jour une liste de catégories et stocke également plusieurs listes de catégories d'annuaires afin de mapper correctement les catégories d'une entité entre différents annuaires. Bien que ces listes ne soient pas exposées dans la plateforme, de nombreux annuaires rendent leurs propres listes de catégories accessibles publiquement.

Voici quelques listes de catégories d'annuaires couramment utilisées :

Mappage des catégories

Les mappages de catégories traduisent les catégories des entités entre les listes de catégories des annuaires, afin que la catégorie reste cohérente d'un annuaire à l'autre. Yext gère ces mappages de catégories entre la liste de catégories Yext et les listes de catégories des différents annuaires.

Une fois qu'une catégorie est attribuée à une entité, Yext détermine les catégories des listes des annuaires auxquelles mapper la catégorie attribuée.

Comme indiqué ci-dessus, Yext tient à jour sa propre liste de catégories et la mappe aux différentes listes d'annuaires. Si un mappage est jugé incorrect, il est également possible de remplacer un mappage de catégorie.

La liste de catégories de base, ou « liste de base », existe dans chaque compte Yext et répertorie les catégories disponibles pour attribution sur les entités. Les catégories de la liste de base sont celles qui apparaissent lorsque vous effectuez une recherche dans le champ Catégories d'une entité.

Remplacements de catégories

Si un utilisateur ou un annuaire n'est pas d'accord avec un mappage de catégorie dans Yext, ou si une catégorie de la liste de base ne peut pas être mappée à un annuaire donné, la catégorie peut être modifiée à l'aide d'un remplacement de catégorie. Les remplacements de catégories permettent à un utilisateur ou à un système (par exemple un connecteur ou une application) de spécifier une catégorie directement depuis la liste de catégories d'un annuaire, en remplaçant le mappage configuré par Yext.

Par exemple : la catégorie principale d'un établissement dans Yext est définie sur Services aux entreprises > Services informatiques, que Yext mappe à la catégorie Assistance et services informatiques sur Google. Si vous souhaitiez utiliser à la place la catégorie Réparation d'ordinateurs sur Google, vous pourriez remplacer la catégorie de la fiche d'établissement Google.

Impact des catégories sur les attributs Google

Les catégories peuvent également avoir une incidence sur les attributs Google. Les champs correspondant aux attributs Google s'affichent uniquement pour les entités dont les listings sont synchronisés avec les fiches d'établissement Google. Les attributs disponibles varient selon la catégorie, le pays et le profil de langue.

Par exemple, une entité de type Restaurant avec la catégorie Restaurant mexicain pourrait avoir des attributs comme :

Dispose d'un vestiaire
Propose un menu enfant
Dispose d'un bar sur place
Propose la livraison sans contact

Google ajoutera des attributs et les rendra disponibles pour certaines catégories au fil du temps. Si vous modifiez la catégorie de votre entité, vous pourrez constater un changement dans les attributs disponibles.

Connecteurs

Lorsque vous ingérez des données via un connecteur, vous pouvez mapper les valeurs de colonnes au champ Catégories à l'étape Mappage.

Si vous importez des données de Listings depuis un annuaire pris en charge, vous pouvez définir la catégorie Yext avec la transformation Mapper les catégories d'annuaire. Cette transformation convertit l'ID de catégorie de l'annuaire en ID de catégorie Yext mappé. Par exemple, cette transformation convertira la catégorie gcid:apartment_building des fiches d'établissement Google vers l'ID de catégorie Yext correspondant, 1686.

Vous pouvez également remplacer les mappages de catégories dans les Connecteurs. À l'étape Mappage de la configuration de votre connecteur, mappez l'ID de catégorie de l'annuaire au sous-champ approprié pour l'endpoint de l'annuaire souhaité.

Actuellement, les Connecteurs prennent uniquement en charge le mappage vers les listes de catégories suivantes :

Liste de catégories de base (Yext)
Apple
Bing
Sujets de lieu Facebook
Google Business Profile
Listing TripAdvisor

Remarques générales sur les catégories dans les Connecteurs :

Les catégories sont attribuées dans l'ordre dans lequel elles sont reçues par le connecteur. La première catégorie reçue par le connecteur sera la catégorie principale, et toutes les catégories suivantes seront traitées comme des catégories supplémentaires.
Les connecteurs proposent une source native pour les fiches d'établissement Google. Si vous importez des données depuis GBP, consultez cet article de référence sur les fiches d'établissement Google.

API Suggestions

Les remplacements de catégories peuvent être consultés dans l'API Suggestions. Les annuaires envoient couramment des catégories de remplacement via le système Suggestions, par le biais des Suggestions de l'annuaire. L'API Suggestions renvoie des suggestions de remplacements de catégories en plus des catégories de la liste de base.

Notez que pour consulter les remplacements de catégories dans l'API Suggestions, le paramètre v doit être supérieur ou égal à 20230401.

Utilisez l'endpoint Get ou List pour afficher les suggestions. Voici un exemple de réponse :

Copier

"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": []
           }
	}
}

Notez la structure de l'objet categories :

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

L'objet categories comprend :

L'ID de la liste de base (généralement yext). La liste de base est toujours renvoyée.
- L'ID de catégorie Yext (numérique).
L'ID de la liste de l'annuaire (par exemple, googleBusinessProfile).
- Un tableau de valeurs correspondant aux ID de catégorie de l'annuaire. Ces valeurs sont déterminées par l'annuaire (par exemple, gcid:software_company)

L'objet categories inclut uniquement une propriété pour une liste de catégories donnée si celle-ci est spécifiquement définie. Par conséquent, le nombre de propriétés dans l'objet est égal à 1 + le nombre de remplacements définis.

Utilisez l'endpoint Upsert pour créer une suggestion. Voici un exemple de requête :

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

Les suggestions de catégories effectuées via l'API Suggestions sont partielles. Autrement dit, les catégories fournies pour chaque propriété, par exemple googleBusinessProfile, sont considérées comme exhaustives, mais les propriétés omises dans la charge utile de la requête ne seront pas modifiées.

Pour plus d'informations sur les requêtes de l'API Suggestions, consultez la documentation de l'API Suggestions.