エンティティのカテゴリーを管理

カテゴリーとはエンティティを説明する呼称です。たとえば、Yext用に場所エンティティを作成した場合、そのカテゴリーはソフトウェア会社になります。

カテゴリーは主にListingsで使用され、Googleなどのパブリッシャーが企業や業界の専門家を適切にインデックス化するのに役立ちます。階層的な構造で、通常は親カテゴリーとサブカテゴリーで構成されています。たとえば、皮膚科を専門とする医療専門家のエンティティには、健康と医療 > 医療専門分野 > 皮膚科というカテゴリーが存在する可能性があります。

また、カテゴリーはエンティティタイプに範囲が限定されています。これは、エンティティはエンティティタイプに関連するカテゴリにのみ割り当てることができるという意味です。たとえば、「レストラン」のカテゴリーをイベントのエンティティに割り当てることはできません。

各エンティティには、1つの主要カテゴリーと最大9つの追加カテゴリーを割り当てることができ、合計で10の基本カテゴリーを設定できます。（10件のカテゴリーは、Googleや他のパブリッシャーが通常受け入れるエンティティごとのカテゴリーの最大数です。）

エンティティにカテゴリーを追加することは、エンティティのリスティングが関連する検索で確実に表示されるようにするためには、重要なステップです。Yextで一覧表示されるカテゴリーはすべて、さまざまなパブリッシャーのサイトを通じてエンティティが正確に表示されるよう、事前定義されています。

エンティティのカテゴリーフィールドを編集する

ナビゲーションバーにある[Knowledge Graph]をクリックし、[エンティティ（Entities）]をクリックします。
編集するエンティティをクリックします。
- 複数のエンティティを一度に編集するには、「エンティティを一括編集する」を参照してください。
[カテゴリー（Categories）]フィールドをクリックします。

以下の手順に従って必要な変更を加えます。

カテゴリーを追加

[カテゴリーを追加（Add a category）] をクリックします。
目的のカテゴリーの最初の数文字をテキスト・ボックスに入力し、表示されたリストから選択します。

カテゴリの削除

削除するカテゴリーの横にあるゴミ箱アイコンをクリックします。カテゴリーを並べ替えます
エンティティのカテゴリーをドラッグ&ドロップして好きな順序にします。
- カテゴリーは、重要度の順に配置する必要があります。最初のカテゴリーは主要なカテゴリーです。

変更を保存

変更後、[保存（Save）]をクリックします。作業を進める前に、警告文をお読みください。
[カテゴリーを変更する（I’d like to change my categories）]をクリックして変更内容を保存します。

エンティティのカテゴリーを上書きする

Yextはエンティティのカテゴリーフィールドを使用して、各パブリッシャーの最も適切なカテゴリーにエンティティを一致させます。各パブリッシャーには独自のカテゴリーセットがあります。

Yextでは、各パブリッシャーでエンティティが分類される方法を正確に確認し、必要に応じて変更を加えることができます。また、個々のパブリッシャーごとにこれらのマッピングを上書きすることもできます。

ナビゲーションバーにある [Knowledge Graph] をクリックし、[エンティティ] をクリックします。
編集するエンティティをクリックします。
- 複数のエンティティを一括編集するには「エンティティを一括編集する」を参照してください。
[カテゴリー] フィールドをクリックして展開します。次に、フィールド領域の右下にある [詳細設定] をクリックします。

詳細なカテゴリー管理モーダルには、選択されたエンティティが各パブリッシャーで表示されるカテゴリーが一覧表示されます。パブリッシャーは左側のサイドバーに表示されており、各パブリッシャーの横の数字は、エンティティが現在いくつのカテゴリーにリストされているかを示します。
パブリッシャーをクリックするとカテゴリーが表示されます。そのパブリッシャーのカテゴリーを追加するか、カテゴリーを変更するには、[[パブリッシャー名] のカテゴリーを上書きする] チェックボックスを選択します。
- リストにカテゴリーを追加するには、[カテゴリーを追加] をクリックします。
- カテゴリーを削除するには、削除するカテゴリーの横にあるゴミ箱アイコンをクリックします。
完了したら、[適用] をクリックします。

カテゴリーリストをエクスポートする

カテゴリーは、パブリッシャーネットワーク全体で自社事業のリスティングを確実に正しく掲載する上で役立ちます。Yextでは、パブリッシャーネットワークの各サイトのカテゴリーにマップされたカテゴリーリストを事前に定義しています。Yextから、各エンティティおよび各利用可能な国について、対象カテゴリーのリストをエクスポートできます。

カテゴリーリストをエクスポートするには：

ナビゲーションバーにある [Knowledge Graph] をクリックし、[設定] をクリックします。
[カテゴリーリスト] をクリックします。
希望する対象のカテゴリーリストの [エンティティタイプ] と [国] を選択します。
ダウンロード言語を選択します。
[ダウンロード] ボタンをクリックしてカテゴリーリストをエクスポートします。

このエクスポート機能を使用すると、新規または既存のエンティティを一括更新できます。詳しくは、「エンティティアップロード経由でエンティティを一括アップロードする」をご覧ください。

カテゴリー管理権限

カテゴリを管理するには、次の権限が必要です。

カテゴリーフィールドの編集アクセス
オプション：カテゴリーを変更するためのアクセス権（デフォルトでは、Yextのお客様は一度設定したカテゴリーを編集できません。カテゴリを変更するには、担当のクライアントサクセスマネージャーにご連絡ください）。

カテゴリーリスト

カテゴリーリストとは、利用可能なカテゴリーの統合リストです。各パブリッシャーには独自のカテゴリーリストと、カテゴリー名と内部IDの独自の分類法があります（例：Googleの「会計事務所」カテゴリーにはgcid:accounting_firmのIDがあります）。

Yextはカテゴリーリストを管理するだけでなく、異なるパブリッシャー間でエンティティのカテゴリーを適切にマッピングするために、さまざまなパブリッシャーのカテゴリーリストを保存しています。これらのリストはプラットフォームで公開されていませんが、多くのパブリッシャーは独自のカテゴリーを公開しています。

以下は、一般的に使用されるパブリッシャーのカテゴリーリストです。

カテゴリーマッピング

カテゴリーマッピングは、あるパブリッシャーから別パブリッシャーへとカテゴリーの一貫性を保つために、パブリッシャーのカテゴリーリスト間でエンティティのカテゴリーを変換します。Yextは、Yextのカテゴリーリストと個々のパブリッシャーのカテゴリーリスト間のこれらのカテゴリーマッピングを管理します。

カテゴリーがエンティティに割り当てられると、Yextはパブリッシャーのリストのどのカテゴリーを割り当てられたカテゴリーにマッピングするか決定します。

上記で述べたように、Yextは独自のカテゴリーリストを維持し、これらを異なるパブリッシャーリストにマッピングします。マッピングが誤っていると判断された場合は、カテゴリーマッピングを上書きするオプションもあります。

基本カテゴリーリスト（または「ベースリスト」）はすべてのYextアカウントに存在し、エンティティに割り当てることができるカテゴリーを一覧表示します。基本リストのカテゴリーは、エンティティのカテゴリーフィールドで検索した場合に表示されるカテゴリーです。

カテゴリーの上書き

ユーザーまたはパブリッシャーがYextのカテゴリーマッピングに同意しない場合、またはベースリストのカテゴリーを特定のパブリッシャーにマッピングできない場合は、カテゴリーの上書きでカテゴリーを変更できます。カテゴリーの上書きを使用すると、ユーザーまたはシステム（コネクターやアプリなど）は、パブリッシャーのカテゴリーリストから直接カテゴリーを指定でき、Yextが設定したマッピングを上書きできます。

たとえば、Yextで場所のプライマリカテゴリーが「ビジネスサービス > コンピュータサービス」に設定されている場合、YextはこれをGoogleの「コンピュータサポートおよびサービス」カテゴリーにマッピングします。これを変更して、代わりにGoogleの「コンピュータ修理サービス」カテゴリーを使用する場合は、Googleビジネスプロフィールのカテゴリーを上書きできます。

Google属性に対するカテゴリーの影響

カテゴリーはGoogleの属性にも影響します。Google属性のフィールドは、Googleビジネスプロフィールに同期されているリスティングを持つエンティティにのみ表示されます。利用可能な属性は、カテゴリー、国、言語プロファイルによって異なります。

たとえば、「メキシカンレストラン」というカテゴリーのレストランエンティティは以下の属性を持つ場合があります。

コートチェックがある
お子様メニューあり
バーがある
非接触デリバリーあり

Googleは時間をかけて属性を追加し、カテゴリで利用できるようにします。エンティティのカテゴリを変更すると、利用可能な属性に変更が生じる場合があります。

コネクター

コネクター経由でデータを取り込む場合、マッピング段階で列の値をカテゴリーフィールドにマッピングできます。

サポートされるパブリッシャーからListingsデータを取り込む場合、パブリッシャーカテゴリーをマッピング変換でYextカテゴリーを設定できます。これにより、パブリッシャーのカテゴリIDは、マッピングされたYextカテゴリーIDに変換されます。たとえば、この変換はGoogleビジネスプロフィールのgcid:apartment_buildingカテゴリーを、対応するYextカテゴリーID1686に変換します。

また、コネクターでカテゴリーマッピングを上書きすることもできます。コネクター成のマッピング段階で、パブリッシャーカテゴリーIDを、目的のパブリッシャーエンドポイントの適切なサブフィールドにマッピングします。

現在、コネクターは以下のカテゴリーリストへのマッピングにのみ対応しています。

ベースカテゴリリスト（Yext）
Apple
Bing
Facebookプレイストピック
Googleビジネスプロフィール
TripAdvisorリスティング

コネクターのカテゴリーに関する一般的な注記：

カテゴリーはコネクターが受信した順序に従って割り当てられます。コネクターが最初に受信したカテゴリーが主要カテゴリーとなり、それ以降のカテゴリはすべて追加カテゴリーとして扱われます。
コネクターはGoogleビジネスプロフィールのネイティブソースを提供します。GBPからデータを取り込む場合は、Googleビジネスプロフィールのリファレンスをご覧ください。

Suggestions API

カテゴリーの上書きはSuggestions APIで確認できます。パブリッシャーは通常、Suggestionsシステムを通じて、パブリッシャー推奨経由でカテゴリーの上書きを送信します。SuggestionsAPIは、基本リストカテゴリーに加えて、カテゴリー上書きの提案を返します。

なお、Suggestions API でカテゴリのオーバーライドを表示するには、vパラメータが20230401以上である必要があります。

提案を表示するには、GetまたはListエンドポイントを使用します。以下は応答の例です。

コピー

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

categoriesオブジェクトの構造に注意します。

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

categoriesオブジェクトには次の内容が含まれます。

ベースリストID（通常はyext）。ベースリストは常に返されます。
- Yext カテゴリ ID(数値)
パブリッシャーリストID（例：googleBusinessProfile）
- パブリッシャーのカテゴリーIDに対応する値の配列です。これらはパブリッシャー（例：gcid:software_company）により決定します

categoriesオブジェクトは、特定のカテゴリーリストのプロパティが明示的に設定されている場合にのみ、そのプロパティを含みます。したがって、オブジェクトのプロパティの数は、設定されているオーバーライドの数に1を加えた数になります。

提案を作成するには、Upsertエンドポイントを使用します。以下はリクエストの例です。

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

Suggestions API経由で実行されたカテゴリの提案は部分的です。つまり、プロパティごとに提供されるカテゴリー（例：GoogleBusinessProfile）は包括的なものと見なされますが、リクエストペイロードから除外されたプロパティはそのまま残ります。

Suggestions APIリクエストを実行するための追加情報については、「Suggestions APIドキュメント」をご覧ください。