JSON+LD-metagegevens json-ld

In deze handleiding wordt uitgelegd hoe u de functie JSON+LD in AEM CIF kunt inschakelen en controleren.

NOTE
Dit is een experimentele functie.

JSON+LD inschakelen in CIF-configuratie enabling

Door gebrek, laat JSON+LD checkbox toe is niet zichtbaar in de configuratie van CIF. Om deze eigenschap toe te laten, moet het project de noodzakelijke configuratie OSGi omvatten, die checkbox om toestaat worden getoond. Met deze configuratie kunnen gebruikers JSON+LD-scriptondersteuning op productpagina's in- en uitschakelen.

Om toe te laten JSON+LD checkbox beschikbaar in de configuratie van CIF te maken, voeg de volgende configuratie OSGi aan uw project toe:

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

Voor verdere details bij het toevoegen van deze configuratie, verwijs naar ​ toevoegt configuratie voor json-Ld ​ in de openbare aem-cif-guides-venia bewaarplaats.

Zodra deze configuratie wordt toegevoegd en opgesteld, wordt checkbox zichtbaar in de de configuratiemontages van CIF en hier zijn de stappen om JSON+LD toe te laten:

  1. Navigeer naar de CIF-configuratie in AEM.
  2. Overerving annuleren.
  3. Controleer toelaten JSON+LD checkbox.
  4. Sla de configuratie op.

JSON+LD controleren op een pagina met productdetails (PDP) verify

Om de stappen te illustreren om JSON+LD te verifiëren, wordt het project van Venia gebruikt als voorbeeld, waar de vereiste configuratie JSON+LD reeds wordt toegevoegd om de eigenschap toe te laten. Hier volgen de volgende stappen:

  1. Ga naar uw lokale AEM-exemplaar en open de pagina met productdetails (PDP): http://localhost:4502/editor.html/content/venia/us/en/products/product-page.html
  2. Maak een product op de pagina met productdetails (PDP).
  3. Schakelaar aan Mening als Publish wijze.
  4. Open de Pagina van de Mening Source in uw browser.
  5. Zoeken naar JSON+LD in de paginabron.

Indien correct gevormd, vindt u het manuscript JSON+LD verbonden aan het product dat in de pagina wordt ingespoten.

Voorbeeld van JSON+LD-structuur voor een product sample

Hieronder is een voorbeeld JSON+LD structuur voor Agatha Skirt, die op de PDP pagina in het project van Venia wordt geschreven:

<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>

JSON+LD-kenmerken toewijzen aan GraphQL mapping

JSON+LD-kenmerken kunnen worden toegewezen aan GraphQL-query's in AEM CIF, zodat gestructureerde gegevens dynamisch de productinformatie weerspiegelen die via GraphQL is opgehaald.

Voorbeeld van producttoewijzing example

JSON+LD-kenmerk
Magento GraphQL-kenmerk
Vereist (J/N)
sku
sku
N
offers.url
Aangepaste logica
N
offers.SpecialPricedate
special_to_date
N
offers.sku
sku
N
offers.priceSpecification.priceCurrency
valuta
Y
offers.priceSpecification.price
normal_price
N
offers.priceCurrency
valuta
Y
offers.price
special_price
Y
offers.image
media_galerie.url
N
offers.availability
stock_status
N
name
name
Y
image
media_galerie.url
Y
beschrijving
beschrijving
N
aggregateRating.reviewCount
review_count
N
aggregateRating.ratingValue
rating_summary
N
@id
id
N

Deze toewijzing zorgt ervoor dat het JSON+LD-script dynamisch wordt gevuld op basis van productgegevens die via GraphQL-query's zijn opgehaald.

Om uw JSON+LD structuur te testen, kunt u de ​ Rijke Test van Resultaten gebruiken - de Console van het Onderzoek van Google. Dit gereedschap biedt gedetailleerde feedback, waaronder of de vereiste kenmerken aanwezig zijn of ontbreken, en zorgt ervoor dat uw gestructureerde gegevens correct zijn geïmplementeerd.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab