Google guidelines and the rationale for recommending JSON-LD
A summary of Google Search Central's general policies for structured data (consistency with content / no invisible markup / no spam) and the rationale for recommending JSON-LD. Penalties for violations and anti-patterns of over-markup are also included.
Implementation + validation + operations (the finished JSON-LD for a fictional SaaS)
A finished example of implementing JSON-LD on the service page of the fictional B2B SaaS "Acme Workflow". The validation steps with the Google Rich Results Test and the Schema Markup Validator, typical errors during implementation and how to fix them, and the conventions for ongoing operations, including Search Console monitoring and keeping up with schema.org updates.
Introduction
A systematic guide to implementing JSON-LD structured data on a corporate site. Based on the official specs of Google Search Central and schema.org, it lays out the type-selection process for WebPage / Service / Organization / Audience / Country as a reproducible decision flow.
The fundamentals of structured data (JSON-LD / schema.org)
The fundamentals of structured data, JSON-LD, and the schema.org Data Model. Its role as a "contract" between search engines and content, the meaning of @context / @type / @id, the type hierarchy and property ranges, and how to embed it in HTML.
The type-selection process (WebPage / Service / Organization / Audience / Country)
The type-selection process for implementing JSON-LD on the service page of a corporate site. The rationale for choosing WebPage as the root type, Service for mainEntity, Organization for provider, Audience for audience, and Country for areaServed, plus the rejected alternatives. Also includes the @id strategy and a decision tree for applying this to your own site.