Kategorien für Entitäten verwalten

Eine Kategorie ist eine Bezeichnung, die eine Entität beschreibt. Wenn zum Beispiel eine Standort-Entität für Yext erstellt wird, lautet die Kategorie Softwareunternehmen.

Kategorien werden hauptsächlich in Listings verwendet, wo sie Publishern wie Google helfen, Unternehmen und Branchenexperten richtig zu indexieren. Sie sind hierarchisch strukturiert und bestehen in der Regel aus einer übergeordneten Kategorie und Unterkategorien. Zum Beispiel könnte eine Einheit für einen medizinischen Facharzt, der sich auf Dermatologie spezialisiert hat, eine Kategorie von Gesundheit & Medizin > Medizinische Fachrichtungen > Dermatologie haben.

Kategorien sind außerdem auf einen Entitätstyp beschränkt, was bedeutet, dass Entitäten nur Kategorien zugewiesen werden können, die für ihren Entitätstyp relevant sind. Zum Beispiel kann die „Restaurant“-Kategorie nicht einer Event-Entität zugewiesen werden.

Jeder Entität kann eine Hauptkategorie und bis zu neun zusätzliche Kategorien zugewiesen werden, insgesamt 10 Basiskategorien. (10 Kategorien sind die maximale Anzahl pro Entität, die Google und andere Publisher normalerweise akzeptieren.)

Das Hinzufügen von Kategorien zu Ihren Entitäten ist wichtig, um zu gewährleisten, dass die Einträge für Ihre Entitäten in relevanten Suchergebnissen angezeigt wird. Alle in Yext aufgeführten Kategorien sind vorab festgelegt, damit Ihre Entitäten auf allen Publisher-Websites richtig aufgeführt wird.

Das Kategoriefeld einer Entität bearbeiten

Klicken Sie in der Navigationsleiste auf Knowledge Graph und dann auf Entitäten.
Klicken Sie auf die Entität, die Sie bearbeiten möchten.
- Informationen dazu, wie Sie mehrere Entitäten gleichzeitig bearbeiten können, finden Sie in dem Artikel Sammelbearbeitung von Entitäten.
Klicken Sie auf das Feld Kategorien.

Führen Sie die folgenden Schritte aus, um die gewünschten Änderungen vorzunehmen:

Kategorie hinzufügen

Klicken Sie auf Kategorie hinzufügen.
Geben Sie die ersten paar Buchstaben der gewünschten Kategorie in das Textfeld ein und wählen Sie die zutreffende Option aus der angezeigten Liste aus.

Kategorie löschen

Klicken Sie auf das Papierkorbsymbol neben der Kategorie, die Sie löschen möchten. Kategorien neu ordnen
Ziehen Sie Kategorien auf einer Entität per Drag & Drop in die von Ihnen gewünschte Reihenfolge.
- Kategorien sollten der Reihenfolge ihrer Bedeutung nach geordnet werden. Die erste Kategorie ist die Hauptkategorie.

Änderungen speichern

Nachdem Sie Ihre Änderungen vorgenommen haben, klicken Sie auf Speichern. Bitte lesen Sie die Warnmeldung, bevor Sie fortfahren.
Klicken Sie auf Ich möchte meine Kategorien ändern, um Ihre Änderungen zu speichern.

Überschreiben der Kategorie einer Entität

Yext verwendet das Kategoriefeld bei Entitäten, um die Entität der am besten geeigneten Kategorie bei jedem Publisher zuzuordnen. Jeder Publisher hat seine eigenen Kategorien.

In Yext können Sie genau sehen, wie eine Entität bei jedem Publisher kategorisiert wird, und bei Bedarf Änderungen vornehmen. Sie können diese Zuordnungen auch für einzelne Publisher überschreiben.

Klicken Sie in der Navigationsleiste auf Knowledge Graph und dann auf Entitäten.
Klicken Sie auf die Entität, die Sie bearbeiten möchten.
- Informationen darüber, wie Sie mehrere Entitäten gleichzeitig bearbeiten, finden Sie im Artikel Sammelbearbeitung von Entitäten.
Klicken Sie, um das Feld Kategorien zu erweitern. Klicken Sie dann unten rechts im Feldbereich auf Erweitert.

Das Modal Erweiterte Kategorieverwaltung listet die Kategorien auf, in denen die gewählte Entität bei jedem einzelnen Publisher erscheint. Die Publisher sind in der linken Seitenleiste aufgelistet, und die Zahl neben jedem Publisher gibt an, unter wie vielen Kategorien die Entität derzeit aufgeführt ist.
Klicken Sie auf einen Publisher, um die Kategorien anzuzeigen. Um weitere Kategorien für diesen Publisher hinzuzufügen oder die Kategorien zu ändern, aktivieren Sie das Kontrollkästche Kategorien für [[Publisher-Name]] überschreiben.
- Um der Liste eine Kategorie hinzuzufügen, klicken Sie auf Kategorie hinzufügen.
- Um eine Kategorie zu löschen, klicken Sie auf das Papierkorbsymbol neben der Kategorie, die Sie entfernen möchten.
Wenn Sie fertig sind, klicken Sie auf anwenden.

Eine Kategorieliste exportieren

Kategorien tragen dazu bei, dass Ihr Unternehmen im ganzen Publisher-Netzwerk korrekt aufgeführt ist. Yext hat eine vorab festgelegte Liste von Kategorien, die den Kategorien auf jeder Seite im Publisher-Netzwerk zugeordnet sind. Sie können eine Liste der in Frage kommenden Kategorien für jede Entität und jedes verfügbare Land aus Yext exportieren.

So exportieren Sie eine Kategorieliste:

Klicken Sie in der Navigationsleiste auf Knowledge Graph und dann auf Konfiguration.
Klicken Sie auf Kategorielisten.
Wählen Sie den Entitätstyp und das Land aus, für die Sie eine Liste zulässiger Kategorien wünschen.
Wählen Sie Ihre Download-Sprache.
Klicken Sie auf die Schaltfläche Herunterladen, um die Kategorieliste zu exportieren.

Sie können diesen Export verwenden, um neue oder bestehende Entitäten in großen Mengen zu aktualisieren. Weitere Informationen finden Sie in der Dokumentation zum Sammelupload von Entitäten über Entity-Upload.

Berechtigungen für die Kategorienverwaltung

Sie benötigen die folgenden Berechtigungen, um Kategorien zu verwalten:

Bearbeitungszugriff auf das Kategorienfeld
Optional: Zugriff zur Änderung von Kategorien (standardmäßig können Yext-Kunden keine Kategorien bearbeiten, sobald sie gesetzt sind. Um Zugang zu den geänderten Kategorien zu erhalten, wenden Sie sich bitte an Ihren Customer Success Manager).

Kategorielisten

Eine Kategorienliste ist eine konsolidierte Liste verfügbarer Kategorien. Jeder Anbieter verfügt über eine eigene Kategorienliste mit einer eigenen Taxonomie von Kategorienamen und internen IDs (beispielsweise hat die Kategorie „Wirtschaftsprüfungsgesellschaft“ von Google die ID gcid:accounting_firm).

Yext verwaltet eine Kategorieliste und speichert auch verschiedene Publisher-Kategorielisten, um die Kategorien einer Entität zwischen verschiedenen Publishern richtig zuordnen zu können. Diese Listen werden zwar auf der Plattform nicht angezeigt, viele Publisher stellen ihre eigenen Kategorienlisten aber öffentlich zur Verfügung.

Nachfolgend einige häufig verwendete Publisher-Kategorielisten:

Kategoriezuordnungen

Kategoriezuordnungen übersetzen Kategorien von Entitäten zwischen Publisher-Kategorienlisten, sodass die Kategorie von einem Publisher zum anderen konstant bleibt. Yext verwaltet diese Kategoriezuordnungen zwischen der Yext-Kategorieliste und den Kategorielisten der einzelnen Publisher.

Sobald einer Entität eine Kategorie zugewiesen wurde, bestimmt Yext, welchen Kategorien in den Kategorielisten der Publisher die zugewiesene Kategorie zugeordnet wird.

Wie oben erwähnt, unterhält Yext eine eigene Kategorienliste und ordnet diese verschiedenen Publisherlisten zu. Falls sich eine Zuordnung als fehlerhaft erweist, besteht auch die Möglichkeit, eine Kategorienzuordnung zu überschreiben.

Die Basis-Kategorienliste (oder „Basisliste“) existiert in jedem Yext-Konto und listet die Kategorien auf, die für die Zuordnung zu Entitäten verfügbar sind. Die Kategorien der Basisliste werden angezeigt, wenn Sie im Feld Kategorien einer Entität suchen.

Überschreibungen der Kategorie

Wenn Nutzer*innen oder ein Publisher mit einer Kategorienzuordnung in Yext nicht einverstanden ist oder wenn eine Basislistenkategorie keinem bestimmten Publisher zugeordnet werden kann, kann die Kategorie mit einer Kategorie-Überschreibung geändert werden. Kategorie-Überschreibungen ermöglichen es Nutzer*innen oder Systemen (z. B. einem Connector oder einer App), eine Kategorie direkt aus einer Publisher-Kategorieliste anzugeben und damit die von Yext konfigurierte Zuordnung zu überschreiben.

Zum Beispiel: Die primäre Kategorie eines Standorts in Yext ist auf „Unternehmensdienstleistungen > Computerdienstleistungen“ gesetzt, was Yext der Kategorie „Computer-Support und -Dienste“ auf Google zuordnet. Wenn Sie stattdessen die Kategorie „Computerreparaturservice“ bei Google verwenden möchten, können Sie die Kategorie im Google-Unternehmensprofil überschreiben.

Kategorie-Auswirkungen auf Google-Attribute

Kategorien können sich auch auf Google-Attribute auswirken. Felder für Google-Attribute werden nur für Entitäten angezeigt, deren Listings mit dem Google Unternehmensprofil synchronisiert sind. Verfügbare Attribute variieren je nach Kategorie, Land und Sprachprofil.

Zum Beispiel könnte eine Restaurant-Entität mit der Kategorie „Mexikanisches Restaurant“ folgende Attribute haben:

Verfügt über eine Garderobe
Hat eine Kinderspeisekarte
Bar vor Ort
Keine kontaktlose Lieferung

Google fügt im Laufe der Zeit Attribute hinzu und stellt sie für Kategorien zur Verfügung. Wenn Sie die Kategorie Ihrer Entität ändern, könnten sich die verfügbaren Attribute ändern.

Connectors

Beim Import von Daten über einen Konnektor können Sie Spaltenwerte im Zuordnungsschritt dem Feld Kategorien zuordnen.

Wenn Sie Listings-Daten von einem unterstützten Publisher abrufen, können Sie die Yext-Kategorie über Publisher-Kategorien zuordnen umwandeln. Dadurch wird die Publisher-Kategorie-ID in die zugeordnete Yext-Kategorie-ID umgewandelt. Dadurch wird beispielsweise die Kategorie gcid:apartment_building aus dem Google Unternehmensprofil in die entsprechende Yext-Kategorie-ID 1686 umgewandelt.

Sie können auch Kategoriezuordnungen in Connectors überschreiben. Ordnen Sie in der Zuordnungsphase Ihrer Connector-Konfiguration die Publisher-Kategorie-ID dem entsprechenden Unterfeld für den gewünschten Publisher-Endpunkt zu.

Derzeit unterstützen Connectors nur die Zuordnung zu den folgenden Kategorielisten:

Basis-Kategorienliste (Yext)
Apple
Bing
Facebook Place Topics
Google Unternehmensprofil
TripAdvisor-Listing

Allgemeine Hinweise zu Kategorien in Connectors:

Kategorien werden in der Reihenfolge zugewiesen, in der sie vom Connector empfangen werden. Die erste vom Connector empfangene Kategorie ist die primäre Kategorie und alle nachfolgenden Kategorien werden als zusätzliche Kategorien behandelt.
Connectors bietet eine native Quelle für das Google Unternehmensprofil. Wenn Sie Daten aus dem Google Unternehmensprofil erfassen, werfen Sie einen Blick auf die Google Unternehmensprofil-Referenz.

Vorschlags-API

Kategorieüberschreibungen können in der Vorschlags-API eingesehen werden. Publisher versenden normalerweise Überschreibungskategorien über das Vorschlagssystem, genauer gesagt über die Funktion „Publisher-Vorschläge“. Die Vorschlags-API liefert zusätzlich zu den Kategorien der Basisliste Vorschläge für die Überschreibung von Kategorien.

Beachten Sie, dass der Parameter v größer oder gleich 20230401 sein muss, um Kategorieüberschreibungen in der Vorschlags-API anzuzeigen.

Verwenden Sie den Endpunkt Abrufen oder Auflisten, um Vorschläge anzuzeigen. Hier ist eine Beispielantwort:

Kopie

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

Beachten Sie die Struktur des Objekts Kategorien:

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

Das Objekt Kategorien umfasst:

Basislisten-ID (meist yext). Die Basisliste wird immer zurückgegeben.
- Yext Kategorie-ID (numerisch)
Publisher-Listen-ID (z. B. googleBusinessProfile)
- Array von Werten, die den Publisher-Kategorie-IDs entsprechen. Diese werden vom Publisher bestimmt (z. B. gcid:software_company)

Das Objekt Kategorien enthält nur dann eine Eigenschaft für die jeweilige Kategorienliste, wenn diese ausdrücklich festgelegt ist. Daher ist die Anzahl der Eigenschaften im Objekt gleich 1 + der Anzahl der gesetzten Überschreibungen.

Verwenden Sie den API-Endpunkt Upsert, um einen Vorschlag zu erstellen. Hier ist eine Beispielanfrage:

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

Kategorievorschläge, die über die Vorschlags-API gemacht werden, gelten teilweise. Mit anderen Worten: Kategorien, die pro Eigenschaft bereitgestellt werden (z. B. googleBusinessProfile), gelten als umfassend, aber alle Eigenschaften, die in der Anfragenutzlast fehlen, bleiben unberührt.

Weitere Informationen zum Stellen von Anfragen an die Vorschlags-API finden Sie in der Dokumentation der Vorschlags-API.