Métadonnées JSON+ID json-ld

Ce guide explique comment activer et vérifier la fonctionnalité JSON+LD dans AEM CIF.

Activation de JSON+LD dans la configuration CIF enabling

Par défaut, la case à cocher Activer JSON+LD n’est pas visible dans la configuration de CIF. Pour activer cette fonctionnalité, le projet doit inclure la configuration OSGi nécessaire, qui permet d’afficher la case à cocher. Cette configuration permet aux utilisateurs d’activer/désactiver la prise en charge des scripts JSON+LD sur les pages de produits.

Pour que la case à cocher Activer JSON+LD soit disponible dans la configuration CIF, ajoutez la configuration OSGi suivante à votre projet :

com.adobe.cq.cif.components.models.JsonLdFeatureEnable.

Pour plus d’informations sur l’ajout de cette configuration, reportez-vous à la section Ajoute une configuration pour Json-Ld dans le référentiel public aem-cif-guides-venia.

Une fois cette configuration ajoutée et déployée, la case à cocher devient visible dans les paramètres de configuration de CIF et voici les étapes pour activer JSON+LD :

Vérification de JSON+LD sur une page de détails du produit (PDP) verify

Pour illustrer les étapes de vérification de JSON+LD, le projet Venia est utilisé comme exemple, où la configuration JSON+LD requise est déjà ajoutée pour activer la fonctionnalité. Procédez comme suit :

Si elle est configurée correctement, le script JSON+LD associé au produit injecté dans la page s’affiche.

Exemple de structure JSON+LD pour un produit sample

Vous trouverez ci-dessous un exemple de structure JSON+LD pour la jupe Agatha, créée sur la page PDP du projet Venia :

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Product",
  "sku": "VSK05",
  "name": "Agatha Skirt",
  "image": "https://mcstaging.catalogservice4commerce.fun/media/catalog/product/cache/926ea6fc2ad48a7202ff4587b6c2768e/v/s/vsk05-pe_main_2.jpg",
  "description": "The Agatha Skirt has a large circumference that lends itself to all sorts of drama...",
  "@id": "product-ef4fa1dc72",
  "offers": [
    {
      "@type": "Offer",
      "sku": "VSK05-KH-S",
      "url": "/content/venia/us/en/products/product-page.html/agatha-skirt.html",
      "priceCurrency": "USD",
      "price": 78.0
    },
    {
      "@type": "Offer",
      "sku": "VSK05-RN-XS",
      "availability": "InStock",
      "priceSpecification": {
        "@type": "UnitPriceSpecification",
        "priceType": "https://schema.org/ListPrice",
        "price": 18.0,
        "priceCurrency": "USD"
      },
      "price": 46.0
    }
  ]
}
</script>

Mappage des attributs JSON+LD vers GraphQL mapping

Les attributs JSON+LD peuvent être mappés aux requêtes GraphQL dans AEM CIF, ce qui garantit que les données structurées reflètent dynamiquement les informations sur les produits récupérées via GraphQL.

Exemple de mappage de produit example

Ce mappage garantit que le script JSON+LD est renseigné dynamiquement en fonction des données de produit récupérées par le biais de requêtes GraphQL.

Pour tester votre structure JSON+LD, vous pouvez utiliser la console de recherche Test avec résultats enrichis - Google. Cet outil fournit des commentaires détaillés, notamment sur la présence ou l’absence des attributs requis, et permet de s’assurer que vos données structurées sont correctement implémentées.