Phổ biến Dữ liệu có cấu trúc Các lỗi (và Cách sửa Them)

Tóm tắt — dữ liệu có cấu trúc lỗi có nghĩ là schema markup on của bạn trang có vấn đề. Either nó được viết sai và công cụ tìm kiếm có thể’t đọc nó tại all, hoặc nó đọc fine nhưng là bị thiếu điều gì đó Google cần để hiển thị fancy kết quả (star ratings, sản phẩm prices, breadcrumbs). Sửa các lỗi wins lại đó fancy kết quả — nó làm không move bạn lên trong thứ hạng, vì dữ liệu có cấu trúc không phải xếp hạng factor.

Điều gì dữ liệu có cấu trúc lỗi là

Dữ liệu có cấu trúc (cũng called schema markup) là extra code bạn thêm để một trang đó tells các công cụ tìm kiếm điều gì nội dung của bạn có nghĩa là — “this is the price,” (bản dịch) «này là đó price,» “this is the author,” (bản dịch) «này là đó tác giả,» “this is the rating.” (bản dịch) «này là đó rating.» Khi đó code có một vấn đề, bạn nhận một dữ liệu có cấu trúc lỗi, và đó reward điều này đã là supposed để earn — một richer, hơn eye-catching tìm kiếm listing called một rich kết quả — không cho thấy lên.

các lỗi come trong hai flavors:

• ** code là hỏng.** typo như extra comma hoặc unclosed quote có thể làm toàn bộ block unreadable. công cụ tìm kiếm có thể’t ngay cả tell Điều gì bạn là trying để mô tả.
• ** code đọc fine nhưng là incomplete hoặc sai.** bạn left out điều gì đó Google requires (như sản phẩm image), hoặc bạn put text nơi Google dự kiến number, hoặc bạn marked lên điều gì đó không phải thực ra visible on trang.

các lỗi so với. warnings — làm I có để khắc phục điều này hôm nay?

điều này phân biệt saves lot của panic:

• lỗi có nghĩ là bắt buộc piece là bị thiếu hoặc hỏng. rich kết quả có thể’t hiển thị tại all cho đến khi bạn khắc phục nó.
• warning có nghĩ là được khuyến nghị (nhưng tùy chọn) piece là bị thiếu. rich kết quả có thể vẫn hiển thị — nó chỉ little ít hơn hoàn tất.

So an lỗi là “fix this to get the feature,” (bản dịch) «cách sửa này để nhận đó feature,» và một warning là “you could make this better.” (bản dịch) «bạn có thể làm này tốt hơn.» Không mọi thứ Google flags là urgent.

nơi bạn’ll see những điều này các lỗi

Three places, và mọi người mix them lên constantly:

• ** Rich Kết quả Kiểm thử** — bạn paste trong một URL hoặc code snippet, và Google tells bạn Điều gì rich kết quả nó tìm thấy và bất kỳ các lỗi. nó cũng previews Cách kết quả có thể look.
• Search Console’s Rich kết quả báo cáo — ongoing, trang web-wide view đó watches cho các lỗi trên của bạn các trang theo thời gian.
• ** Schema Markup Validator** — chạy by schema.org (không Google). nó kiểm tra liệu của bạn code là được viết correctly, cho bất kỳ loại của schema, liệu Google dùng nó cho rich kết quả hoặc không.

điều phần lớn mọi người nhận sai

Sửa dữ liệu có cấu trúc các lỗi sẽ không làm bạn xếp hạng cao hơn. Dữ liệu có cấu trúc không phải xếp hạng factor. reason để khắc phục các lỗi là để win lại appearance — stars, price, breadcrumbs — mà có thể nhận bạn nhiều hơn clicks. đó thực benefit, nhưng nó không giống nhau as xếp hạng.

Một hơn: chỉ mark lên điều đó là thực ra on đó trang. Describing nội dung một khách truy cập không thể see breaks Google rules và có thể earn bạn một hình phạt — hơn serious hơn chỉ âm thầm losing đó rich kết quả. (Hơn on đó, plus đó hai-tool trap và đó “why does my markup validate but still not show?” (bản dịch) «vì sao làm my markup validate nhưng vẫn không cho thấy?» mystery, trong đó Advanced tab.)

Muốn đầy đủ taxonomy của lỗi types, malformed-JSON gotchas, deprecated FAQ situation, và Cách debug mỗi một? Chuyển để Nâng cao tab.

Tóm tắt — Dữ liệu có cấu trúc các lỗi split vào phân tích cú pháp các lỗi (malformed JSON-LD — trailing commas, unescaped quotes, bị thiếu colons hoặc braces — đó break markup so badly Google có thể’t determine loại; những điều này land trong Unparsable dữ liệu có cấu trúc báo cáo) và eligibility các lỗi ( markup parses nhưng fails rich-kết quả rule: bị thiếu bắt buộc thuộc tính, sai giá trị loại, hoặc markup describing nội dung không visible on trang). các lỗi có thể block; warnings là non-cốt yếu — bị thiếu bắt buộc thuộc tính có thể kill feature eligibility, trong khi bị thiếu được khuyến nghị một generally preserves eligibility nhưng có thể limit khả dụng information. nội dung mismatch là một class với teeth — policy violation đó có thể trigger manual hành động, không silent ineligibility. tách biệt thất bại chế độ không phải lỗi tại all: deprecated/unsupported loại (FAQ, đã biến mất by có thể 2026) là hợp lệ markup đó earns không visual. Debug với three khác tools — Rich Kết quả Kiểm thử (Google eligibility + preview), Schema Markup Validator (schema.org syntax, bất kỳ loại), và Search Console’s Rich kết quả báo cáo (trang web-wide, sampled). Dữ liệu có cấu trúc không phải xếp hạng factor, so khắc phục wins lại SERP visual, không xếp hạng.

các lỗi so với. warnings — Điều gì thực ra chặn rich kết quả

trước khi taxonomy, nhận điều này phân biệt straight, vì phần lớn các hướng dẫn sử dụng “lỗi” as catch-all và nó gây ra needless panic.

• lỗi có nghĩ là bắt buộc thuộc tính là bị thiếu hoặc không hợp lệ, hoặc markup là unparsable. item có thể’t là rich kết quả cho đến khi bạn khắc phục nó.
• warning có nghĩ là được khuyến nghị (không bắt buộc) thuộc tính là bị thiếu. rich kết quả có thể vẫn hiển thị — chỉ ít hơn completely.

Google own hướng dẫn leans toward độ chính xác over padding: “it is more important to supply fewer but complete and accurate recommended properties rather than trying to provide every possible recommended property with less complete, badly-formed, or inaccurate data.” (bản dịch) «điều này là hơn quan trọng để supply ít hơn nhưng hoàn tất và chính xác được khuyến nghị properties thay vì trying để cung cấp mỗi có thể được khuyến nghị thuộc tính với ít hơn hoàn tất, badly-formed, hoặc inaccurate dữ liệu.» Nói cách khác, không chase mỗi warning by stuffing trong half-chính xác dữ liệu — đó có thể tạo tệ hơn các vấn đề hơn đó warning điều này solves.

Worth knowing: ngay cả Google own reporting không infallible ở đây. Trong October 2022 Search Console đã có một bug nơi some các vấn đề đã là mislabeled as các lỗi khi they đã là thực ra warnings; Google cách sửa moved them “from the critical error table to the warning table,” (bản dịch) «từ đó cốt yếu lỗi bảng để đó warning bảng,» và clarified điều này đã là “strictly a reporting issue and did not affect whether or not a rich result could be displayed” (bản dịch) «strictly một reporting vấn đề và đã không ảnh hưởng liệu hoặc không một rich kết quả có thể là displayed» (Search Engine Land, Oct 2022). Đó lesson: khi trong doubt, cross-kiểm tra một flagged item so với đó Rich Kết quả Kiểm thử thay vì trusting một báo cáo blindly.

Malformed JSON-LD — “unparsable” các lỗi

Này là đó hầu hết fundamental lỗi class: đó markup là hỏng badly đủ đó Google không thể ngay cả determine đó dự kiến loại. Google files những trong một tách biệt Unparsable dữ liệu có cấu trúc báo cáo thay vì một theo-loại báo cáo, vì có không loại để thuộc tính đó item để. Google own mô tả: an item lands ở đây làm một “serious syntax error” (bản dịch) «serious syntax lỗi» và “the intended type of structured data (Job, Event, and so on) could not be determined because of the parsing error.” (bản dịch) «đó dự kiến loại of dữ liệu có cấu trúc (Job, Event, và so on) không thể là determined làm đó phân tích cú pháp lỗi.»

thông thường culprits:

• Trailing commas. MỘT comma sau đó cuối cùng thuộc tính trong an object hoặc array là hợp lệ trong JavaScript nhưng không hợp lệ trong JSON. Này là đó single hầu hết phổ biến way hand-được viết hoặc template-concatenated JSON-LD breaks.
• Unescaped quotes. MỘT double quote bên trong một string giá trị đó không escaped (\") terminates đó string sớm. Google được ghi lại lỗi cho này là “Bad escape sequence in string.” (bản dịch) «Bad escape sequence trong string.» Sản phẩm names, review text, và các mô tả với inch marks hoặc quoted phrases là đó classic offenders.
• Bị thiếu colons hoặc braces. Google documents những verbatim as “Parsing error: Missing ’:’” (bản dịch) «Phân tích cú pháp lỗi: Bị thiếu ’:’» và “Parsing error: Missing ’,’ or ’}’” (bản dịch) «Phân tích cú pháp lỗi: Bị thiếu ’,’ hoặc ’}’» — thường một sao chép và dán hoặc string-concatenation accident.
• Sai giá trị loại bên trong nếu không-hợp lệ JSON. Google “Incorrect value type” (bản dịch) «Incorrect giá trị loại» — e.g., một numeric trường wrapped trong quotes khi một number đã là dự kiến. (Này shades vào đó eligibility các lỗi dưới; khi đây là bad đủ để break phân tích cú pháp, điều này lands ở đây.)

Cách debug: strip để rỗng object, rebuild piece by piece

Google own gỡ lỗi tip cho unparsable markup là refreshingly thấp-tech: “If you are having problems finding the error, try starting from an empty object, then add back content from your broken code piece by piece.” (bản dịch) «Nếu bạn là có các vấn đề finding đó lỗi, try starting từ an empty object, thì thêm lại nội dung từ của bạn hỏng code piece by piece.» Paste đó stripped-xuống object vào đó Rich Kết quả Kiểm thử, xác nhận điều này parses, thì thêm properties lại until điều này breaks — đó cuối cùng điều bạn đã thêm là của bạn culprit.

Một caution straight từ Google: sửa một phân tích cú pháp lỗi “might trigger additional warnings or errors that were hidden because the item could not be parsed at all.” (bản dịch) «có thể trigger additional warnings hoặc các lỗi đó đã là hidden vì đó item không thể là parsed tại all.» Một cách sửa có thể unmask đó tiếp theo layer, so re-kiểm thử sau mỗi thay đổi.

Bị thiếu bắt buộc các trường và sai giá trị types

sau khi JSON parses, tiếp theo lỗi class là về nội dung: là mỗi bắt buộc thuộc tính present, và là mỗi giá trị right loại?

Bắt buộc so với. được khuyến nghị (again, nhưng tại thuộc tính cấp độ)

Mỗi Google-supported loại có bắt buộc properties (leave một out và bạn lose eligibility — đó là an lỗi) và được khuyến nghị ones (leave một out và bạn nhận một warning, nhưng đó rich kết quả có thể vẫn cho thấy). Search Console’s hướng dẫn là để open đó báo cáo, “click an issue to see affected pages,” (bản dịch) «nhấp an vấn đề để see affected các trang,» và dùng đó “Why items are invalid” (bản dịch) «Vì sao items là không hợp lệ» bảng để prioritize — các lỗi đầu tiên, thì warnings.

Loại mismatches — string nơi number, URL, hoặc date là dự kiến

kinh điển eligibility bug: giá trị là ở đó, nhưng nó sai loại. price trường containing date. rating provided as "five stars" thay vì number. URL trường containing đơn giản text. Google flags điều này as không hợp lệ/unexpected giá trị loại.

Bing là worth một note ở đây vì, theo của nó own dữ liệu có cấu trúc help tài liệu, điều này behaves differently: thay vì erroring loudly, Bing các crawler là được ghi lại để bỏ qua an chú thích whose giá trị loại là sai (một price trường holding một date, an Event với không date, một Person với không name) thay vì surface một red lỗi. So không assume “no Bing error” (bản dịch) «không Bing lỗi» có nghĩa là “correct” — Bing công khai tài liệu là thinner và ít hơn granular hơn Google (điều này không publish một theo-loại bắt buộc-so với-được khuyến nghị breakdown hoặc một báo cáo as detailed as đó Rich kết quả báo cáo), và của nó tolerance cho mismatched types là một silent-drop, không một loud-fail. Lean on Google Rich Kết quả Kiểm thử cho đó detailed lỗi taxonomy.

Duplicate @id các giá trị và entity confusion

subtler một đó CMS plugin nguyên nhân constantly: reusing giống nhau @id cho hai khác entities, hoặc letting plugin emit fresh, colliding @id on mỗi trang thay vì ổn định một. Đây là không phân tích cú pháp thất bại — JSON itself là well-formed, so nó không land trong Unparsable dữ liệu có cấu trúc báo cáo. @id là Cách JSON-LD nodes reference mỗi khác bên trong @graph, so collision là entity-identity vấn đề: nó tạo ambiguity về mà node reference thực ra points để. điều này nhận tệ hơn on các trang nơi multiple sources ( theme và schema plugin) cả hai auto-generate Organization, WebSite, và WebPage nodes.

khắc phục là ổn định, unique @id theo thực-world entity — URL-fragment identifier như https://example.com/#organization, reused consistently trên trang web, không regenerated theo trang. Đây là mirror image của canonicalization vấn đề, nơi một ổn định identifier theo thực điều là likewise toàn bộ game.

Nested-thuộc tính các lỗi ( bị thiếu name bên trong author)

Some bắt buộc properties trực tiếp bên trong other objects — author.name, aggregateRating.ratingValue. MỘT bị thiếu một được dùng để produce một vague lỗi như Missing field "name" đó có thể point anywhere on đó trang. Trong March 2022 Google đã thêm nested context so đó giống nhau lỗi hiện tại đọc Missing field "name" (in "author") — một nhỏ thay đổi đó làm những far easier để locate. (Anyone với an open “validate fix” (bản dịch) «validate cách sửa» yêu cầu tại đó time đã có để re-trigger điều này, since đó old vấn đề IDs đã là retired.) Nếu bạn see một nested-thuộc tính lỗi, đọc đó parenthetical — điều này tells bạn chính xác mà object là ngắn một trường.

nội dung mismatch — policy-violation lỗi class

Này là đó một lỗi class đó deserves của nó own section, vì đó consequence là categorically tệ hơn “no rich result.” (bản dịch) «không rich kết quả.» Mọi thứ trên là một kỹ thuật vấn đề. Nội dung mismatch là một policy vấn đề.

Google Chung Dữ liệu có cấu trúc Guidelines là rõ ràng on hai points:

• “Don’t mark up content that is not visible to readers of the page.” (bản dịch) «không mark lên nội dung đó không phải visible để readers of đó trang.»
• “Your structured data must be a true representation of the page content.” (bản dịch) «Của bạn dữ liệu có cấu trúc phải được một đúng representation of đó trang nội dung.»

Marking lên 4,8-star rating đó xuất hiện nowhere on trang, describing nội dung đó hidden hoặc phân phối chỉ để các crawler, hoặc labeling điều gì đó as một điều Khi nó thực sự một — Google own các ví dụ bao gồm sports trực tiếp-streaming trang web labeling broadcasts as local events, và woodworking trang web labeling instructions as recipes — all violate điều này.

Consequences: manual actions so với. silent ineligibility

MỘT kỹ thuật lỗi costs bạn đó rich kết quả silently. MỘT nội dung-mismatch policy violation có thể cost bạn hơn: “If your page contains a structured data issue, it can result in a manual action. A structured data manual action means that a page loses eligibility for appearance as a rich result; it doesn’t affect how the page ranks in Google web search.” (bản dịch) «Nếu trang của bạn contains một dữ liệu có cấu trúc vấn đề, điều này có thể kết quả trong một manual hành động. MỘT dữ liệu có cấu trúc manual hành động có nghĩa là đó một trang loses eligibility cho appearance as một rich kết quả; điều này không ảnh hưởng cách đó trang ranks trong Google web tìm kiếm.» Manual actions cho thấy lên trong đó Manual Actions báo cáo trong Search Console — một place bạn không bao giờ muốn để see một structured-dữ liệu entry.

MỘT phổ biến quieter version of này: templated, non-unique schema. John Mueller dài-standing hướng dẫn là đó “the structured data on a website, or on a page, should be specific to that particular page” (bản dịch) «đó dữ liệu có cấu trúc on một website, hoặc on một trang, nên là cụ thể để đó particular trang» (qua Search Engine Journal). MỘT site-wide Organization block copy-pasted với đó giống nhau review count onto mỗi trang đọc as một representation vấn đề, không chỉ một sloppy một.

Vì sao validation không đủ. Này là đó câu trả lời để “my markup validates clean — why no rich result?” (bản dịch) «my markup validates sạch — vì sao không rich kết quả?» Các validator kiểm tra syntax và Google kỹ thuật eligibility rules. They làm không kiểm tra Google nội dung-quality và spam-policy layer. MỘT syntactically perfect, policy-violating implementation có thể vẫn là denied một rich kết quả hoặc hit với một manual hành động. Passing đó Rich Kết quả Kiểm thử là necessary nhưng không sufficient.

sử dụng deprecated hoặc unsupported loại

Ở đây thất bại chế độ đó không phải technically “lỗi” tại all — và nó trips mọi người lên vì không có gì turns red. của bạn markup là perfectly hợp lệ, nó parses, nó truyền schema.org validator, và tuy vậy không rich kết quả sẽ bao giờ hiển thị, vì Google turned feature off.

Case nghiên cứu: FAQ rich kết quả (deprecated 2026)

Đó timely ví dụ. Google đã thêm một deprecation notice để đó FAQ rich kết quả tài liệu, stating đó feature “will no longer appear in Google Search starting May 7, 2026,” (bản dịch) «sẽ không lâu hơn xuất hiện trong Google Search starting Có thể 7, 2026,» thì trong mid-2026 đã xóa đó FAQ tài liệu, Rich Kết quả Kiểm thử hỗ trợ, và Search Console reporting vì “the FAQ rich result feature is no longer shown in Google Search results.” (bản dịch) «đó FAQ rich kết quả feature là không lâu hơn shown trong Google Search kết quả.»

Đó nuance đó matters: FAQPage là vẫn một hợp lệ schema.org loại, và Google vẫn parses điều này. Đó loại không “sai.” Điều này đơn giản không lâu hơn earns đó visual treatment. So đó correct reaction để “is my FAQ schema now an error?” (bản dịch) «là my FAQ schema hiện tại an lỗi?» là không — leaving đó markup trong place không hurt bất cứ điều gì; điều này chỉ không lâu hơn buys bạn một SERP enhancement. không panic-strip hợp lệ markup vì đó visual went away.

khác retired types

FAQ không phải alone. Google có repeatedly retired rich-kết quả types Khi analysis showed họ đã không widely được sử dụng hoặc đã không thêm người dùng giá trị: HowTo rich kết quả là đã xóa từ desktop lại trong 2023; June 2025 batch retired seven nhiều hơn niche types (including Claim Review, Estimated Salary, Learning Video, Special Announcement, và Vehicle Listing); và Practice Các vấn đề dữ liệu có cấu trúc là deprecated starting January 2026. Trong mỗi case schema.org loại thường vẫn hợp lệ — nó chỉ dừng kết xuất.

Cách tell nếu loại là vẫn “trực tiếp”

kiểm tra Google Tìm kiếm Gallery — canonical list của types đó hiện tại earn rich kết quả. nếu loại không phải trong gallery, hợp lệ markup cho nó sẽ không produce visual, không quan trọng Cách sạch nó là. Re-kiểm tra gallery periodically; Google revises nó thường.

Cách thực ra debug — three khác tools

single phần lớn phổ biến meta-mistake là conflating tools. có three, và họ câu trả lời khác các câu hỏi.

Rich Kết quả Kiểm thử — Google eligibility + SERP preview

Đó Rich Kết quả Kiểm thử takes một single URL hoặc một code snippet và kiểm tra đó subset of markup Google dùng cho rich kết quả, thì previews cách đó kết quả có thể xuất hiện. Google frames điều này as “an easy and useful tool for validating your structured data, and in some cases, previewing a feature in Google Search.” (bản dịch) «an easy và hữu ích tool cho validating của bạn dữ liệu có cấu trúc, và trong một số trường hợp, previewing một feature trong Google Search.» Dùng điều này during development và để spot-kiểm tra một cách sửa. Điều này làm không validate schema types Google không dùng cho rich kết quả.

Schema Markup Validator — schema.org syntax, bất kỳ loại

Đó Schema Markup Validator là chạy by schema.org, không Google. Điều này kiểm tra chung syntax và vocabulary compliance cho bất kỳ schema.org loại — including ones Google không turn vào rich kết quả (e.g., Action schema). Passing điều này có nghĩa là của bạn markup là well-formed schema.org; điều này làm không có nghĩa là bạn là eligible cho một Google rich kết quả. Này là đó tool cho “is my JSON-LD structurally correct?” (bản dịch) «là my JSON-LD structurally correct?» independent of bất kỳ công cụ tìm kiếm.

Đó hai-tool trap: những là genuinely khác nhau tools, và passing một không có nghĩa là passing đó other. Đó split có confusing history — Google tried để fully deprecate của nó old “Structured Data Testing Tool” (bản dịch) «Dữ liệu có cấu trúc Kiểm thử Tool» trong July 2020, reversed course sau backlash đó December, thì refocused điều này vào hôm nay schema.org-chạy validator by mid-2021. Plenty of old blog posts vẫn point mọi người tại đó dead tool name. Cho 2026: Rich Kết quả Kiểm thử cho Google eligibility, Schema Markup Validator cho schema.org syntax.

Search Console’s Rich kết quả báo cáo — trang web-wide, sampled, theo thời gian

Đó Rich kết quả báo cáo (đó older nav và một lot of practitioners vẫn call này đó “Enhancements” (bản dịch) «Enhancements» các báo cáo) là đó chỉ một đó là ongoing và site-wide thay vì một single-URL spot kiểm tra. Google: “a valid item is an item that doesn’t have any critical issues and can appear on Google as a rich result. An invalid item has at least one critical issue preventing it from appearing as a rich result.” (bản dịch) «một hợp lệ item là an item đó không có bất kỳ cốt yếu các vấn đề và có thể xuất hiện on Google as một rich kết quả. An không hợp lệ item có ít nhất một cốt yếu vấn đề preventing điều này từ appearing as một rich kết quả.» Hai limitations để giữ trong mind: theo-loại các báo cáo chỉ xuất hiện khi Google tìm thấy hợp lệ markup of đó loại, và “the reports aren’t a comprehensive list of all detected items. They show a sample of detected items to help assess the quality of your structured data.” (bản dịch) «đó các báo cáo không một comprehensive list of all detected items. They cho thấy một sample of detected items để help assess đó quality of của bạn dữ liệu có cấu trúc.» đây là một monitoring surface, không an exhaustive audit.

** truyền các câu trả lời chỉ đó tool own layer.** Rich Kết quả Kiểm thử, Schema Markup Validator, và Rich kết quả báo cáo mỗi kiểm tra khác câu hỏi, so sạch kết quả trong một tells bạn không có gì về khác hai — truyền trong Schema Markup Validator không có nghĩa là Google Rich Kết quả Kiểm thử sẽ truyền, và neither proves Điều gì Rich kết quả báo cáo sẽ hiển thị sau khi Google thực ra crawl deployed trang.

Validating khắc phục (và Vì sao nó takes trong khi)

Khi bạn đã fixed an vấn đề, Google được ghi lại workflow là: cách sửa on-site, xác nhận đó trang là crawlable (không Bị chặn bởi robots.txt hoặc noindex), spot-kiểm tra với URL Inspection, thì “click Validate fix on the issue’s details page to start Google’s validation process.” (bản dịch) «nhấp Validate cách sửa on đó vấn đề details trang để bắt đầu Google validation xử lý.» Set expectations on timing — Google says validation “can take two weeks or more, depending on crawl frequency.” (bản dịch) «có thể take hai weeks hoặc hơn, depending on crawl frequency.» đây là không instant; Google có để re-crawl đó affected các trang.

một cách diễn đạt đó giữ bạn sane

Sửa dữ liệu có cấu trúc các lỗi là về rich-kết quả eligibility, không thứ hạng. As John Mueller put điều này (reported by Công cụ tìm kiếm Roundtable, April 2025), “structured data won’t make your site rank better” (bản dịch) «dữ liệu có cấu trúc sẽ không làm trang web của bạn xếp hạng tốt hơn» — đây là cho displaying đó tìm kiếm features trong Google gallery. So đó payoff of một sạch cách sửa là một SERP visual (stars, breadcrumbs, price) và đó nhấp-qua điều này có thể earn — không bao giờ một xếp hạng bump. Giữ đó straight và bạn’ll prioritize đó right các lỗi: đó ones blocking một visual bạn thực ra muốn, không mỗi warning trong đó báo cáo.

nơi điều này sits

Đây là deep-dive sibling dưới Dữ liệu có cấu trúc Đối với SEO hub — giống nhau sub-cluster as schema-markup, JSON-LD, và rich-kết quả deep dives. lỗi taxonomy ở đây là khắc phục sự cố đối tác tương ứng để những điều đó: họ cover Điều gì để xây dựng, điều này covers Điều gì breaks và Cách see nó. cho rộng hơn picture của on-trang các tín hiệu nó lives alongside — meta tags, header tags, image SEO — see on-trang SEO cluster.

AI summary

condensed take on Nâng cao version:

• Hai lỗi classes. Phân tích cú pháp các lỗi — malformed JSON-LD (trailing commas, unescaped quotes, bị thiếu colons/braces) đó break đó markup so badly Google không thể determine đó loại; những go để đó Unparsable dữ liệu có cấu trúc báo cáo. Eligibility các lỗi — đó markup parses fine nhưng fails một rich-kết quả rule: bị thiếu bắt buộc thuộc tính, sai giá trị loại, một colliding/duplicate @id (entity-identity confusion, không một parse failure), hoặc markup describing nội dung không visible on đó trang.
• Các lỗi block, warnings degrade. MỘT bị thiếu bắt buộc thuộc tính (hoặc unparsable JSON) kills rich-kết quả eligibility. MỘT bị thiếu được khuyến nghị thuộc tính là chỉ một warning — đó kết quả thường vẫn cho thấy, ít hơn richly. Google: chính xác-nhưng-ít hơn beats padded-nhưng-sloppy.
• Nội dung mismatch là đó class với teeth. Marking lên invisible nội dung hoặc dữ liệu đó không “a true representation of the page content” (bản dịch) «một đúng representation of đó trang nội dung» là một policy violation đó có thể trigger một manual hành động — tệ hơn silent ineligibility. Này là vì sao sạch-validating markup có thể vẫn fail: các validator không kiểm tra đó nội dung/spam policy layer.
• Deprecated types không các lỗi. FAQ (đã biến mất by Có thể 2026), HowTo (desktop 2023), và đó June 2025 batch là hợp lệ markup đó không lâu hơn earns một visual. không panic-strip FAQPage — điều này vẫn parses, điều này chỉ có không SERP payoff. Kiểm tra đó Tìm kiếm Gallery cho điều gì là vẫn trực tiếp.
• Three khác nhau tools. Rich Kết quả Kiểm thử — Google eligibility + SERP preview, single URL/snippet. Schema Markup Validator (schema.org) — syntax/vocabulary cho bất kỳ loại, không Google-cụ thể. Rich kết quả báo cáo (Search Console) — site-wide, sampled, theo thời gian. Passing một ≠ passing một sản phẩm khác.
• Debug tip (từ Google): strip để an empty object, re-thêm code piece by piece; một cách sửa có thể unmask hidden các lỗi, so re-kiểm thử mỗi time.
• Validating một cách sửa takes “two weeks or more, depending on crawl frequency.” (bản dịch) «hai weeks hoặc hơn, depending on crawl frequency.»
• Không phải là yếu tố xếp hạng. Sửa các lỗi wins lại một SERP visual, không một xếp hạng (Mueller, 2025).

Tài liệu chính thức

Chính-nguồn tài liệu từ Google và schema.org.

Google — policies và cách markup hoạt động

• Chung Dữ liệu có cấu trúc Guidelines — đó nội dung-mismatch và hidden-nội dung rules, và đó manual-hành động consequence.
• Intro để Cách Đánh dấu dữ liệu có cấu trúc Hoạt động — đó Rich Kết quả Kiểm thử khuyến nghị và đó “fewer but complete” (bản dịch) «ít hơn nhưng hoàn tất» bắt buộc-so với-được khuyến nghị hướng dẫn.
• Đánh dấu dữ liệu có cấu trúc đó Google Search Hỗ trợ (Tìm kiếm Gallery) — đó canonical list of types đó hiện tại earn rich kết quả (kiểm tra trước assuming một loại là vẫn trực tiếp).

Google — đó các báo cáo và đó gỡ lỗi workflow

• Rich kết quả báo cáo overview — đó site-wide, sampled, theo-loại Search Console báo cáo; hợp lệ-so với-không hợp lệ definitions và đó “sample, not comprehensive” (bản dịch) «sample, không comprehensive» caveat.
• Unparsable dữ liệu có cấu trúc báo cáo — nơi malformed JSON-LD lands; đó được ghi lại lỗi strings và đó strip-để-empty-object gỡ lỗi tip.
• Cách sửa dữ liệu có cấu trúc các vấn đề trong Search Console — đó cách sửa → xác nhận crawlable → URL Inspection → Validate cách sửa workflow, và đó “two weeks or more” (bản dịch) «hai weeks hoặc hơn» timing.

Google — tool

• Rich Kết quả Kiểm thử — single-URL/snippet checker với SERP preview (Google-eligibility chỉ).

schema.org

• Schema Markup Validator — schema.org own syntax/vocabulary validator cho bất kỳ loại (distinct từ Google Rich Kết quả Kiểm thử).
• schema.org — vocabulary itself.

Quotes từ nguồn

On—record statements từ Google, plus relayed statements từ Google reps. mỗi link là deep link đó jumps để quoted passage nơi trang exposes nó.

Google — nội dung-mismatch policy ( độ chính xác spine)

• “Don’t mark up content that is not visible to readers of the page.” (bản dịch) «không mark lên nội dung đó không phải visible để readers of đó trang.» — Google Search Central tài liệu. Nhảy đến trích dẫn
• “Your structured data must be a true representation of the page content.” (bản dịch) «Của bạn dữ liệu có cấu trúc phải được một đúng representation of đó trang nội dung.» Nhảy đến trích dẫn

Google — bắt buộc so với. được khuyến nghị properties

• “it is more important to supply fewer but complete and accurate recommended properties rather than trying to provide every possible recommended property with less complete, badly-formed, or inaccurate data.” (bản dịch) «điều này là hơn quan trọng để supply ít hơn nhưng hoàn tất và chính xác được khuyến nghị properties thay vì trying để cung cấp mỗi có thể được khuyến nghị thuộc tính với ít hơn hoàn tất, badly-formed, hoặc inaccurate dữ liệu.» Nhảy đến trích dẫn
• “The Rich Results Test is an easy and useful tool for validating your structured data, and in some cases, previewing a feature in Google Search.” (bản dịch) «Đó Rich Kết quả Kiểm thử là an easy và hữu ích tool cho validating của bạn dữ liệu có cấu trúc, và trong một số trường hợp, previewing một feature trong Google Search.» Nhảy đến trích dẫn

Google — Rich kết quả báo cáo (Search Console)

• “A valid item is an item that doesn’t have any critical issues and can appear on Google as a rich result. An invalid item has at least one critical issue preventing it from appearing as a rich result.” (bản dịch) «MỘT hợp lệ item là an item đó không có bất kỳ cốt yếu các vấn đề và có thể xuất hiện on Google as một rich kết quả. An không hợp lệ item có ít nhất một cốt yếu vấn đề preventing điều này từ appearing as một rich kết quả.» Nhảy đến trích dẫn
• “The reports aren’t a comprehensive list of all detected items. They show a sample of detected items to help assess the quality of your structured data.” (bản dịch) «Đó các báo cáo không một comprehensive list of all detected items. They cho thấy một sample of detected items để help assess đó quality of của bạn dữ liệu có cấu trúc.» Nhảy đến trích dẫn

Google — unparsable markup và gỡ lỗi

• Đó dự kiến loại “could not be determined because of the parsing error.” (bản dịch) «không thể là determined làm đó phân tích cú pháp lỗi.» Nhảy đến trích dẫn
• “If you are having problems finding the error, try starting from an empty object, then add back content from your broken code piece by piece.” (bản dịch) «Nếu bạn là có các vấn đề finding đó lỗi, try starting từ an empty object, thì thêm lại nội dung từ của bạn hỏng code piece by piece.» Nhảy đến trích dẫn

Google — validating khắc phục

• Validation “can take two weeks or more, depending on crawl frequency.” (bản dịch) «có thể take hai weeks hoặc hơn, depending on crawl frequency.» Nhảy đến trích dẫn

John Mueller, Google — dữ liệu có cấu trúc không phải xếp hạng factor

• “Structured data won’t make your site rank better.” (bản dịch) «Dữ liệu có cấu trúc sẽ không làm trang web của bạn xếp hạng tốt hơn.» Đọc bài đưa tin

John Mueller, Google — schema nên là trang-cụ thể

• “The structured data on a website, or on a page, should be specific to that particular page.” (bản dịch) «Đó dữ liệu có cấu trúc on một website, hoặc on một trang, nên là cụ thể để đó particular trang.» Đọc bài đưa tin

Search Console reporting bug (Oct 2022) — các lỗi mislabeled as các lỗi

• “This is strictly a reporting issue and did not affect whether or not a rich result could be displayed in Google Search results.” (bản dịch) «Này là strictly một reporting vấn đề và đã không ảnh hưởng liệu hoặc không một rich kết quả có thể là displayed trong Google Search kết quả.» Đọc bài đưa tin

Mà tool (và Điều gì làm kết quả có nghĩa là)?

Bắt đầu từ câu hỏi bạn’re thực ra asking — tools câu trả lời khác ones.

“Is my JSON-LD even written correctly?” (bản dịch) «Là my JSON-LD ngay cả được viết correctly?» → Schema Markup Validator (validator.schema.org). Điều này kiểm tra schema.org syntax và vocabulary cho bất kỳ loại. Passing = well-formed schema.org. Điều này làm không tell bạn về Google rich-kết quả eligibility.

“Will this page be eligible for a Google rich result, and how might it look?” (bản dịch) «Sẽ này trang là eligible cho một Google rich kết quả, và cách có thể điều này look?» → Rich Kết quả Kiểm thử (search.google.com/test/rich-results). Single URL hoặc snippet, Google-eligible types chỉ, với một SERP preview.

• Nếu đó loại bạn care về không recognized tại all → kiểm tra đó Tìm kiếm Gallery; đó loại có thể là deprecated (FAQ, HowTo-on-desktop) — hợp lệ markup, không visual.

“Which pages across my whole site have issues, over time?” (bản dịch) «Mà các trang trên my toàn bộ site có các vấn đề, theo thời gian?» → Search Console → Rich kết quả báo cáo (site-wide, sampled). Remember đây là một sample, không một comprehensive list, và theo-loại các báo cáo chỉ xuất hiện khi Google tìm thấy hợp lệ markup of đó loại.

Điều gì làm lỗi thực ra có nghĩa là?

Item là trong Unparsable dữ liệu có cấu trúc báo cáo → Malformed JSON — trailing comma, unescaped quote, bị thiếu colon/brace. Strip để rỗng object và re-thêm code piece by piece. Google không thể ngay cả determine loại.

“Missing field …” (bản dịch) «Bị thiếu trường …» (an lỗi) → MỘT bắt buộc thuộc tính là absent. Rich kết quả blocked until fixed. Đọc bất kỳ parenthetical (… (in "author")) — điều này names đó nested object đó là ngắn một trường.

”… should be … / recommended” (bản dịch) «… nên là … / được khuyến nghị» (một warning) → MỘT được khuyến nghị thuộc tính là bị thiếu. Đó rich kết quả vẫn cho thấy, chỉ ít hơn completely. Cách sửa chỉ nếu đó bị thiếu trường là worth điều này — không pad với inaccurate dữ liệu.

“Incorrect value type” (bản dịch) «Incorrect giá trị loại» / “invalid value” (bản dịch) «không hợp lệ giá trị» → Right thuộc tính, sai loại — một string nơi một number/URL/date belongs. Correct đó loại.

Validates sạch, nhưng không rich kết quả xuất hiện → Either đó loại là deprecated (kiểm tra đó gallery) hoặc bạn là hitting một nội dung/policy vấn đề các validator không catch (invisible nội dung, không một “true representation” (bản dịch) «đúng representation»). Worst case, kiểm tra đó Manual Actions báo cáo.

Entry trong Manual Actions báo cáo → nội dung-mismatch policy violation. Đây là serious một: khắc phục markup-để-trang mismatch, sau đó yêu cầu reconsideration. nó costs rich-kết quả eligibility, không thứ hạng.

Dữ liệu có cấu trúc lỗi triage — checklist

truyền để tìm, prioritize, và khắc phục schema các lỗi correctly:

• Separated các lỗi từ warnings — các lỗi (bắt buộc bị thiếu / unparsable) block đó rich kết quả; warnings (được khuyến nghị bị thiếu) không. Cách sửa các lỗi đầu tiên.
• Checked đó Unparsable dữ liệu có cấu trúc báo cáo — bất cứ điều gì có malformed JSON (trailing comma, unescaped quote, bị thiếu colon/brace).
• Debugged unparsable items by stripping để an empty object và re-thêm properties until điều này breaks; re-tested sau mỗi thay đổi (một cách sửa có thể unmask hidden các lỗi).
• Confirmed mỗi bắt buộc thuộc tính là present cho mỗi loại (theo đó Tìm kiếm Gallery), thì được khuyến nghị ones — độ chính xác over padding.
• Giá trị types là correct — numbers nơi numbers belong, URLs nơi URLs belong, dates as dates; không strings standing trong cho them.
• Đọc nested-thuộc tính các lỗi’ parentheticals — Missing field "name" (in "author") tells bạn chính xác mà object là ngắn một trường.
• @id các giá trị là ổn định và unique theo real entity — không duplicate/colliding @id, không theo-trang regeneration (watch cho theme + plugin cả hai emitting nodes).
• Mọi thứ marked lên là visible on đó trang và là một đúng representation of điều này — không invisible nội dung, không fake/aggregate ratings đó xuất hiện nowhere.
• Không reliance on một deprecated loại — FAQ (đã biến mất Có thể 2026), HowTo desktop (2023), đó June 2025 batch. Hợp lệ markup, nhưng zero SERP payoff.
• Ran đó right tool cho đó câu hỏi — Schema Markup Validator (syntax), Rich Kết quả Kiểm thử (Google eligibility + preview), Rich kết quả báo cáo (site-wide monitoring).
• Checked đó Manual Actions báo cáo — một structured-dữ liệu entry ở đó có nghĩa là một nội dung-mismatch policy violation, không một kỹ thuật lỗi.
• Sau sửa, confirmed crawlable (không robots-blocked / noindex), spot-checked với URL Inspection, thì đã nhấp Validate cách sửa — và set expectations: điều này có thể take hai weeks hoặc hơn.

Dữ liệu có cấu trúc các lỗi — bảng tra nhanh

** three tools (không conflate them)**

Passing một làm không có nghĩa là passing một.

lỗi so với. warning

lỗi classes và khắc phục

Fast facts

• Không phải là yếu tố xếp hạng — một cách sửa wins lại một SERP visual, không một xếp hạng (Mueller).
• Nội dung mismatch có thể trigger một manual hành động — đó một class với teeth.
• FAQ rich kết quả: đã biến mất by Có thể 7, 2026; FAQPage loại vẫn hợp lệ, chỉ không visual.
• Validating một cách sửa: “two weeks or more, depending on crawl frequency.” (bản dịch) «hai weeks hoặc hơn, depending on crawl frequency.»
• Rich kết quả báo cáo là một sample, không một comprehensive list of mỗi item.

Điều gì không để làm

recurring mistakes đó turn fixable schema vấn đề vào bigger một:

• Treating mỗi warning như an lỗi. MỘT bị thiếu được khuyến nghị thuộc tính là một warning — đó rich kết quả vẫn cho thấy. Chasing warnings by stuffing trong half-đúng dữ liệu là tệ hơn leaving them; Google explicitly prefers ít hơn, chính xác properties over hơn, sloppy ones.
• Trusting một báo cáo blindly. Search Console có mislabeled warnings as các lỗi trước (Oct 2022). Cross-kiểm tra một flagged item so với đó Rich Kết quả Kiểm thử rather hơn reacting để một single báo cáo.
• Marking lên nội dung đó không visible. Đó một class với real teeth — đây là một policy violation đó có thể trigger một manual hành động, không chỉ một silent mất mát of đó rich kết quả. Nếu một rating, price, hoặc fact không on đó trang, không put điều này trong đó schema.
• Copy-pasting giống hệt schema trên mỗi trang. Templated, non-unique markup (giống nhau review count sitewide) đọc as một representation vấn đề. Schema nên là cụ thể để đó trang đây là on.
• Regenerating @id theo trang, hoặc reusing một @id cho hai entities. Cả hai break entity references bên trong một @graph. Dùng một ổn định, unique @id theo thực tế entity — và watch cho một theme và một plugin cả hai emitting Organization/WebSite nodes.
• Panic-stripping hợp lệ-nhưng-deprecated markup. FAQ schema đã dừng earning một visual trong 2026, nhưng FAQPage là vẫn hợp lệ và Google vẫn parses điều này. Removing điều này gains bạn không có gì và risks breaking other markup khoảng điều này.
• Assuming “validates clean” (bản dịch) «validates sạch» = “rich result guaranteed.” (bản dịch) «rich kết quả guaranteed.» Các validator không kiểm tra Google nội dung-quality và spam-policy layer. MỘT syntactically perfect, policy-violating trang có thể vẫn là denied.
• Pointing mọi người tại đó old “Structured Data Testing Tool.” (bản dịch) «Dữ liệu có cấu trúc Kiểm thử Tool.» Điều này đã là refocused vào đó schema.org Schema Markup Validator by 2021. Cho 2026: Rich Kết quả Kiểm thử (Google eligibility) và Schema Markup Validator (schema.org syntax).
• Expecting an instant cách sửa. Sau “Validate fix,” (bản dịch) «Validate cách sửa,» Google re-crawl on của nó own schedule — “two weeks or more, depending on crawl frequency.” (bản dịch) «hai weeks hoặc hơn, depending on crawl frequency.» không re-file đó giống nhau vấn đề trong một panic.

các tài nguyên worth của bạn time

My related writing

• Dữ liệu có cấu trúc: Điều gì nó là và Cách sử dụng nó — my Ahrefs hướng dẫn để schema types, implementation các phương thức, validation tools, và sameAs risk — xây dựng-side đối tác tương ứng để điều này khắc phục sự cố piece.
• Google Dùng ~40 Các tín hiệu canonicalization — my canonicalization hướng dẫn; ổn định-identifier-theo-thực-điều logic behind sửa duplicate @id các lỗi mirrors canonical selection.
• Người mới bắt đầu Hướng dẫn để kỹ thuật SEO — nơi dữ liệu có cấu trúc (và của nó các lỗi) fit vào rộng hơn kỹ thuật picture.

Chính thức

• Google Chung Dữ liệu có cấu trúc Guidelines — đó nội dung-mismatch/hidden-nội dung policy và đó manual-hành động consequence.
• Google Unparsable dữ liệu có cấu trúc báo cáo — đó malformed-JSON lỗi strings và đó strip-để-empty-object gỡ lỗi tip.
• Google Cách sửa dữ liệu có cấu trúc các vấn đề trong Search Console — đó cách sửa → Validate cách sửa workflow và đó “two weeks or more” (bản dịch) «hai weeks hoặc hơn» timing.
• Google Rich kết quả báo cáo overview — hợp lệ/không hợp lệ definitions và đó “sample, not comprehensive” (bản dịch) «sample, không comprehensive» caveat.
• Google Tìm kiếm Gallery — đó hiện tại list of types đó earn rich kết quả (kiểm tra trước assuming một loại là trực tiếp).
• Rich Kết quả Kiểm thử (Google) và Schema Markup Validator (schema.org) — đó hai single-URL tools, cho hai khác nhau các câu hỏi.

Từ khoảng đó ngành

• Google: Dữ liệu có cấu trúc Không Làm Trang web của bạn Xếp hạng Tốt hơn (Công cụ tìm kiếm Roundtable, April 2025) — Mueller “won’t make your site rank better,” (bản dịch) «sẽ không làm trang web của bạn xếp hạng tốt hơn,» đó cách diễn đạt đó reorients vì sao bạn cách sửa các lỗi tại all.
• Google John Mueller: Dữ liệu có cấu trúc Nên Là Unique để Mỗi Trang (Search Engine Journal) — đó nguồn cho đó templated-schema mistake.
• Google Search Console Mislabeled Dữ liệu có cấu trúc Các lỗi As Các lỗi (Search Engine Land, Oct 2022) — đó reporting-bug incident behind “don’t trust one report blindly.” (bản dịch) «không trust một báo cáo blindly.»
• Google Search Console Dữ liệu có cấu trúc Lỗi Reporting Gains Hơn Contextual Information (Search Engine Land, March 2022) — đó nested-thuộc tính context thay đổi (… (in "author")).
• Google Drops FAQ Rich Kết quả Từ Tìm kiếm (Search Engine Journal) — coverage of đó FAQ removal và điều gì vẫn giữ hợp lệ.
• r/TechSEO — đó community cho schema-lỗi và rich-kết quả gỡ lỗi.

Hỏng so với. fixed JSON-LD

Four của lỗi classes điều này bài viết covers, mỗi shown as minimal hỏng snippet tiếp theo để fixed version. những điều này là simplified các ví dụ — thực JSON-LD thường có nhiều hơn properties khoảng hỏng một.

Trailing comma

// Broken — trailing comma after "price" breaks JSON parsing entirely
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Trail Running Shoe",
  "offers": {
    "@type": "Offer",
    "price": "89.99",
  }
}

// Fixed — comma removed after the last property
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Trail Running Shoe",
  "offers": {
    "@type": "Offer",
    "price": "89.99"
  }
}

Điều gì sai: comma sau khi cuối cùng thuộc tính trong object là hợp lệ trong JavaScript nhưng không hợp lệ trong JSON — điều này lands item trong Unparsable dữ liệu có cấu trúc báo cáo vì Google có thể’t determine loại tại all.

Unescaped quote

// Broken — the inch mark inside "description" terminates the string early
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Monitor Stand",
  "description": "Fits a 27" display comfortably"
}

// Fixed — the inner quote is escaped
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Monitor Stand",
  "description": "Fits a 27\" display comfortably"
}

điều gì là sai: an unescaped " bên trong một string giá trị ends đó string tại đó point, breaking mọi thứ sau điều này. Google được ghi lại lỗi string cho này là “Bad escape sequence in string.” (bản dịch) «Bad escape sequence trong string.»

sai giá trị loại

// Broken — ratingValue is a string, not a number
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Trail Running Shoe",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "five stars",
    "reviewCount": "42"
  }
}

// Fixed — ratingValue is a number; reviewCount is a number too
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Trail Running Shoe",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": 4.6,
    "reviewCount": 42
  }
}

điều gì là sai: đó JSON là syntactically hợp lệ, so này truyền basic phân tích cú pháp — nhưng Google flags điều này as “Incorrect value type” (bản dịch) «Incorrect giá trị loại» vì ratingValue cần một number, không một text string như "five stars".

Duplicate @id

// Broken — the theme AND a plugin each emit their own "#organization" @id
// with different data, colliding inside the site's @graph
{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", "@id": "https://example.com/#organization", "name": "Example Co" },
    { "@type": "Organization", "@id": "https://example.com/#organization", "name": "Example Company Inc." }
  ]
}

// Fixed — one stable, unique @id per real-world entity
{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", "@id": "https://example.com/#organization", "name": "Example Company Inc." }
  ]
}

Điều gì sai: reusing giống nhau @id cho hai khác representations của giống nhau entity tạo ambiguity về mà một reference points để — pick một ổn định identifier, reused consistently, không bao giờ regenerated theo trang.

Prompts cho gỡ lỗi dữ liệu có cấu trúc các lỗi

Paste-và-chạy prompts cho hai điều này bài viết lỗi list là thực ra hữu ích cho: finding phân tích cú pháp lỗi trong hỏng JSON-LD, và kiểm tra block so với bắt buộc-so với-được khuyến nghị phân biệt.

tìm phân tích cú pháp lỗi trong hỏng JSON-LD

Paste trong: thô JSON-LD block đó failing (copy nó straight từ view-nguồn hoặc Rich Kết quả Kiểm thử code view).

Here is a JSON-LD structured data block that Google's Rich Results Test is
flagging as unparsable. Find the syntax error (trailing comma, unescaped
quote, or missing colon or brace) and tell me the exact line and character
that's wrong. Then give me the corrected JSON. Don't change any property
values, only fix the syntax.

[paste the broken JSON-LD block here]

Kết quả mong đợi: đó cụ thể syntax vấn đề named (không chỉ “there’s an error somewhere” (bản dịch) «có an lỗi nơi nào đó»), plus một corrected block bạn có thể diff so với đó original để xác nhận không có gì khác changed. Re-chạy đó fixed block qua đó Rich Kết quả Tự kiểm tra — một cách sửa có thể unmask một second, previously-hidden lỗi, so không treat một AI truyền as đó cuối word.

kiểm tra bắt buộc so với. được khuyến nghị properties cho loại

Paste trong: JSON-LD block plus schema.org loại name bạn’re targeting (e.g. Product, Recipe, Event).

This is a JSON-LD block using schema.org type [TYPE]. Based on Google's
required and recommended properties for this type in its Search Gallery
documentation, tell me: (1) which required properties are missing —
these block the rich result entirely, (2) which recommended properties
are missing — these only produce warnings, and (3) whether any present
value looks like the wrong type (text where a number, URL, or date is
expected).

[paste the JSON-LD block here]

Điều gì để expect lại: split list — bắt buộc gaps đầu tiên, since những điều đó là Điều gì block eligibility — không flat list treating mỗi bị thiếu trường as equally urgent. Verify loại-cụ thể requirements so với Google own Tìm kiếm Gallery trang trước khi acting, since AI-model knowledge của Google chính xác bắt buộc-thuộc tính lists có thể là stale.

Proving schema khắc phục thực ra took effect

Đó bài viết own “Validate fix” (bản dịch) «Validate cách sửa» workflow — cách sửa on-site, xác nhận crawlable, spot-kiểm tra, nhấp Validate cách sửa, chờ — turned vào truyền/fail kiểm tra.

Rich Kết quả Kiểm thử hiển thị loại với zero các lỗi

Kiểm thử để chạy: Paste trực tiếp trang URL (hoặc fixed JSON-LD snippet) vào Rich Kết quả Kiểm thử. Dự kiến kết quả: đích loại (e.g. Product, Recipe) là detected với 0 các lỗi — warnings cho được khuyến nghị properties là acceptable. thất bại interpretation: nếu loại vẫn hiển thị giống nhau lỗi, khắc phục either đã không deploy để trực tiếp trang hoặc đã không address thực tế thuộc tính lỗi named — re-đọc parenthetical on bất kỳ nested-thuộc tính lỗi. Monitoring window: Immediate — điều này kiểm thử đọc hiện tại trực tiếp markup, không được lưu đệm hoặc được crawl version. Rollback trigger: nếu previously-passing loại hiện tại hiển thị new lỗi nó đã không có trước khi, khắc phục có khả năng broke điều gì đó khác trong giống nhau @graph — revert và re-apply nhiều hơn narrowly.

trang là confirmed crawlable trước khi requesting revalidation

Kiểm thử để chạy: URL Inspection tool trong Search Console on đó fixed trang. Dự kiến kết quả: “URL is on Google” (bản dịch) «URL là on Google» (hoặc “URL is available to Google” (bản dịch) «URL là khả dụng để Google») với không robots.txt block và không noindex directive. Failure interpretation: Nếu đó trang là blocked hoặc noindexed, Google sẽ không re-crawl điều này regardless of cách sạch đó schema là — clicking “Validate fix” (bản dịch) «Validate cách sửa» on một blocked trang là một wasted cycle. Monitoring window: Immediate — URL Inspection đọc đó hiện tại crawl và chỉ mục status. Rollback trigger: Không applicable ở đây — này là một precondition kiểm tra, không một thay đổi để roll lại.

Search Console’s Validate khắc phục xử lý resolves vấn đề

Kiểm thử để chạy: Trong Search Console’s affected vấn đề, nhấp Validate cách sửa sau confirming đó hai các kiểm thử trên truyền. Dự kiến kết quả: Đó vấn đề status moves từ “Failed”/“Không đã bắt đầu” để “Đã bắt đầu,” thì eventually để “Đã truyền,” và đó affected-trang count cho đó vấn đề drops. Failure interpretation: MỘT status of “Failed” sau validation có nghĩa là Google re-được crawl và vẫn được tìm thấy đó vấn đề — go lại để đó Rich Kết quả Kiểm thử on đó trực tiếp URL để see điều gì là vẫn sai trước re-requesting. Monitoring window: Theo Google own hướng dẫn, “can take two weeks or more, depending on crawl frequency” (bản dịch) «có thể take hai weeks hoặc hơn, depending on crawl frequency» — không re-file đó giống nhau vấn đề trước đó window có đã truyền. Rollback trigger: Nếu đó vấn đề count là climbing thay vì falling sau đó monitoring window, đó cách sửa có khả năng đã không applied site-wide (e.g., chỉ một template đã cập nhật, không all các trang dùng đó loại) — audit cho other các trang vẫn emitting đó hỏng markup.

standing KPI: Rich kết quả báo cáo theo thời gian

Sửa một trang schema là một-off task. Watching liệu dữ liệu có cấu trúc vẫn giữ healthy trang web-wide là ongoing việc đo lường, và Search Console’s Rich kết quả báo cáo là tool được xây dựng cho chính xác đó.

Hợp lệ items (theo loại)

Chỉ số: count của hợp lệ items Search Console các báo cáo cho mỗi rich-kết quả loại của bạn trang web dùng (e.g., Product, Recipe, Article). Điều gì nó tells bạn: Cách nhiều sampled items của đó loại hiện tại truyền Google eligibility rules — number đó thực ra eligible để hiển thị rich kết quả. Cách pull nó: Search Console → Rich kết quả báo cáo, filtered để cụ thể loại; hợp lệ-items count và trend line là on báo cáo overview. Benchmark / realistic range: có không universal healthy percentage — Điều gì được tính as “good” phụ thuộc vào Cách nhiều các trang trên trang web củ bạn nên carry đó loại tại all. đặt của bạn own baseline đầu tiên time bạn kiểm tra: note hiện tại hợp lệ-item count, sau đó watch cho movement từ đó number rather hơn comparing để ngành hình. Cadence: Monthly, hoặc right sau khi bất kỳ template/schema-plugin thay đổi — since Google các báo cáo là sampled, không over-đọc week-để-week noise.

Không hợp lệ items (theo loại)

Chỉ số: count của không hợp lệ items — items với ít nhất một cốt yếu vấn đề blocking rich-kết quả eligibility. Điều gì nó tells bạn: nơi new hoặc unresolved các lỗi là accumulating, hỏng out by cụ thể vấn đề loại (bị thiếu trường, unparsable, etc.) so Bạn có thể prioritize mà vấn đề ảnh hưởng phần lớn các trang. Cách pull nó: giống nhau Rich kết quả báo cáo, không hợp lệ-items bảng; nhấp vấn đề để see list của affected các trang. Benchmark / realistic range: không bao giờ bịa ra — điều này number nên trend toward zero cho các vấn đề bạn’ve fixed, nhưng starting count là whatever của bạn trang web hiện tại có. sử dụng của bạn đầu tiên đọc as baseline và track delta sau khi mỗi khắc phục cycle, không so với chung đích. Cadence: Monthly tại minimum; kiểm tra trong day hoặc hai của bất kỳ bulk nội dung hoặc template thay đổi, since hỏng template có thể spike không hợp lệ items trên mỗi trang sử dụng nó.

Unparsable dữ liệu có cấu trúc count

Chỉ số: Đó item count trong đó tách biệt Unparsable dữ liệu có cấu trúc báo cáo (malformed JSON-LD đó broke phân tích cú pháp hoàn toàn). Điều gì điều này tells bạn: Liệu một code-cấp độ bug (một template đó concatenates strings không có escaping quotes, chẳng hạn) là actively producing hỏng markup, as opposed để một nội dung-cấp độ eligibility khoảng trống. Cách pull điều này: Search Console → Unparsable dữ liệu có cấu trúc báo cáo. Benchmark / realistic range: Đó honest đích là zero, since unparsable markup là một pure syntax bug, không một judgment call về mà properties để bao gồm — nhưng có không defensible “acceptable rate” (bản dịch) «acceptable rate» trên zero để so sánh so với; đó giá trị trong tracking này chỉ số là watching điều này trả về để zero sau một cách sửa, không một benchmark number. Cadence: Kiểm tra sau mỗi deploy đó touches schema-generating code hoặc một schema plugin cập nhật; nếu không monthly alongside đó other hai các báo cáo.

Tự kiểm tra: Dữ liệu có cấu trúc các lỗi

Five nhanh các câu hỏi on các lỗi đó block rich kết quả — và Cách khắc phục them. Pick câu trả lời cho mỗi, sau đó kiểm tra.

Nhật ký thay đổi