Hướng dẫn về JSON-LD

Tóm tắt — JSON-LD là nhỏ block của code bạn thêm để trang để spell out Điều gì trang là về — đó nó bài viết, sản phẩm, recipe — trong format các công cụ tìm kiếm và AI các hệ thống đọc easily. nó sits trong của nó own <script> tag và không bao giờ thay đổi bất cứ điều gì khách truy cập see. Google khuyến nghị nó over khác hai formats vì nó easiest để thêm và giữ tidy. nó sẽ không làm bạn xếp hạng cao hơn, nhưng nó có thể làm của bạn kết quả look richer (stars, prices, FAQs).

Điều gì JSON-LD là

Khi bạn publish một trang, một human có thể đọc điều này và hình out “oh, this is a recipe for banana bread.” (bản dịch) «oh, này là một recipe cho banana bread.» MỘT công cụ tìm kiếm có để guess đó từ đó words. Structured dữ liệu là cách bạn dừng đó guessing — bạn label đó trang trong machine-readable code so engines know đây là một recipe, ai đó tác giả là, điều gì đó rating là.

JSON-LD là phần lớn popular way để ghi đó label. name stands cho JavaScript Object Notation cho Linked Dữ liệu. Evidence for this claim JSON-LD is a structured-data format that can express Schema.org types and properties in a script block. Scope: Schema.org JSON-LD guidance; JSON-LD is a format, not the vocabulary itself. Confidence: high · Verified: 2026-07-14 Schema.org: JSON-LD bạn không cần để know Điều gì đó có nghĩ là để sử dụng nó. trên thực tế, JSON-LD là chunk của code đó looks như list của labelled facts, tucked bên trong <script> tag:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to Bake Banana Bread",
  "author": { "@type": "Person", "name": "Patrick Stox" },
  "datePublished": "2026-06-26"
}
</script>

Điểm mấu chốt điều: đó block lives riêng từ words on của bạn trang. nó không thay đổi single điều của bạn khách truy cập see. nó chỉ instructions cho robots.

Vì sao Google likes nó

có thực ra three ways để ghi dữ liệu có cấu trúc — JSON-LD, Microdata, và RDFa. khác hai hoạt động by sprinkling extra code vào của bạn visible HTML, tangled lên với của bạn headings và paragraphs. JSON-LD giữ nó all trong một neat box.

đó là vì sao Google khuyến nghị JSON-LD: đây là đó easiest để thêm, đó easiest để giữ correct, và bạn là far ít hơn có khả năng để break điều gì đó. Google words: đây là “the easiest solution for website owners to implement and maintain at scale.” (bản dịch) «đó easiest giải pháp cho website owners để implement và maintain tại quy mô.» All three formats là fine — JSON-LD là chỉ đó least lỗi-prone.

Điều gì nó thực ra làm cho bạn

Hai honest điều, và một myth:

• Điều này có thể làm của bạn tìm kiếm kết quả look richer. Recipe ratings, sản phẩm prices, FAQ dropdowns, event dates — những “rich results” (bản dịch) «rich kết quả» come từ dữ liệu có cấu trúc.
• Điều này helps engines (và AI) understand nội dung của bạn. Điều này connects trang của bạn để known điều — của bạn business, an tác giả, một sản phẩm.
• Điều này làm không làm bạn xếp hạng cao hơn. Này là đó myth. Thêm JSON-LD không phải một xếp hạng boost. Google có đã nói này plainly và repeatedly.

một rule đó matters

chỉ mark lên Điều gì thực ra on trang. không claim 5-star rating trong của bạn JSON-LD nếu không rating là shown để khách truy cập. không mô tả price đó không phải ở đó. Dữ liệu có cấu trúc có để match visible trang — describing điều đó không phải ở đó là so với rules và có thể nhận của bạn rich kết quả pulled.

Muốn precise version — @context / @type / @id syntax, @graph pattern, JavaScript-injection trap đó hides của bạn markup từ AI các crawler, và Cách validate nó? Chuyển để Nâng cao tab.

Tóm tắt — JSON-LD (JavaScript Object Notation cho Linked Dữ liệu) là W3C Khuyến nghị từ 2014 — được xây dựng on JSON, nhưng @context là Điều gì làm nó linked dữ liệu, không chỉ JSON. nó dữ liệu có cấu trúc format Google khuyến nghị vì nó easiest để implement và maintain tại quy mô và không bao giờ touches visible HTML; Microdata và RDFa là equally hợp lệ Khi đúng. syntax spine là @context (vocabulary — schema.org cho phần lớn SEO markup, though spec cho phép khác contexts), @type (entity), @id ( hữu ích nhưng tùy chọn ổn định URI cho cross-referencing entities — basis của @graph, itself một hợp lệ pattern among others, không requirement). Place nó trong <head> hoặc <body> — Google accepts either. Googlebot renders JS so dynamically injected JSON-LD hoạt động cho Google; several AI các crawler (GPTBot, ClaudeBot được bao gồm, as tested) không execute JS, nhưng đó provider- và date-cụ thể — verify trực tiếp thay vì assuming nó cho mỗi AI crawler, và máy chủ-render Điều gì Bạn có thể’t xác nhận. Dữ liệu có cấu trúc là không tín hiệu xếp hạng — nó drives rich-kết quả eligibility và entity understanding, và nó phải mô tả nội dung visible on trang.

JSON-LD là format, không vocabulary

đầu tiên, phân biệt đó clears lên lot của confusion: JSON-LD là format; schema.org là vocabulary. JSON-LD là Cách bạn ghi markup; schema.org Article, Product, Organization types là Điều gì bạn chẳng hạn. Rich kết quả là feature layer bên cạnh cả hai. điều này trang là về format. ( vocabulary-cho-AI angle lives trong Schema Markup cho AI.)

JSON-LD là W3C Khuyến nghị, đầu tiên published trong 2014 — nó có trước của nó SEO adoption và là designed cho chung linked-dữ liệu interoperability trên web, không cụ thể Đối với tìm kiếm. đó history là Vì sao thuộc tính như @id tồn tại all, và nó spec-cấp độ point phần lớn SEO các hướng dẫn skip: JSON-LD không phải chỉ JSON. nó được xây dựng on JSON syntax, nhưng @context declaration là Điều gì làm dữ liệu linked — identifiable và connectable trên web. Strip @context và bạn’ve đã nhận dữ liệu parser có thể’t interpret.

JSON-LD cũng không married để schema.org. Đó spec lets @context reference bất kỳ published vocabulary — của nó own các ví dụ link để non-schema.org contexts — so JSON-LD là đó right câu trả lời để “điều gì format” trong khi schema.org là một câu trả lời, đó phổ biến một cho tìm kiếm và AI-tìm kiếm markup, để “what vocabulary.” (bản dịch) «điều gì vocabulary.» MỘT trang có thể validly dùng JSON-LD với một khác nhau vocabulary; điều này chỉ sẽ không là schema.org markup anymore.

JSON-LD so với. Microdata so với. RDFa

có three ways để express dữ liệu có cấu trúc, và Google hỗ trợ tất cả them:

Google khuyến nghị là rõ ràng nhưng narrowly scoped: “In general, Google recommends using JSON-LD for structured data if your site’s setup allows it, as it’s the easiest solution for website owners to implement and maintain at scale (in other words, less prone to user errors).” (bản dịch) «Nhìn chung, Google khuyến nghị dùng JSON-LD cho dữ liệu có cấu trúc nếu trang web của bạn setup cho phép điều này, as đây là đó easiest giải pháp cho website owners để implement và maintain tại quy mô (nói cách khác, ít hơn prone để người dùng các lỗi).»

Đó nuance các đối thủ thường drop — và đó một worth giữ — xuất hiện từ đó giống nhau Google trang: “All 3 formats are equally fine for Google, as long as the markup is valid and properly implemented per the feature’s documentation.” (bản dịch) «All 3 formats là equally fine cho Google, miễn là đó markup là hợp lệ và properly implemented theo đó feature tài liệu.» So đó khuyến nghị là về implementation ease và lỗi rate, không phân tích cú pháp speed hoặc xếp hạng advantage. Dùng Microdata không phải một hình phạt. JSON-LD chỉ wins trong thực tế vì điều này không entangle dữ liệu có cấu trúc với đó markup một designer có thể edit tomorrow.

syntax: @context, @loại, @id, properties, nesting

Ở đây annotated Article block:

<script type="application/ld+json">
{
  "@context": "https://schema.org",          // the vocabulary — the common value for SEO
  "@type": "Article",                          // the entity type
  "@id": "https://example.com/post#article",   // a stable URI for this entity
  "headline": "How JSON-LD Works",            // a property (key/value)
  "datePublished": "2026-06-26",
  "author": {                                  // a nested entity
    "@type": "Person",
    "name": "Patrick Stox",
    "url": "https://patrickstox.com/"
  }
}
</script>

• @context — establishes semantic framework ( vocabulary). cho schema.org SEO markup nó typically "https://schema.org", nhưng đó convention, không rule: @context maps terms để identifiers, và spec lets nó point để khác vocabularies. nó tells parser Cách interpret mỗi thuộc tính name đó follows. Đây là part đó làm nó linked dữ liệu.
• @type — declares entity: Article, Product, Organization, BreadcrumbList, etc. nó maps để schema.org loại. sử dụng phần lớn cụ thể applicable loại — NewsArticle over Article nếu nó fits.
• @id — unique URI identifying tài nguyên. nó mechanism đó lets bạn reference một entity từ một (see @graph dưới), và nó worth setting on bất cứ điều gì bạn’ll cross-reference — nhưng nó không universally bắt buộc. JSON-LD spec permits unidentified blank nodes, so hợp lệ JSON-LD có thể omit @id on entities bạn không bao giờ cần để reference elsewhere.
• Properties — ordinary JSON mấu chốt/giá trị pairs, sử dụng vocabulary terms từ @context.
• Nesting — child entities là expressed as nested JSON objects ( author object trên) hoặc arrays của objects.

@graph pattern ( scalable approach)

phần lớn các trang cần nhiều hơn một entity: Organization, WebSite, BreadcrumbList, và Article hoặc WebPage itself. naive approach là four tách biệt <script> chặn đó repeat dữ liệu. scalable alternative là single block với @graph — array của entities, cross-referenced by @id. Neither JSON-LD spec nor Google mandates @graph as ** pattern — nó syntax cho expressing graph, và khác hợp lệ layouts exist (tách biệt typed chặn, nested objects không có top-cấp độ @graph, blank nodes với không @id tại all) — nhưng on trang web với several cross-referenced entities, nó pattern đó tránh repeating giống nhau Organization hoặc WebSite dữ liệu on mỗi trang:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://example.com/#org",
      "name": "Example Co",
      "url": "https://example.com/"
    },
    {
      "@type": "WebSite",
      "@id": "https://example.com/#website",
      "url": "https://example.com/",
      "publisher": { "@id": "https://example.com/#org" }   // reference, not a copy
    },
    {
      "@type": "WebPage",
      "@id": "https://example.com/post#webpage",
      "isPartOf": { "@id": "https://example.com/#website" },
      "breadcrumb": { "@id": "https://example.com/post#breadcrumb" }
    }
  ]
}
</script>

Define Organization khi, thì point tại điều này với { "@id": "...#org" } mọi nơi khác thay vì repeating đó name, logo, và URL. Này là cách đó major CMS schema plugin xây dựng của họ output, và đây là vì sao @id tồn tại. Bing làm đó giống nhau case cho JSON-LD’s nesting: điều này “makes defining links and relationships between data and entities… easy because it supports nested data.” (bản dịch) «làm defining links và relationships giữa dữ liệu và entities… easy vì điều này hỗ trợ nested dữ liệu.»

nơi để place nó: <head> hoặc <body>

Google xác nhận cả hai hoạt động — “You can put the JSON-LD data in the <head> or the <body> of the page.” (bản dịch) «Bạn có thể put đó JSON-LD dữ liệu trong đó thẻ head hoặc đó thẻ thân phản hồi of đó trang.» <head> là conventional, nhưng plenty of CMS plugin inject điều này near đó end of <body>, và đó là fine. Bing agrees điều này có thể sit “in the header, body or foot of the page.” (bản dịch) «trong đó header, thân phản hồi hoặc foot of đó trang.» không burn time relocating một hợp lệ block từ thân phản hồi để head; điều này thay đổi không có gì. Evidence for this claim Google permits JSON-LD in either the head or body of an HTML document for supported structured-data features. Scope: Google Search JSON-LD guidance; markup must still match visible page content. Confidence: high · Verified: 2026-07-14 Google: Structured data introduction

Generating JSON-LD dynamically — và AI crawler catch

Bạn có thể xây dựng JSON-LD on fly với JavaScript, và Google documents hai ways để làm nó:

1. Google Tag Manager — một Custom HTML tag containing đó JSON-LD, pulling các giá trị từ GTM variables. (Tránh duplicating dữ liệu giữa đó trang và đó tag.)
2. Custom JavaScript — tạo đó script element programmatically:

   const script = document.createElement('script');
   script.setAttribute('type', 'application/ld+json');
   script.textContent = structuredDataText;
   document.head.appendChild(script);

Này hoạt động cho Googlebot, vì Google renders đó trang: “Google Search can understand and process structured data that’s available in the DOM when it renders the page.” (bản dịch) «Google Search có thể understand và xử lý dữ liệu có cấu trúc đó là khả dụng trong đó DOM khi điều này renders đó trang.» So far, so good.

Ở đây catch phần lớn các hướng dẫn miss, stated cẩn thận. Several AI các crawler — including GPTBot và ClaudeBot, as commonly tested — có không executed JavaScript. nếu của bạn JSON-LD chỉ tồn tại sau khi client-side script chạy, JS-skipping crawler không bao giờ sees nó — nó invisible để đó bot mặc dù Googlebot đọc nó fine, vì Google documents kết xuất DOM trước khi nó looks cho dữ liệu có cấu trúc.

Hai honest caveats on đó AI-crawler behavior: đây là Google own tài liệu đó establishes đó Googlebot side; đó AI-crawler side xuất hiện từ kiểm thử và reporting on riêng lẻ providers, không một spec bất kỳ of them publish, so đây là provider- và date-cụ thể — một crawler JavaScript hỗ trợ có thể thay đổi, và I haven’t verified mỗi provider trực tiếp. không treat “AI crawlers skip JS” (bản dịch) «AI các crawler skip JS» as một universal rule để xây dựng on; treat điều này as một reason để kiểm tra đó crawler bạn thực ra care về (hoặc default để máy chủ kết xuất khi bạn không thể kiểm tra). Nếu điều này không trong đó máy chủ-được kết xuất HTML và bạn haven’t confirmed đó crawler executes JS, assume điều này không thể see điều này. Cho AI-khả năng hiển thị trên tìm kiếm, render JSON-LD máy chủ-side vào đó static HTML trừ khi bạn đã verified nếu không. (Này là đó JavaScript-kết xuất vấn đề từ một structured-dữ liệu angle — see JavaScript SEO.)

có một second caveat cho ecommerce: Google warns đó dynamically generated Sản phẩm markup “can make Shopping crawls less frequent and less reliable,” (bản dịch) «có thể làm Shopping crawl ít hơn frequent và ít hơn reliable,» mà là một real vấn đề cho fast-thay đổi price và availability. Cho các sản phẩm, ưu tiên máy chủ-side kết xuất regardless of AI.

policies (những điều này có teeth hiện tại)

Google dữ liệu có cấu trúc guidelines là ngắn và load-bearing:

• “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.»
• “Don’t mark up irrelevant or misleading content, such as fake reviews.” (bản dịch) «không mark lên irrelevant hoặc misleading nội dung, such as fake reviews.»
• “Put the structured data on the page that it describes.” (bản dịch) «Put đó dữ liệu có cấu trúc on đó trang đó điều này mô tả.»
• “Use the most specific applicable type and property names defined by schema.org.” (bản dịch) «Dùng đó hầu hết cụ thể applicable loại và thuộc tính names được định nghĩa by schema.org.»
• không block của bạn structured-dữ liệu các trang từ Googlebot qua robots.txt hoặc noindex.

Đó visible-nội dung rule là đó một để internalize. Schema đó mô tả nội dung không shown on đó trang có luôn đã một violation; enforcement of “invisible” schema có tightened. Bing diễn đạt đó warning bluntly: “even though the markup is not visible on your page, it is still read by the search engines, and putting spam data in the markup can hamper your presence.” (bản dịch) «mặc dù đó markup không phải visible on trang của bạn, điều này là vẫn đọc by đó các công cụ tìm kiếm, và putting spam dữ liệu trong đó markup có thể hamper của bạn presence.»

phổ biến JSON-LD mistakes

• Markup đó không match visible trang — #1 policy vấn đề ( rating trong JSON-LD đó không khách truy cập sees).
• Malformed JSON — trailing comma, unescaped quote, hoặc Word smart quotes (" thay vì ") đó silently break toàn bộ block. JSON-LD là strict.
• sai thuộc tính names — inventing properties đó không phải trong schema.org, hoặc misspelling thực ones, so parser bỏ qua them.
• ** generic loại nơi cụ thể một tồn tại** — Thing hoặc Article nơi Recipe hoặc NewsArticle là warranted.
• Duplicate, inconsistent Organization chặn trên các trang với conflicting names/logos.
• Bị thiếu bắt buộc properties cho rich kết quả bạn’re targeting (mỗi feature lists của nó own bắt buộc các trường).
• JS-injected markup assumed để là visible để mỗi crawler — Google renders nó, nhưng some AI các crawler có không, và đó worth verifying theo crawler ( catch trên).

Validating JSON-LD

Four khác nhau các câu hỏi nhận asked dưới “is my JSON-LD valid,” (bản dịch) «là my JSON-LD hợp lệ,» và họ là không đó giống nhau câu hỏi — passing một không truyền đó others:

• Kiểm thử by URL, không pasted code, cho JS-được kết xuất các trang. Rich Kết quả Kiểm thử code-input chế độ không chạy của bạn scripts hoặc resolve relative references way trực tiếp-URL kiểm thử làm — nó có thể’t tell bạn Điều gì client-side-injected block looks như sau khi kết xuất.
• Bing Quản trị viên web Tools — Markup Validator — Bing có validated JSON-LD since August 2018.
• None của những điều này các kiểm thử speak cho các crawler đó không render JavaScript (see AI-crawler caveat trên) — kiểm thử được kết xuất URL xác nhận Điều gì Google sees, không Điều gì JS-skipping bot nhận.

Làm JSON-LD help SEO?

đặt expectations honestly:

• không tín hiệu xếp hạng. John Mueller có đã nói dữ liệu có cấu trúc sẽ không làm trang web xếp hạng tốt hơn. đầy đủ dừng.
• Rich-kết quả eligibility. nó Điều gì làm bạn eligible cho enhanced SERP features (stars, prices, FAQs, breadcrumbs) — eligibility, không bảo đảm.
• CTR, indirectly. Richer-looking kết quả có thể earn nhiều hơn clicks, mà là thực payoff cho phần lớn các trang.
• Entity understanding. nó helps engines connect của bạn trang để known entities và Knowledge Graph.
• AI tìm kiếm. Fabrice Canel (Bing) confirmed trong 2025 đó schema markup helps Microsoft LLMs understand nội dung — nhưng note controlled-nghiên cứu caveat từ Schema Markup cho AI: nó infrastructure cho disambiguation, không trực tiếp citation lever.

So: implement JSON-LD cho rich-kết quả eligibility, entity clarity, và AI/LLM comprehension — không as xếp hạng hack.

điều này bài viết sits trong dữ liệu có cấu trúc hub. cho AI-cụ thể take on schema.org vocabulary, see Schema Markup cho AI; cho kết xuất mechanics behind dynamic injection, see JavaScript SEO.

AI summary

condensed take on Nâng cao version:

• Điều gì điều này là: JSON-LD (JavaScript Object Notation cho Linked Dữ liệu) là một dữ liệu có cấu trúc format, không một vocabulary — một <script type="application/ld+json"> block. On đó SEO side đây là typically paired với đó schema.org vocabulary, nhưng @context có thể point elsewhere. MỘT W3C Khuyến nghị since 2014; được xây dựng on JSON, nhưng @context là điều gì làm điều này linked dữ liệu, không đơn giản JSON.
• Vì sao Google khuyến nghị điều này: đây là “the easiest solution… to implement and maintain at scale” (bản dịch) «đó easiest giải pháp… để implement và maintain tại quy mô» và không bao giờ touches visible HTML. Nhưng all three formats (JSON-LD, Microdata, RDFa) là equally hợp lệ khi correct — đó edge là lỗi rate, không phân tích cú pháp hoặc xếp hạng.
• Syntax spine: @context (vocabulary — schema.org cho hầu hết SEO markup, không đó chỉ hợp lệ giá trị) · @type (entity, dùng đó hầu hết cụ thể) · @id (hữu ích, tùy chọn ổn định URI cho cross-referencing; unidentified blank nodes là cũng hợp lệ JSON-LD) · properties (key/giá trị) · nesting (objects/arrays).
• @graph pattern: một block, an array of entities cross-referenced by @id — define Organization khi, reference điều này mọi nơi. MỘT scalable approach cho multi-entity các trang, không một spec hoặc Google mandate; other hợp lệ graph layouts exist.
• Placement: <head> hoặc <body> — Google accepts either; không relocate hợp lệ chặn.
• Dynamic injection + AI caveat: Googlebot renders JS so injected JSON-LD hoạt động cho Google; several AI các crawler — GPTBot và ClaudeBot được bao gồm, as tested — có không executed JS, nhưng đó là provider- và date-cụ thể, không một universal rule, so verify theo crawler và máy chủ-render điều gì bạn không thể xác nhận. Dynamic Sản phẩm markup cũng risks ít hơn-frequent Shopping crawl.
• Policies: mark lên chỉ visible nội dung; match đó trang; hầu hết-cụ thể loại; không block đó trang từ các crawler. Enforcement of “invisible” schema có tightened.
• Các lỗi thường gặp: mismatched/invisible markup, malformed JSON (smart quotes, trailing commas), sai thuộc tính names, generic types, bị thiếu bắt buộc properties.
• Validation: four tách biệt kiểm tra (JSON syntax, schema.org vocabulary, Google rich-kết quả eligibility, trực tiếp Search Console phân tích cú pháp) đó không substitute cho mỗi other — Rich Kết quả Kiểm thử (by URL, không pasted code), Schema.org Validator, GSC Enhancements, Bing Markup Validator.
• SEO effect: không phải là tín hiệu xếp hạng. Drives rich-kết quả eligibility, CTR, entity understanding, và LLM comprehension (Canel, Bing, 2025).

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

Chính-nguồn tài liệu từ các công cụ tìm kiếm và spec.

Google

• Intro để Cách Đánh dấu dữ liệu có cấu trúc Hoạt động — đó JSON-LD khuyến nghị, đó “all 3 formats are equally fine” (bản dịch) «all 3 formats là equally fine» nuance, và <head>/<body> placement.
• Chung Dữ liệu có cấu trúc Guidelines — đó policies: visible nội dung chỉ, match đó trang, hầu hết-cụ thể loại, không block các crawler.
• Generate dữ liệu có cấu trúc với JavaScript — đó GTM và custom-JS injection approaches, plus đó dynamic-Sản phẩm Shopping-crawl caveat.
• Rich Kết quả Kiểm thử — validate eligibility (kiểm thử by URL cho JS-được kết xuất các trang).

Bing / Microsoft

• Marking Lên của bạn trang web với Dữ liệu có cấu trúc — Bing khuyến nghị JSON-LD, accepts header/thân phản hồi/footer placement, và warns về không hợp lệ markup.
• Introducing JSON-LD Hỗ trợ trong Bing Quản trị viên web Tools (Aug 2018) — Khi Bing đã thêm JSON-LD validation.

Các tiêu chuẩn / vocabulary

• JSON-LD 1,1 — W3C Khuyến nghị — spec itself.
• json-ld.org — format home, với đơn giản-language definition.
• Getting Đã bắt đầu với Schema.org — vocabulary JSON-LD expresses, và visible-nội dung rule.
• Schema.org Validator — validates so với vocabulary.

Quotes từ nguồn

On—record statements từ Google, Bing, và spec. mỗi link jumps để quoted passage on nguồn trang nơi trang exposes text.

Google tài liệu — khuyến nghị và nuance

• “In general, Google recommends using JSON-LD for structured data if your site’s setup allows it, as it’s the easiest solution for website owners to implement and maintain at scale (in other words, less prone to user errors).” (bản dịch) «Nhìn chung, Google khuyến nghị dùng JSON-LD cho dữ liệu có cấu trúc nếu trang web của bạn setup cho phép điều này, as đây là đó easiest giải pháp cho website owners để implement và maintain tại quy mô (nói cách khác, ít hơn prone để người dùng các lỗi).» Nhảy đến trích dẫn
• “All 3 formats are equally fine for Google, as long as the markup is valid and properly implemented per the feature’s documentation.” (bản dịch) «All 3 formats là equally fine cho Google, miễn là đó markup là hợp lệ và properly implemented theo đó feature tài liệu.» Nhảy đến trích dẫn
• “Google Search can understand and process structured data that’s available in the DOM when it renders the page.” (bản dịch) «Google Search có thể understand và xử lý dữ liệu có cấu trúc đó là khả dụng trong đó DOM khi điều này renders đó trang.» Nhảy đến trích dẫn

Google tài liệu — policies

• “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.» Nhảy đến trích dẫn
• “Use the most specific applicable type and property names defined by schema.org.” (bản dịch) «Dùng đó hầu hết cụ thể applicable loại và thuộc tính names được định nghĩa by schema.org.» Nhảy đến trích dẫn

John Mueller, Google — JSON-LD preference và xếp hạng

• “We currently prefer JSON-LD markup. I think most of the new structured data that kind of come out are for JSON-LD first. So that is what we prefer.” (bản dịch) «We hiện tại ưu tiên JSON-LD markup. I think hầu hết of đó new dữ liệu có cấu trúc đó kind of come out là cho JSON-LD đầu tiên. So đó là điều gì we ưu tiên.» — Google Quản trị viên web Hangout, March 2019. Coverage
• On thứ hạng: “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.» — 2025. (Relayed qua Công cụ tìm kiếm Roundtable; xác nhận verbatim so với đó original post.) Coverage

Bing / Microsoft

• JSON-LD “makes defining links and relationships between data and entities between the data present on your pages easy because it supports nested data.” (bản dịch) «làm defining links và relationships giữa dữ liệu và entities giữa đó dữ liệu present on của bạn các trang easy vì điều này hỗ trợ nested dữ liệu.» — Bing Quản trị viên web Tools tài liệu. Nhảy đến trích dẫn
• “Webmasters should be very alert as to not put invalid and incorrect information in the markup, as even though the markup is not visible on your page, it is still read by the search engines.” (bản dịch) «Quản trị viên web nên là very alert as để không put không hợp lệ và incorrect information trong đó markup, as mặc dù đó markup không phải visible on trang của bạn, điều này là vẫn đọc by đó các công cụ tìm kiếm.» — Bing Quản trị viên web Tools tài liệu. Nhảy đến trích dẫn

Fabrice Canel, Microsoft Bing — schema và LLMs

• Tại SMX Munich (March 2025), Canel confirmed schema markup helps Microsoft lớn language models understand web nội dung. (Paraphrased trên coverage; xác nhận verbatim so với conference recording hoặc LinkedIn trước khi treating bất kỳ single phrasing as cuối.) Coverage

** spec — json-ld.org**

• “JSON-LD is a lightweight Linked Data format. It is easy for humans to read and write. It is based on the already successful JSON format and provides a way to help JSON data interoperate at Web-scale.” (bản dịch) «JSON-LD là một lightweight Linked Dữ liệu format. Điều này là easy cho humans để đọc và ghi. Điều này là dựa trên đó đã successful JSON format và cung cấp một way để help JSON dữ liệu interoperate tại Web-quy mô.» Nhảy đến trích dẫn

JSON-LD syntax — bảng tham khảo nhanh

Đó wrapper

<script type="application/ld+json">
{ ...your markup... }
</script>

** reserved từ khóa**

Single entity

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Widget",
  "offers": { "@type": "Offer", "price": "19.99", "priceCurrency": "USD" }
}

Nesting — một child entity là một nested object (hoặc an array of objects):

"author": { "@type": "Person", "name": "Patrick Stox" }

Đó @graph pattern — define khi, reference by @id:

{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", "@id": "https://ex.com/#org", "name": "Ex Co" },
    { "@type": "WebSite", "publisher": { "@id": "https://ex.com/#org" } }
  ]
}

phổ biến properties by loại

• Article / BlogPosting: headline, author, datePublished, image, publisher
• Product: name, image, brand, offers (→ price, priceCurrency, availability)
• Organization: name, url, logo, sameAs (social/Wikidata URIs)
• BreadcrumbList: itemListElement → ListItem (position, name, item)
• FAQPage: mainEntity → Question → acceptedAnswer → Answer

Rules của thumb

• @context là "https://schema.org" cho phần lớn SEO markup — đó convention, không spec requirement. sử dụng straight quotes, không bao giờ smart quotes.
• Không trailing commas — JSON là strict.
• sử dụng phần lớn cụ thể @type khả dụng.
• Mark lên chỉ Điều gì visible on trang.
• Place trong <head> hoặc <body> — cả hai hợp lệ.
• @id và @graph help bạn cross-reference và organize entities nhưng không phải bắt buộc — blank nodes và khác layouts là hợp lệ cũng.
• cho các crawler bạn haven’t verified execute JavaScript (several AI các crawler, GPTBot và ClaudeBot được bao gồm, có không trong kiểm thử), render máy chủ-side.
• Validate as tách biệt layers: Rich Kết quả Kiểm thử (by URL) cho Google eligibility + Schema.org Validator cho vocabulary — một passing không có nghĩa là khác làm.

Tools cho validating JSON-LD

• Schema.org Validator — rộng hơn vocabulary kiểm tra. block có thể truyền ở đây và vẫn fail Google feature-cụ thể rules.
• Google Rich Kết quả Kiểm thử — kiểm thử deployed URL Khi kết xuất matters, especially cho client-side-injected markup. điều này kiểm thử covers Google supported rich kết quả, không mỗi schema.org loại.

JSON-LD mistakes để tránh

Marking lên facts khách truy cập không thể see. rating, price, tác giả, hoặc khác claim trong JSON-LD phải agree với visible trang. Hidden hoặc misleading dữ liệu có cấu trúc có thể cost trang của nó rich-kết quả eligibility. Làm thay vì: generate markup từ giống nhau nguồn của truth as visible nội dung.

Treating hợp lệ JSON as hợp lệ schema. parser có thể accept perfectly formed JSON whose thuộc tính names không exist trong schema.org. Làm thay vì: chạy cả hai JSON-LD vocabulary kiểm tra và đích feature Google requirements.

sử dụng smart quotes hoặc trailing commas. JSON là strict; typographic quotes và comma sau khi cuối thuộc tính có thể invalidate đểàn bộ block. Làm thay vì: serialize dữ liệu thay vì assembling JSON strings by hand.

Chọn generic loại Khi cụ thể một tồn tại. Thing hoặc rộng Article markup throws away hữu ích meaning Khi trang là rõ ràng Recipe, Product, hoặc NewsArticle. Làm thay vì: sử dụng phần lớn cụ thể applicable schema.org loại.

Duplicating entities với conflicting details. Multiple Organization chặn với khác names, logos, hoặc các URL làm graph ambiguous. Làm thay vì: cho entity một ổn định @id, define nó sau khi, và reference đó identifier elsewhere.

Assuming schema.org validity bảo đảm Google rich kết quả. Google hỗ trợ subset của types và adds bắt buộc properties và nội dung policies của nó own. Làm thay vì: validate vocabulary đầu tiên, sau đó kiểm thử eligibility cho cụ thể Google feature.

Injecting JSON-LD trong JavaScript và assuming mỗi crawler sees nó. Google có thể render client-side markup, nhưng JS-skipping AI các crawler có thể không bao giờ nhận nó. Làm thay vì: máy chủ-render JSON-LD Khi những điều đó consumers quan trọng, và kiểm thử trực tiếp URL thay vì chỉ pasted code.

Prove JSON-LD deployment took effect

Kiểm thử 1 — trực tiếp trang contains hợp lệ, trang-matching JSON-LD

• Kiểm thử để chạy — Fetch deployed URL với Schema Markup Validator và so sánh detected entities và các giá trị với visible trang.
• Dự kiến kết quả — JSON parses, all properties belong để schema.org, @id references resolve trong graph nơi dự kiến, và claims chẳng hạn như names, prices, ratings, và dates match Điều gì người dùng see.
• thất bại interpretation — Parser các lỗi point để malformed JSON; vocabulary warnings point để misspelled hoặc unsupported properties; mismatched các giá trị point để tách biệt nội dung và schema dữ liệu sources drifting apart.
• Monitoring window — Immediate sau khi deployment và bộ nhớ đệm clearance.
• Rollback trigger — Xóa hoặc revert new block nếu nó publishes sai visible-nội dung claims, breaks previously hợp lệ graph, hoặc không thể là parsed.

Kiểm thử 2 — đích tìm kiếm feature recognizes được kết xuất markup

• Kiểm thử để chạy — Chạy deployed URL qua Google Rich Kết quả Kiểm thử, sau đó sử dụng Rich-Kết quả Eligibility Checker để inspect bị thiếu bắt buộc và được khuyến nghị các trường by loại.
• Dự kiến kết quả — Google detects dự kiến supported loại không có cốt yếu các lỗi; bất kỳ client-side-generated block xuất hiện trong được kết xuất HTML.
• thất bại interpretation — Schema.org Validator truyền paired với Google thất bại thường có nghĩ là loại không phải supported Google feature, Google-bắt buộc trường là bị thiếu, nội dung policy là unmet, hoặc renderer không bao giờ đã nhận block.
• Monitoring window — Immediate trong cả hai các kiểm thử; Search Console thay đổi chờ cho recrawl.
• Rollback trigger — Roll lại client-side injection nếu nó làm previously visible dữ liệu có cấu trúc disappear từ được kết xuất kết quả, hoặc xóa unsupported feature claims từ launch cho đến khi bắt buộc nội dung là present.

Tự kiểm tra: JSON-LD

Five nhanh các câu hỏi on JSON-LD format. Pick câu trả lời cho mỗi, sau đó kiểm tra.

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

My related writing

• Schema Markup: Easy Way để Nhận Rich Kết quả — Ahrefs hướng dẫn để dữ liệu có cấu trúc, schema types, và rich kết quả ( feature layer bên cạnh JSON-LD).
• 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 fits trong rộng hơn kỹ thuật picture.
• JavaScript SEO Các vấn đề & Thực hành tốt nhất — kết xuất side: Vì sao JS-injected markup behaves differently cho các crawler đó không chạy JavaScript.
• Đáp ứng New Web Các crawler — my Cloudflare Radar analysis của AI các crawler (GPTBot, ClaudeBot và friends) — bots đó skip của bạn JS-injected schema.

Chính thức

• Google Intro để Cách Đánh dấu dữ liệu có cấu trúc Hoạt động — đó JSON-LD khuyến nghị và đó “all 3 formats” (bản dịch) «all 3 formats» nuance, straight từ đó nguồn.
• Google Generate dữ liệu có cấu trúc với JavaScript — đó dynamic-injection các phương thức và đó Sản phẩm caveat.
• JSON-LD 1,1 — W3C Khuyến nghị và json-ld.org — đó format itself.

Từ khoảng đó ngành

• Google On Mà Dữ liệu có cấu trúc Điều này Prefers — Search Engine Journal — đó ghi-lên of Mueller “we currently prefer JSON-LD” (bản dịch) «we hiện tại ưu tiên JSON-LD» comment.
• Microsoft Bing Copilot dùng schema cho của nó LLMs — Search Engine Land — Fabrice Canel SMX Munich 2025 xác nhận đó schema helps Bing LLMs.
• Điều gì Là JSON-LD Dữ liệu có cấu trúc & Vì sao Làm Bạn Cần Điều này? — Ignite Visibility — một solid beginner-cấp độ walkthrough.
• MỘT Beginner Hướng dẫn để JSON-LD Schema cho SEOs — SALT.agency — practical syntax-và-implementation hướng dẫn aimed tại SEOs.

Nhật ký thay đổi