Kategorie je označení, které popisuje subjekt. Například, pokud byl pro Yext vytvořen subjekt místa, kategorií by byla softwarová společnost.
Kategorie se primárně používají v profilech, kde pomáhají vydavatelům jako Google správně indexovat firmy a odborníky v oboru. Jsou hierarchicky strukturované a obvykle se skládají z nadřazené kategorie a podkategorií. Například subjekt pro zdravotnického pracovníka, který se specializuje na dermatologii, může mít kategorii Zdraví a medicína > Lékařské specializace > Dermatologie.
Kategorie jsou rovněž vázány na typ subjektu, což znamená, že subjektům lze přiřadit pouze kategorie, které jsou relevantní pro jejich typ subjektu. Například kategorii „Restaurace“ nelze přiřadit k subjektu Událost.
Každému subjektu lze přiřadit jednu primární kategorii a až devět dalších kategorií, celkem tedy deset základních kategorií (deset je maximální počet kategorií na subjekt, který Google a další vydavatelé obvykle akceptují).
Přidání kategorií k subjektům je důležitý krok, který zajistí, aby se profily vašich subjektů zobrazovala v příslušných vyhledáváních. Všechny kategorie uvedené na platformě Yext jsou předem určené, aby se zajistilo, že budou vaše subjekty uvedeny správně na všech webech vydavatelů.
Úprava pole kategorie u subjektu
- Na navigačním panelu klikněte na Knowledge Graph a pak na Subjekty.
- Klikněte na subjekt, který chcete upravit.
- Pokud chcete upravit více subjektů najednou, přečtěte si článek Hromadná úprava subjektů .
- Klikněte na pole Kategorie.
Postupujte podle následujících kroků a proveďte požadované změny:
Přidání kategorie
- Klikněte na tlačítko Přidat kategorii.
- Do textového pole zadejte několik prvních písmen požadované kategorie a vyberte ze zobrazeného seznamu.
Smazat kategorii
- Klikněte na ikonu koše vedle kategorie, kterou chcete odstranit. Změna pořadí kategorií
- Přetáhněte kategorie subjektu do preferovaného pořadí.
- Kategorie by měly být uspořádány podle důležitosti. První kategorie je primární kategorií.
Uložit změny
- Po provedení změn klikněte na Uložit. Než budete pokračovat, přečtěte si upozornění.
- Kliknutím na Chci změnit kategorie uložíte změny.
Přepsání kategorie u subjektu
Yext používá pole Kategorie u subjektů k přiřazení subjektu k nejvhodnější kategorii u každého vydavatele. Každý vydavatel má vlastní sadu kategorií.
V Yext přesně vidíte, jak je subjekt kategorizován u každého vydavatele, a můžete podle potřeby provést změny. Tato mapování můžete také přepsat u jednotlivých vydavatelů.
- V navigačním panelu klikněte na Knowledge Graph a pak klikněte na Subjekty.
- Klikněte na subjekt, který chcete upravit.
- Pokud chcete upravit více subjektů najednou, přečtěte si článek Hromadná úprava subjektů.
- Klepnutím rozbalte pole Kategorie. Pak klikněte na tlačítko Pokročilé v pravém dolním rohu oblasti pole.
- Modální okno Pokročilá správa kategorií obsahuje seznam kategorií, u kterých se vybraný subjekt zobrazuje u každého vydavatele. Vydavatelé jsou uvedeni v levém postranním panelu a číslo vedle každého vydavatele udává, v kolika kategoriích je subjekt aktuálně uveden.
- Kliknutím na vydavatele zobrazíte kategorie. Pokud chcete přidat další kategorie pro daného vydavatele nebo kategorie změnit, zaškrtněte políčko Přepsat kategorie pro [[Název vydavatele]].
- Pokud chcete do seznamu přidat kategorii, klikněte na Přidat kategorii.
- Pokud chcete odstranit kategorii, klikněte na ikonu koše vedle kategorie, kterou chcete odstranit.
- Po dokončení klikněte na tlačítko Použít.
Export seznamu kategorií
Kategorie pomáhají zajistit, aby byla vaše firma v síti Publisher Network řádně uvedena. Yext disponuje předem stanoveným seznamem kategorií, které jsou zmapovány ke kategoriím na jednotlivých webech v síti Publisher Network. Pro každý subjekt a každou dostupnou zemi lze z platformy Yext exportovat seznam způsobilých kategorií.
Jak exportovat seznam kategorií:
- V navigačním panelu klikněte na Knowledge Graph a pak na Konfigurace.
- Klikněte na Seznamy kategorií.
- Zvolte typ subjektu a zemi, pro kterou chcete získat seznam kategorií splňujících podmínky.
- Vyberte jazyk stahování.
- Kliknutím na tlačítko Stáhnout exportujte seznam kategorií.
Tento export můžete použít k hromadné aktualizaci nových nebo stávajících subjektů. Další informace naleznete v dokumentaci Hromadné nahrávání subjektů pomocí možnosti Nahrát subjekt.
Oprávnění ke správě kategorií
Ke správě kategorií budete potřebovat následující oprávnění:
- Přístup k úpravám v poli Kategorie.
- Volitelné: přístup k úpravám kategorií (ve výchozím nastavení nemohou zákazníci Yext upravovat kategorie, jakmile jsou nastaveny). Pokud chcete získat přístup k úpravě kategorií, obraťte se na manažera pro úspěch klientů.
Seznamy kategorií
Seznam kategorií je konsolidovaný seznam dostupných kategorií. Každý vydavatel má svůj vlastní seznam kategorií s vlastní taxonomií názvů kategorií a interními ID (například kategorie „Účetní firma“ na Googlu má ID gcid:accounting_firm).
Yext spravuje seznam kategorií a ukládá také různé seznamy kategorií jednotlivých vydavatelů, aby mohla správně přiřadit kategorie k jednotlivým subjektům u různých vydavatelů. Ačkoli tyto seznamy nejsou na platformě viditelné, mnoho vydavatelů své vlastní seznamy kategorií zveřejňuje.
Níže uvádíme některé běžně používané seznamy kategorií vydavatelů:
Mapování kategorií
Mapování kategorií převádí kategorie subjektů mezi seznamy kategorií jednotlivých vydavatelů, aby byla kategorie u všech vydavatelů jednotná. Yext spravuje tato mapování kategorií mezi seznamem kategorií Yext a seznamy kategorií jednotlivých vydavatelů.
Jakmile je kategorie přiřazena k subjektu, Yext určí, na které kategorie v seznamech vydavatelů má být přiřazená kategorie mapována.
Základní seznam kategorií a přepisování kategorií
Jak jsme zmínili výše, Yext spravuje vlastní seznam kategorií a ty mapuje na seznamy různých vydavatelů. Pokud se zjistí, že je mapování nesprávné, existuje také možnost toto mapování přepsat.
Základní seznam kategorií („základní seznam“) existuje v každém účtu Yext a obsahuje seznam kategorií, které lze přiřadit subjektům. Kategorie ze základního seznamu se zobrazují při vyhledávání v poli „Kategorie“ u daného subjektu.
Přepsání kategorií
Pokud uživatel nebo vydavatel nesouhlasí s mapováním kategorií v Yext nebo pokud kategorie v základním seznamu nelze namapovat na určitého vydavatele, lze kategorii změnit pomocí přepsání kategorie. Přepsání kategorií umožňuje uživateli nebo systému (tj. konektoru nebo aplikaci) určit kategorii přímo ze seznamu kategorií vydavatele, čímž potlačí mapování nakonfigurované službou Yext.
Příklad: primární kategorie místa v Yext je nastavena na „Obchodní služby > Počítačové služby“, což Yext mapuje na kategorii „Počítačová podpora a služby“ na Googlu. Pokud byste to chtěli změnit a místo toho použít kategorii „Servis počítačů“ na Googlu, mohli byste přepsat kategorii firemního profilu na Googlu.
Vliv kategorie na atributy Google
Kategorie mohou ovlivnit také atributy Google. Pole pro atributy Google se zobrazí pouze u subjektů s profily, které jsou synchronizovány s firemním profilem na Googlu. Dostupné atributy se budou lišit podle kategorie, země a jazykového profilu.
Například subjekt Restaurace s kategorií „Mexická restaurace“ může mít atributy jako:
- Má šatnu
- Má dětské menu
- Má bar
- Nemá bezkontaktní doručení
Google bude postupně přidávat atributy a zpřístupňovat je pro jednotlivé kategorie. Pokud změníte kategorii svého subjektu, může dojít ke změně v nabídce dostupných atributů.
Konektory
Při ingestování dat prostřednictvím konektoru můžete ve fázi mapování přiřadit hodnoty sloupců k poli Kategorie.
Pokud načítáte data profilů od podporovaného poskytovatele, můžete nastavit kategorii Yext pomocí transformace Mapovat kategorie vydavatelů. Tím se převede ID kategorie vydavatele na mapované ID kategorie Yext. Tato transformace například převede kategorii gcid:apartment_building z firemního profilu na Googlu na odpovídající ID kategorie Yext 1686.
Mapování kategorií můžete také přepsat v konektorech. Ve fázi mapování konfigurace konektoru namapujte ID kategorie vydavatele na příslušné dílčí pole pro požadovaný koncový bod vydavatele.
V současné době podporují konektory pouze mapování na následující seznamy kategorií:
- Základní seznam kategorií (Yext)
- Apple
- Bing
- Témata míst na Facebooku
- Firemní profil na Googlu
- Profil na TripAdvisoru
Obecné poznámky ke kategoriím v konektorech:
- Kategorie jsou přiřazeny v pořadí, v jakém je konektor obdržel. První kategorie, kterou konektor přijme, bude primární kategorií a všechny následující kategorie budou považovány za další kategorie.
- Konektory nabízí nativní zdroj firemního profilu na Googlu. Pokud ingestujete data z firemního profilu na Googlu, podívejte se na průvodce k firemnímu profilu na Googlu.
Rozhraní API pro návrhy
Přepsání kategorií lze zobrazit v rozhraní API pro návrhy. Vydavatelé obvykle odesílají kategorie přepsání prostřednictvím systému návrhů, a to v rámci funkce „Návrhy vydavatele“. Rozhraní API pro návrhy vrací kromě základního seznamu kategorií také návrhy na přepsání kategorií.
Upozorňujeme, že pro zobrazení přepsání kategorií v rozhraní API pro návrhy musí být hodnota parametru v větší nebo rovna hodnotě 20230401.
K zobrazení návrhů použijte koncový bod Načíst nebo Seznam. Zde je příklad odpovědi:
"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": []
}
}
}Všimněte si struktury objektu categories :
{
"categories": {
"yext":["2"],
"googleBusinessProfile":["gcid:software_company"]
}
}Objekt categories zahrnuje:
- ID základního seznamu (obvykle
yext). Základní seznam je vždy vrácen.- ID kategorie Yext (číselné)
- ID seznamu vydavatelů (např.
googleBusinessProfile)- Pole hodnot odpovídajících ID kategorií vydavatele. Ty určuje vydavatel (např.
gcid:software_company)
- Pole hodnot odpovídajících ID kategorií vydavatele. Ty určuje vydavatel (např.
Objekt categories obsahuje vlastnost pro konkrétní seznam kategorií pouze v případě, že je výslovně nastavena. Počet vlastností objektu je tedy roven 1 + počtu nastavených přepisů.
K vytvoření návrhu použijte koncový bod Upsert. Zde je příklad požadavku:
"entityFieldSuggestion": {
"entity": {
"uid": "{entity_uid}"
},
"suggestedContent": {
"categories": {
"googleBusinessProfile": [
"gcid:software_company"
],
"yext":["291","1234"]
}
}
}Návrhy kategorií provedené prostřednictvím rozhraní API pro návrhy jsou částečné. Jinými slovy, kategorie uvedené u jednotlivých vlastností (např. googleBusinessProfile) se považují za úplné, avšak vlastnosti, které v datové části požadavku chybí, zůstanou beze změny.
Další informace o vytváření požadavků v rozhraní API po návrhy naleznete v dokumentaci k rozhraní API pro návrhy.