Metadados JSON+LD json-ld

Este guia explica como ativar e verificar o recurso JSON+LD no AEM CIF.

Ativar JSON+LD na configuração do CIF enabling

Por padrão, a caixa de seleção Habilitar JSON+LD não está visível na configuração do CIF. Para ativar esse recurso, o projeto deve incluir a configuração OSGi necessária, que permite que a caixa de seleção seja exibida. Essa configuração permite que os usuários alternem o suporte a scripts JSON+LD nas páginas de produtos.

Para disponibilizar a caixa de seleção Habilitar JSON+LD na configuração do CIF, adicione a seguinte configuração OSGi ao seu projeto:

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

Para obter mais detalhes sobre como adicionar essa configuração, consulte Adiciona configuração para Json-Ld no repositório público aem-CIF-guides-venia.

Depois que essa configuração for adicionada e implantada, a caixa de seleção ficará visível nas definições de configuração do CIF e aqui estão as etapas para habilitar o JSON+LD:

Verificar JSON+LD em uma Página de detalhes do produto (PDP) verify

Para ilustrar as etapas para verificar JSON+LD, o projeto Venia é usado como exemplo, em que a configuração JSON+LD necessária já foi adicionada para habilitar o recurso. Estas são as etapas a serem seguidas:

Se configurado corretamente, você encontrará o script JSON+LD associado ao produto inserido na página.

Exemplo de estrutura JSON+LD para um produto sample

Abaixo está um exemplo da estrutura JSON+LD para a saia de Agatha, criada na página PDP do projeto 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>

Mapeamento de atributos JSON+LD para o GraphQL mapping

Os atributos JSON+LD podem ser mapeados para consultas do GraphQL no AEM CIF, garantindo que os dados estruturados reflitam dinamicamente as informações do produto recuperadas pelo GraphQL.

Exemplo de mapeamento de produto example

Esse mapeamento garante que o script JSON+LD seja preenchido dinamicamente com base nos dados do produto recuperados por consultas do GraphQL.

Para testar sua estrutura JSON+LD, você pode usar o Teste de Resultados Avançados - Console de Pesquisa do Google. Essa ferramenta fornece comentários detalhados, incluindo se os atributos necessários estão presentes ou ausentes, e ajuda a garantir que seus dados estruturados sejam implementados corretamente.