{"canonical_url":"https://engineer.company/uk/glossary/structured-data/","content_markdown":"# Структуровані дані\n\n## Що це таке\n\nКонтактна сторінка компанії одним реченням каже, де розташований офіс.\nСтруктуровані дані кажуть це ще раз, як `PostalAddress` з вулицею, поштовим\nіндексом і країною, щоб програмі, яка читає сторінку, не доводилося вгадувати,\nкотре слово означає місто. Так називають практику повторювати те, що сторінка\nвикладає прозою, у вигляді типізованих тверджень спільним словником, про який\nдомовилися видавці й споживачі даних, щоб пошукові системи та інші програми\nмогли читати факти, не розбираючи верстку.\n\nЦей словник здебільшого schema.org: документація Google називає його тим, яким\nкористується більшість структурованих даних для її пошуку. Його заснували\nGoogle, Microsoft, Yahoo і Yandex, а з квітня 2015 року головним майданчиком для\nнього є спільнотна група W3C. Він визначає типи, як-от `Organization`, `Person`,\n`Service`, `Review` чи `DefinedTerm`, і властивості, які може мати кожен із них,\nяк-от `name`, `address`, `author` чи `price`.\n\nТвердження можна записати трьома синтаксисами. Microdata і RDFa додають атрибути\nбезпосередньо до видимих елементів HTML. JSON-LD тримає твердження окремо, як\nблок JSON в елементі `script` типу `application/ld+json`; версія 1.1 цього\nформату стала рекомендацією W3C 16 липня 2020 року. Google приймає всі три на\nрівних і радить JSON-LD як найпростіший у супроводі на великих обсягах.\n\n```html\n\u003cscript type=\"application/ld+json\"\u003e\n    {\n        \"@context\": \"https://schema.org\",\n        \"@type\": \"Organization\",\n        \"@id\": \"https://example.com/#organization\",\n        \"name\": \"ТОВ «Приклад»\",\n        \"url\": \"https://example.com/\"\n    }\n\u003c/script\u003e\n```\n\nНайважливіший рядок у цьому блоці — `@id`. JSON-LD ідентифікує ним вузол, а\nвузол без нього анонімний: у термінах специфікації це порожній вузол (blank\nnode) без ідентифікатора, незалежного від документа. Ідентифікатори порожніх вузлів можуть бути спільними для блоків одного документа. Маючи глобальний ідентифікатор, будь-який інший блок на будь-якій іншій сторінці може написати\n`\"publisher\": {\"@id\": \"https://example.com/#organization\"}`, і специфікація\nназиває це посиланням на вузол: вказівкою на річ, описану деінде, замість нового\nїї опису. Саме ідентифікатори перетворюють розкидані блоки на один граф.\n\nСусіднє поняття — метадані. Заголовок, опис і теги Open Graph у `head` сторінки\nописують сторінку як документ, а структуровані дані описують те, про що\nсторінка: компанію, що за нею стоїть, людину, яка її написала, послугу, яку вона\nпропонує, чи слово, яке вона пояснює.\n\n## Чому це важливо\n\nРішення тут одне: скільки сказати. Чесна відповідь зазвичай така: менше, ніж\nдозволяє словник, але повністю. Синтаксис нічим не заважає видавцеві заповнити\nкожну властивість, яку пропонує schema.org. Власні настанови Google радять\nпротилежне: краще менше рекомендованих властивостей, зате повних і точних, ніж\nусі можливі з неповними чи хибними даними, і не розмічати того, чого читач не\nбачить на сторінці, навіть коли це правда.\n\nПричина в тому, що кожен розмічений факт — друга копія того, що сторінка вже\nкаже, а друга копія може розійтися з першою. Ціна, виправлена у видимій таблиці\nй забута в JSON, оцінка, яку бачать лише машини, адреса, щоразу набрана трохи\nінакше: через кожну з них сторінка каже людям одне, а програмам інше. Основна\nпраця полягає не в тому, щоб написати структуровані дані, а в тому, щоб вони\nлишалися правдивими. Тож корисно питати, за які твердження сторінка може\nпоручитися і чи походять вони з того самого джерела, що й видимий текст.\n\nВиграш — розбірливість. Пошукова система чи агент, що можуть звести сотню згадок\nдо однієї компанії, знають більше, ніж ті, хто читає сотню не пов'язаних між\nсобою назв. Сторінки, які дотримуються настанов, можуть отримати право на\nрозширені результати (rich results), тобто показ із додатковими подробицями, але\nсаме право їх не гарантує. Змінюється те, наскільки добре машина розуміє, про що\nсторінка.\n\n## Як це виглядає на практиці\n\nСторінка подяк цього сайту\n[обіцяє розмічати тільки правдиве й видиме](/uk/credits/), а історія його\nструктурованих даних показує, чому це речення довелося записати.\n\nДо переробки в липні 2026 року\n[компанію було описано 1 671 раз у 963 блоках, і в жодного з них не було сталого ідентифікатора](/uk/portfolio/replaced-963-metadata-blocks-with-one-graph/),\nтож споживач даних не мав підстав вважати організацію на одній сторінці тією\nсамою, що й на іншій. Тепер граф спирається на три ідентифікатори, утворені від\norigin сайту: для організації, для вебсайту й для засновниці. Усі інші блоки\nпосилаються на них через `@id`, а не описують їх знову. Ідентифікатори однакові\nв усіх мовах: коментар у шаблоні пояснює, що окремий данський ідентифікатор\nоголосив би другу організацію з тим самим реєстраційним номером. На тому етапі було зафіксовано шістнадцять типів, а списки називали свої елементи лише через URL, бо повний запис 107 позицій, які тоді були на головній сторінці портфоліо, зробив би стиснену сторінку на\n52% важчою.\n\nКілька фактів беруться з того самого джерела, що й видима сторінка. Ціни на\nпослуги походять із того самого файлу даних, що й ціни на екрані, тож машина й\nчитач бачать однаковий тариф. Період, який охоплює робота, береться з того\nсамого partial-шаблону, що пише речення про цей період. Хлібні крихти повторюють\nшлях, який бачить читач, а позиції в списках відповідають порядку на екрані, а\nне рейтингові, опублікованому лише для машин. Власний вузол сторінки має ту саму\nадресу, що й її канонічне посилання, тож розмітка й `head` стверджують одне й те\nсаме.\n\nВідмови так само свідомі, як і твердження. Власні описи робіт компанії не\nпозначено як `Review`, бо так з'явився б вигаданий автор її власних слів.\nШаблон відгуків використовує вузли `Review` лише для записів, опублікованих за наданою згодою, не додаючи оцінки. Кожна стаття Словника, і ця теж, несе `DefinedTerm`, чий опис —\nоднорядкове пояснення зі списку, тож визначення, яке читає машина, те саме, що\nбачить читач.\n\nПеревірка зібраного сайту вимагає, щоб кожен блок розбирався, кожен\nідентифікатор вказував на наявний вузол, а кожна URL, яку називає граф, справді\nбула зібрана, тож ворота якості не пропускають граф, що вказує на сторінку, якої\nнемає. Та сама сторінка подяк називає Schema Markup Validator, щоб прочитати\nдані, і Rich Results Test від Google, щоб побачити, що з ними робить одна\nпошукова система.\n\n## Де виникають проблеми\n\n**Розширені результати лишаються недосяжними, хоча всі валідатори приймають\nрозмітку.** Розмітка — коректний JSON-LD зі справжніми типами schema.org, а\nсторінка й далі показується як звичайний результат. Дані описують те, чого читач\nне бачить: оцінку, якої ніхто не ставив, запитання, приховані на сторінці, чи\nціну, що відрізняється від тієї, що на екрані, а Google попереджає, що розмітка,\nяка порушує його настанови, може позбавити сторінку права на розширені\nрезультати, хоч який чистий синтаксис. Розмічайте лише те, що сторінка показує,\nі генеруйте розмітку й видимий текст з одного джерела, щоб вони не могли\nрозійтися.\n\n**Сотні блоків описують одну компанію, і кожен описує її наново.** Кожна\nсторінка повторює назву, логотип і адресу організації, часом із дрібними\nвідмінностями, і щоб виправити одну деталь, треба знайти всі її копії. Вузли\nанонімні, або кожна сторінка й кожна мова видає власний ідентифікатор для тієї\nсамої сутності. Дайте кожній реальній речі один `@id`, побудований зі сталої URL\nз фрагментом, опишіть її один раз і посилайтеся на неї в усіх інших місцях.\n\n**Одна зміна шаблону ламає розмітку на всіх сторінках водночас.** Зайві лапки,\nкома після останнього елемента чи порожнє значення роблять кожен блок недійсним,\nі споживачі не можуть використати з нього нічого. Посібник Google попереджає, що\nшаблонізація може зламати розмітку після розгортання. JSON складали як текст,\nвставляючи значення між дужками, тож відсутнє поле лишає порожній рядок або\nзламану структуру. Будуйте твердження як структуру даних і серіалізуйте її, як\nце роблять шаблони цього сайту через `jsonify` у Hugo, пропускайте властивості\nбез значення, а не виводьте їх порожніми, і розбирайте кожен блок у зібраному\nрезультаті.\n\n**Граф називає сторінки, яких бракує.** URL у розмітці ведуть на 404, на\nтестовий хост чи на дзеркальну копію. Адреси набрано вручну або побудовано за\nіншим правилом, ніж посилання й канонічну URL. Виводьте кожну URL у розмітці\nтією самою функцією, що дає канонічну адресу сторінки, і перевіряйте, що кожну з\nних зібрано.\n\n## Що почитати далі\n\n- [schema.org](https://schema.org/) — спільний словник типів і властивостей з\n  окремою сторінкою для кожного типу.\n- [JSON-LD 1.1](https://www.w3.org/TR/json-ld11/) — рекомендація W3C для\n  синтаксису, зокрема ідентифікатори вузлів і посилання на вузли.\n- [schema.org: DefinedTerm](https://schema.org/DefinedTerm) — тип, яким кожна\n  стаття Словника описує слово, що його пояснює.\n- [Google Search Central: introduction to structured data](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data)\n  — три синтаксиси, правило видимості й те, як перевіряти розширені результати.\n- [Schema Markup Validator](https://validator.schema.org/) — читає структуровані\n  дані будь-якої сторінки й звіряє їх зі словником schema.org.\n\n\u003chttps://engineer.company/uk/glossary/structured-data/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як структуровані дані повторюють факти сторінки спільним словником, чому стала ідентичність важить більше за обсяг і яка розмітка шкодить.","formats":{"gemtext":"https://engineer.company/uk/glossary/structured-data/index.gmi","gopher":"https://engineer.company/uk/glossary/structured-data/gophermap","html":"https://engineer.company/uk/glossary/structured-data/","json":"https://engineer.company/uk/glossary/structured-data/index.json","markdown":"https://engineer.company/uk/glossary/structured-data/index.md","pdf":"https://engineer.company/uk/glossary/structured-data/index.pdf"},"kind":"page","language":"uk","title":"Що таке структуровані дані?","url":"https://engineer.company/uk/glossary/structured-data/","version":1}