technique

JSON-LD : créer ton premier schéma en 10 minutes

Tuto pas à pas pour ajouter ton premier JSON-LD, de la réflexion initiale au test Google Rich Results.

Mehdi Benali
 
a blurry photo of a living room with lights
a blurry photo of a living room with lights

Tu entends parler de JSON-LD partout dans les articles GEO mais tu n’as jamais implémenté un schéma toi-même. Ce guide est fait pour toi. En dix minutes, tu auras ton premier schéma déployé sur ta home page, testé et validé.

JSON-LD en une phrase

JSON-LD (JavaScript Object Notation for Linked Data) est un format qui te permet d’encoder des métadonnées structurées dans ton HTML, sous forme d’un bloc JSON placé dans une balise <script>. Google, les LLM et les autres moteurs le lisent pour comprendre explicitement ce qu’est ton site.

Étape 1 : décider quel schéma utiliser

Pour ta première implémentation, on va utiliser Organization. C’est le schéma fondamental qui déclare qui tu es.

Autres choix selon tes besoins :

  • Tu as un blog ? BlogPosting sur chaque article
  • Tu as un e-commerce ? Product sur chaque fiche
  • Tu as une FAQ ? FAQPage
  • Tu es une entreprise locale ? LocalBusiness

Aujourd’hui, on fait Organization. C’est le socle, il va sur toutes les pages.

Étape 2 : préparer le JSON

Copie ce template et remplace les valeurs par les tiennes :

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nom de ton entreprise",
  "url": "https://tondomaine.fr",
  "logo": "https://tondomaine.fr/logo.svg",
  "description": "Une phrase qui décrit clairement ton activité",
  "foundingDate": "2024",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "1 rue Exemple",
    "addressLocality": "Ville",
    "postalCode": "75001",
    "addressCountry": "FR"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "email": "contact@tondomaine.fr",
    "contactType": "customer service",
    "availableLanguage": "French"
  },
  "sameAs": [
    "https://twitter.com/tonhandle",
    "https://www.linkedin.com/company/ton-entreprise",
    "https://www.facebook.com/tapage"
  ]
}

Champ critique : sameAs. Liste tous tes profils sociaux officiels. Les IA suivent ces liens pour vérifier ton existence et ta cohérence. Plus la liste est complète, plus tu es crédible.

Étape 3 : intégrer dans ton HTML

Dans le <head> de ta home page, ajoute :

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "..."
}
</script>

Attention : le contenu du script doit être du JSON valide. Une virgule manquante, un guillemet non échappé, et tout le schéma est ignoré.

Étape 4 : tester avec l’outil Google

Va sur Rich Results Test. Colle l’URL de ta home ou directement ton code HTML. Google te dit :

  • Valid items : combien de schémas il a reconnus
  • Warnings : champs optionnels manquants qui pourraient aider
  • Errors : erreurs de syntaxe ou champs obligatoires manquants

Corrige les erreurs jusqu’à zéro. Les warnings sont optionnels mais il est recommandé de les traiter.

Étape 5 : tester avec Schema.org Validator

validator.schema.org propose une validation plus stricte. Utile pour détecter les erreurs que Google accepte mais qui pourraient poser problème avec d’autres lecteurs.

Étape 6 : vérifier que les LLM le lisent

Test final : pose la question à ChatGPT et Perplexity “parle-moi de [ton site]”. Si leurs réponses contiennent les informations que tu as déclarées dans ton schéma (description, activité, fondation), c’est que le schéma est bien lu et pris en compte.

Les erreurs courantes de première implémentation

1. JSON invalide

{
  "name": "Pulsari",
}  // virgule finale = JSON invalide

2. URL non absolue

{
  "url": "/about"  // doit être https://tondomaine.fr/about
}

3. Types incorrects

{
  "foundingDate": "2024"  // OK
  "foundingDate": 2024    // KO, doit être une string
}

4. Champs inventés

{
  "@type": "Organization",
  "mySpecialField": "..."  // ignoré, pas dans la spéc schema.org
}

Respecte la documentation officielle schema.org.

Prochaines étapes après ton premier schéma

Une fois Organization déployé sur ta home, tu peux ajouter :

  1. BlogPosting sur chaque article de blog (1-2h de travail pour tout un blog)
  2. FAQPage sur tes pages avec FAQ (très rentable pour le GEO)
  3. BreadcrumbList sur les pages intérieures
  4. Product ou LocalBusiness selon ton business

Notre article sur Schema.org pour le GEO détaille les 7 types principaux.

Automatiser l’implémentation

Plutôt que coder chaque schéma à la main, utilise :

  • WordPress : plugins Yoast SEO ou Rank Math génèrent automatiquement les schémas de base
  • Astro : package @astrojs/json-ld ou composants Astro dédiés
  • Next.js : bibliothèque next-seo ou composant custom
  • Shopify : les thèmes récents intègrent les schémas Product et Organization automatiquement

L’essentiel est que les schémas soient présents, validés et à jour quand ton site se charge.

Questions fréquentes

Pourquoi est-il crucial d’implémenter des schémas JSON-LD sur mon site web ?

L’implémentation de schémas JSON-LD est cruciale car elle permet aux moteurs de recherche et aux grands modèles de langage de comprendre explicitement le contenu et le contexte de votre site. Cela améliore la visibilité de votre site dans les résultats de recherche, notamment via les rich snippets, et aide les IA à mieux interpréter vos informations pour des requêtes complexes. C’est un signal fort pour l’autorité et la pertinence de votre site.

Quel type de schéma JSON-LD est recommandé pour une première implémentation sur ma page d’accueil ?

Pour une première implémentation, le schéma “Organization” est fortement recommandé sur votre page d’accueil. Il sert à déclarer l’identité de votre entreprise ou entité, fournissant des informations fondamentales aux moteurs de recherche. C’est un socle essentiel qui peut ensuite être complété par d’autres schémas plus spécifiques à vos contenus comme “Product” ou “BlogPosting”.

Combien de temps faut-il prévoir pour créer et déployer un premier schéma JSON-LD comme “Organization” ?

La création et le déploiement d’un premier schéma JSON-LD de type “Organization” peuvent être réalisés en environ dix minutes. Le processus implique de copier un modèle de code JSON, de remplacer les valeurs génériques par les informations spécifiques de votre entreprise, puis de l’intégrer dans la balise

Où doit-on placer le bloc de code JSON-LD dans le HTML d’une page web ?

Le bloc de code JSON-LD doit être placé à l’intérieur d’une balise

En résumé

Ton premier schéma prend 10 à 20 minutes à déployer et à tester. C’est l’un des meilleurs investissements temps/ROI du GEO. Ne reporte pas : fais-le cette semaine.

Pour aller plus loin : FAQPage schema impact, Schema.org pour GEO, audit Pulsari.


Articles similaires

#json-ld#tutoriel json-ld#données structurées

Prends le pouls de ta visibilité IA

Teste si ta marque est citée par Claude et Gemini en 30 secondes. Gratuit, sans inscription.