Esquema JSON-LD explicado: Como estruturar o conhecimento da sua marca para a IA

Sistemas de IA como o ChatGPT e o Claude analisam milhares de milhões de páginas web e tentam compreender o que cada marca faz, a quem servem e quando são relevantes. Mas o HTML por si só é ambíguo – "Apple" é a fruta ou a empresa tecnológica? "499 $" é um preço, uma estatística ou apenas texto? A marcação de esquema JSON-LD é a solução: dados estruturados que dizem explicitamente aos sistemas de IA o que é a sua marca, o que oferece e como se relaciona com o mundo.

Esquema JSON-LD explicado: Como estruturar o conhecimento da sua marca para a IA

Publicado em

Autor

Jakon Langemark

Siga-nos

LinkedIn

Esquema JSON-LD explicado: Como estruturar o conhecimento da sua marca para a IA

Os sistemas de IA como o ChatGPT e o Claude analisam milhares de milhões de páginas web e tentam compreender o que cada marca faz, a quem servem e quando são relevantes. Mas o HTML por si só é ambíguo – "Apple" é o fruto ou a empresa de tecnologia? "$499" é um preço, uma estatística ou apenas texto? O markup de esquema JSON-LD é a solução: dados estruturados que dizem explicitamente aos sistemas de IA o que é a sua marca, o que oferece e como se relaciona com o mundo.

Este guia oferece uma implementação concreta de JSON-LD para visibilidade em IA.

O que é o JSON-LD e por que é importante?

JSON-LD significa "JavaScript Object Notation for Linked Data" (Notação de Objetos JavaScript para Dados Interligados). É um formato para incorporar dados estruturados e legíveis por máquinas nas suas páginas web.

Para a IA, isto significa:

  • Ausência de ambiguidade: A IA sabe exatamente o que os dados significam

  • Contexto: A IA compreende as relações entre entidades

  • Citações: A IA pode citá-lo corretamente com precisão factual

Exemplo da diferença:

HTML (ambíguo):

<p>Fornecemos software a hospitais na Dinamarca desde 2015.</p>
<p>Fornecemos software a hospitais na Dinamarca desde 2015.</p>
<p>Fornecemos software a hospitais na Dinamarca desde 2015.</p>

A IA tem de adivinhar: 2015 é o ano de fundação? Os "hospitais" são os seus clientes ou a sua área de foco?

JSON-LD (explícito):

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "HealthTech AS",
  "foundingDate": "2015",
  "areaServed": "DK",
  "customerType": "Hospital"
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "HealthTech AS",
  "foundingDate": "2015",
  "areaServed": "DK",
  "customerType": "Hospital"
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "HealthTech AS",
  "foundingDate": "2015",
  "areaServed": "DK",
  "customerType": "Hospital"
}

Agora a IA sabe exatamente o que significa cada elemento de dados.

Estrutura básica do JSON-LD

Todos os blocos JSON-LD são colocados em <head> ou no final de <body>:

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

Componentes:

  • @context – Define o vocabulário (sempre "https://schema.org")

  • @type – O que é esta entidade? (Organization, Product, Person, etc.)

  • property: value – Atributos específicos

Esquema de Organização: A identidade central da sua marca

Este é o esquema mais importante para a visibilidade da marca.

Esquema de Organização Mínimo

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nome da Sua Empresa",
  "url": "https://oseuwebsite.com",
  "logo": "https://oseuwebsite.com/logo.png",
  "description": "Fazemos X para Y"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nome da Sua Empresa",
  "url": "https://oseuwebsite.com",
  "logo": "https://oseuwebsite.com/logo.png",
  "description": "Fazemos X para Y"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nome da Sua Empresa",
  "url": "https://oseuwebsite.com",
  "logo": "https://oseuwebsite.com/logo.png",
  "description": "Fazemos X para Y"
}
</script>

Esquema de Organização Completo

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nordic SaaS Solutions",
  "alternateName": "NordicSaaS",
  "url": "https://nordicsaas.dk",
  "logo": {
    "@type": "ImageObject",
    "url": "https://nordicsaas.dk/logo.png",
    "width": 600,
    "height": 60
  },
  "description": "Fornecemos software de CRM empresarial para empresas B2B escandinavas com 50-500 colaboradores.",
  "foundingDate": "2018",
  "founders": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO"
    }
  ],
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Nørregade 10",
    "addressLocality": "Copenhaga",
    "postalCode": "1165",
    "addressCountry": "DK"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+45-12-34-56-78",
    "contactType": "Apoio ao Cliente",
    "areaServed": "DK",
    "availableLanguage": ["Danish", "English"]
  },
  "sameAs": [
    "https://www.linkedin.com/company/nordicsaas",
    "https://twitter.com/nordicsaas",
    "https://www.crunchbase.com/organization/nordicsaas"
  ],
  "numberOfEmployees": {
    "@type": "QuantitativeValue",
    "value": 25
  },
  "slogan": "CRM desenvolvido para empresas nórdicas"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nordic SaaS Solutions",
  "alternateName": "NordicSaaS",
  "url": "https://nordicsaas.dk",
  "logo": {
    "@type": "ImageObject",
    "url": "https://nordicsaas.dk/logo.png",
    "width": 600,
    "height": 60
  },
  "description": "Fornecemos software de CRM empresarial para empresas B2B escandinavas com 50-500 colaboradores.",
  "foundingDate": "2018",
  "founders": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO"
    }
  ],
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Nørregade 10",
    "addressLocality": "Copenhaga",
    "postalCode": "1165",
    "addressCountry": "DK"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+45-12-34-56-78",
    "contactType": "Apoio ao Cliente",
    "areaServed": "DK",
    "availableLanguage": ["Danish", "English"]
  },
  "sameAs": [
    "https://www.linkedin.com/company/nordicsaas",
    "https://twitter.com/nordicsaas",
    "https://www.crunchbase.com/organization/nordicsaas"
  ],
  "numberOfEmployees": {
    "@type": "QuantitativeValue",
    "value": 25
  },
  "slogan": "CRM desenvolvido para empresas nórdicas"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nordic SaaS Solutions",
  "alternateName": "NordicSaaS",
  "url": "https://nordicsaas.dk",
  "logo": {
    "@type": "ImageObject",
    "url": "https://nordicsaas.dk/logo.png",
    "width": 600,
    "height": 60
  },
  "description": "Fornecemos software de CRM empresarial para empresas B2B escandinavas com 50-500 colaboradores.",
  "foundingDate": "2018",
  "founders": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO"
    }
  ],
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Nørregade 10",
    "addressLocality": "Copenhaga",
    "postalCode": "1165",
    "addressCountry": "DK"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+45-12-34-56-78",
    "contactType": "Apoio ao Cliente",
    "areaServed": "DK",
    "availableLanguage": ["Danish", "English"]
  },
  "sameAs": [
    "https://www.linkedin.com/company/nordicsaas",
    "https://twitter.com/nordicsaas",
    "https://www.crunchbase.com/organization/nordicsaas"
  ],
  "numberOfEmployees": {
    "@type": "QuantitativeValue",
    "value": 25
  },
  "slogan": "CRM desenvolvido para empresas nórdicas"
}
</script>

Quais os campos mais importantes para a IA?

  1. description – O que faz? Para quem?

  2. sameAs – Links para o LinkedIn, Crunchbase e Twitter reforçam a autoridade

  3. contactPoint – Torna-o contactável

  4. address – Contexto geográfico

Esquema de Produto: Torne os seus produtos citáveis

Se a IA tiver de recomendar o seu produto, necessita de saber o que é, quanto custa e a quem se destina.

Produto de e-commerce

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoDesk Pro",
  "description": "Secretária regulável em altura com carregador sem fios integrado e função de memória. Ideal para escritórios em casa e pequenas empresas.",
  "brand": {
    "@type": "Brand",
    "name": "ErgoFurniture"
  },
  "image": "https://ergofurniture.dk/images/ergodesk-pro.jpg",
  "sku": "ERG-DESK-PRO-01",
  "offers": {
    "@type": "Offer",
    "url": "https://ergofurniture.dk/products/ergodesk-pro",
    "priceCurrency": "DKK",
    "price": "4999.00",
    "priceValidUntil": "2024-12-31",
    "availability": "https://schema.org/InStock",
    "seller": {
      "@type": "Organization",
      "name": "ErgoFurniture"
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "143"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoDesk Pro",
  "description": "Secretária regulável em altura com carregador sem fios integrado e função de memória. Ideal para escritórios em casa e pequenas empresas.",
  "brand": {
    "@type": "Brand",
    "name": "ErgoFurniture"
  },
  "image": "https://ergofurniture.dk/images/ergodesk-pro.jpg",
  "sku": "ERG-DESK-PRO-01",
  "offers": {
    "@type": "Offer",
    "url": "https://ergofurniture.dk/products/ergodesk-pro",
    "priceCurrency": "DKK",
    "price": "4999.00",
    "priceValidUntil": "2024-12-31",
    "availability": "https://schema.org/InStock",
    "seller": {
      "@type": "Organization",
      "name": "ErgoFurniture"
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "143"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoDesk Pro",
  "description": "Secretária regulável em altura com carregador sem fios integrado e função de memória. Ideal para escritórios em casa e pequenas empresas.",
  "brand": {
    "@type": "Brand",
    "name": "ErgoFurniture"
  },
  "image": "https://ergofurniture.dk/images/ergodesk-pro.jpg",
  "sku": "ERG-DESK-PRO-01",
  "offers": {
    "@type": "Offer",
    "url": "https://ergofurniture.dk/products/ergodesk-pro",
    "priceCurrency": "DKK",
    "price": "4999.00",
    "priceValidUntil": "2024-12-31",
    "availability": "https://schema.org/InStock",
    "seller": {
      "@type": "Organization",
      "name": "ErgoFurniture"
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "143"
  }
}
</script>

Produto SaaS

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "TaskFlow",
  "applicationCategory": "BusinessApplication",
  "description": "Software de gestão de projetos para agências de marketing. Trata de projetos de clientes, registos de horas e faturação.",
  "operatingSystem": "Baseado na Web",
  "offers": {
    "@type": "Offer",
    "price": "299.00",
    "priceCurrency": "DKK",
    "priceSpecification": {
      "@type": "UnitPriceSpecification",
      "price": "299.00",
      "priceCurrency": "DKK",
      "billingDuration": "P1M",
      "billingIncrement": 1
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "ratingCount": "89"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "TaskFlow",
  "applicationCategory": "BusinessApplication",
  "description": "Software de gestão de projetos para agências de marketing. Trata de projetos de clientes, registos de horas e faturação.",
  "operatingSystem": "Baseado na Web",
  "offers": {
    "@type": "Offer",
    "price": "299.00",
    "priceCurrency": "DKK",
    "priceSpecification": {
      "@type": "UnitPriceSpecification",
      "price": "299.00",
      "priceCurrency": "DKK",
      "billingDuration": "P1M",
      "billingIncrement": 1
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "ratingCount": "89"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "TaskFlow",
  "applicationCategory": "BusinessApplication",
  "description": "Software de gestão de projetos para agências de marketing. Trata de projetos de clientes, registos de horas e faturação.",
  "operatingSystem": "Baseado na Web",
  "offers": {
    "@type": "Offer",
    "price": "299.00",
    "priceCurrency": "DKK",
    "priceSpecification": {
      "@type": "UnitPriceSpecification",
      "price": "299.00",
      "priceCurrency": "DKK",
      "billingDuration": "P1M",
      "billingIncrement": 1
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "ratingCount": "89"
  }
}
</script>

A IA pode agora responder:

"Para gestão de projetos em agências de marketing, recomendo o TaskFlow. Custa 299 DKK/mês e tem uma classificação de 4.5/5 com base em 89 avaliações."

Esquema de Serviço: Para empresas baseadas em serviços

Se vende serviços (consultoria, agência, SaaS), utilize o esquema de Serviço (Service).

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Service",
  "serviceType": "Consultoria de SEO",
  "provider": {
    "@type": "Organization",
    "name": "Nordic SEO Agency"
  },
  "areaServed": {
    "@type": "Country",
    "name": "Dinamarca"
  },
  "hasOfferCatalog": {
    "@type": "OfferCatalog",
    "name": "Serviços de SEO",
    "itemListElement": [
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Auditoria Técnica de SEO",
          "description": "Análise detalhada de indexação e capacidade de rastreio"
        }
      },
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Estratégia de Conteúdo",
          "description": "Pesquisa de palavras-chave e planeamento de conteúdos"
        }
      }
    ]
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Service",
  "serviceType": "Consultoria de SEO",
  "provider": {
    "@type": "Organization",
    "name": "Nordic SEO Agency"
  },
  "areaServed": {
    "@type": "Country",
    "name": "Dinamarca"
  },
  "hasOfferCatalog": {
    "@type": "OfferCatalog",
    "name": "Serviços de SEO",
    "itemListElement": [
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Auditoria Técnica de SEO",
          "description": "Análise detalhada de indexação e capacidade de rastreio"
        }
      },
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Estratégia de Conteúdo",
          "description": "Pesquisa de palavras-chave e planeamento de conteúdos"
        }
      }
    ]
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Service",
  "serviceType": "Consultoria de SEO",
  "provider": {
    "@type": "Organization",
    "name": "Nordic SEO Agency"
  },
  "areaServed": {
    "@type": "Country",
    "name": "Dinamarca"
  },
  "hasOfferCatalog": {
    "@type": "OfferCatalog",
    "name": "Serviços de SEO",
    "itemListElement": [
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Auditoria Técnica de SEO",
          "description": "Análise detalhada de indexação e capacidade de rastreio"
        }
      },
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Estratégia de Conteúdo",
          "description": "Pesquisa de palavras-chave e planeamento de conteúdos"
        }
      }
    ]
  }
}
</script>

Esquema de Artigo: Para publicações de blogue e conteúdos

Os sistemas de IA citam frequentemente publicações de blogues. Torne-os citáveis com o esquema de Artigo (Article).

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Como otimizar o seu website para visibilidade em IA",
  "description": "Um guia completo para tornar a sua marca visível no ChatGPT, Claude e Perplexity.",
  "image": "https://oseuwebsite.com/images/ai-visibility-guide.jpg",
  "author": {
    "@type": "Person",
    "name": "Jane Doe",
    "url": "https://oseuwebsite.com/authors/jane-doe",
    "jobTitle": "Especialista em SEO",
    "sameAs": [
      "https://linkedin.com/in/janedoe",
      "https://twitter.com/janedoe"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "Nordic SaaS Solutions",
    "logo": {
      "@type": "ImageObject",
      "url": "https://nordicsaas.dk/logo.png"
    }
  },
  "datePublished": "2024-01-15",
  "dateModified": "2024-01-20",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://oseuwebsite.com/blog/ai-visibility-guide"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Como otimizar o seu website para visibilidade em IA",
  "description": "Um guia completo para tornar a sua marca visível no ChatGPT, Claude e Perplexity.",
  "image": "https://oseuwebsite.com/images/ai-visibility-guide.jpg",
  "author": {
    "@type": "Person",
    "name": "Jane Doe",
    "url": "https://oseuwebsite.com/authors/jane-doe",
    "jobTitle": "Especialista em SEO",
    "sameAs": [
      "https://linkedin.com/in/janedoe",
      "https://twitter.com/janedoe"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "Nordic SaaS Solutions",
    "logo": {
      "@type": "ImageObject",
      "url": "https://nordicsaas.dk/logo.png"
    }
  },
  "datePublished": "2024-01-15",
  "dateModified": "2024-01-20",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://oseuwebsite.com/blog/ai-visibility-guide"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Como otimizar o seu website para visibilidade em IA",
  "description": "Um guia completo para tornar a sua marca visível no ChatGPT, Claude e Perplexity.",
  "image": "https://oseuwebsite.com/images/ai-visibility-guide.jpg",
  "author": {
    "@type": "Person",
    "name": "Jane Doe",
    "url": "https://oseuwebsite.com/authors/jane-doe",
    "jobTitle": "Especialista em SEO",
    "sameAs": [
      "https://linkedin.com/in/janedoe",
      "https://twitter.com/janedoe"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "Nordic SaaS Solutions",
    "logo": {
      "@type": "ImageObject",
      "url": "https://nordicsaas.dk/logo.png"
    }
  },
  "datePublished": "2024-01-15",
  "dateModified": "2024-01-20",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://oseuwebsite.com/blog/ai-visibility-guide"
  }
}
</script>

Por que é importante:

  • A IA pode citar o autor corretamente

  • A data de publicação mostra a frescura do conteúdo

  • O editor estabelece a autoridade

Esquema de FAQPage: Torne as suas FAQs diretamente citáveis

Isto é uma mina de ouro para a visibilidade em IA.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Quanto custa o TaskFlow?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "O TaskFlow custa 299 DKK/mês por utilizador, com um mínimo de 3 utilizadores. Também oferecemos um plano Enterprise a 199 DKK/utilizador para equipas com mais de 20 pessoas."
      }
    },
    {
      "@type": "Question",
      "name": "Que integrações o TaskFlow suporta?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "O TaskFlow integra-se com o Slack, Google Calendar, Trello, Asana e todos os principais sistemas de contabilidade, incluindo o Dinero e o Billy."
      }
    },
    {
      "@type": "Question",
      "name": "O TaskFlow é adequado para equipas remotas?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sim, o TaskFlow foi desenvolvido para equipas focadas no trabalho remoto. Inclui registo de horas, comunicação assíncrona e videoconferência integrada."
      }
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Quanto custa o TaskFlow?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "O TaskFlow custa 299 DKK/mês por utilizador, com um mínimo de 3 utilizadores. Também oferecemos um plano Enterprise a 199 DKK/utilizador para equipas com mais de 20 pessoas."
      }
    },
    {
      "@type": "Question",
      "name": "Que integrações o TaskFlow suporta?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "O TaskFlow integra-se com o Slack, Google Calendar, Trello, Asana e todos os principais sistemas de contabilidade, incluindo o Dinero e o Billy."
      }
    },
    {
      "@type": "Question",
      "name": "O TaskFlow é adequado para equipas remotas?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sim, o TaskFlow foi desenvolvido para equipas focadas no trabalho remoto. Inclui registo de horas, comunicação assíncrona e videoconferência integrada."
      }
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Quanto custa o TaskFlow?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "O TaskFlow custa 299 DKK/mês por utilizador, com um mínimo de 3 utilizadores. Também oferecemos um plano Enterprise a 199 DKK/utilizador para equipas com mais de 20 pessoas."
      }
    },
    {
      "@type": "Question",
      "name": "Que integrações o TaskFlow suporta?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "O TaskFlow integra-se com o Slack, Google Calendar, Trello, Asana e todos os principais sistemas de contabilidade, incluindo o Dinero e o Billy."
      }
    },
    {
      "@type": "Question",
      "name": "O TaskFlow é adequado para equipas remotas?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sim, o TaskFlow foi desenvolvido para equipas focadas no trabalho remoto. Inclui registo de horas, comunicação assíncrona e videoconferência integrada."
      }
    }
  ]
}
</script>

Resultado: Quando alguém pergunta "Quanto custa o TaskFlow?", a IA pode citá-lo diretamente com preços precisos.

Esquema HowTo: Para guias e tutoriais

Se cria tutoriais ou conteúdos explicativos, utilize o esquema HowTo.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Como implementar JSON-LD no seu website",
  "description": "Um guia passo a passo para adicionar dados estruturados ao seu website.",
  "totalTime": "PT30M",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Identifique os esquemas de que necessita",
      "text": "Determine se o seu site é principalmente focado em Organização, Produto, Artigo ou Serviço.",
      "position": 1
    },
    {
      "@type": "HowToStep",
      "name": "Crie o bloco JSON-LD",
      "text": "Adicione uma tag <script type='application/ld+json'> na secção <head>.",
      "position": 2
    },
    {
      "@type": "HowToStep",
      "name": "Valide com o Teste de Resultados Avançados da Google",
      "text": "Teste a sua implementação em https://search.google.com/test/rich-results",
      "position": 3
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Como implementar JSON-LD no seu website",
  "description": "Um guia passo a passo para adicionar dados estruturados ao seu website.",
  "totalTime": "PT30M",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Identifique os esquemas de que necessita",
      "text": "Determine se o seu site é principalmente focado em Organização, Produto, Artigo ou Serviço.",
      "position": 1
    },
    {
      "@type": "HowToStep",
      "name": "Crie o bloco JSON-LD",
      "text": "Adicione uma tag <script type='application/ld+json'> na secção <head>.",
      "position": 2
    },
    {
      "@type": "HowToStep",
      "name": "Valide com o Teste de Resultados Avançados da Google",
      "text": "Teste a sua implementação em https://search.google.com/test/rich-results",
      "position": 3
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Como implementar JSON-LD no seu website",
  "description": "Um guia passo a passo para adicionar dados estruturados ao seu website.",
  "totalTime": "PT30M",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Identifique os esquemas de que necessita",
      "text": "Determine se o seu site é principalmente focado em Organização, Produto, Artigo ou Serviço.",
      "position": 1
    },
    {
      "@type": "HowToStep",
      "name": "Crie o bloco JSON-LD",
      "text": "Adicione uma tag <script type='application/ld+json'> na secção <head>.",
      "position": 2
    },
    {
      "@type": "HowToStep",
      "name": "Valide com o Teste de Resultados Avançados da Google",
      "text": "Teste a sua implementação em https://search.google.com/test/rich-results",
      "position": 3
    }
  ]
}
</script>

Esquema de Avaliação e Classificação: Prova social

As avaliações ajudam a IA a avaliar a credibilidade.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoDesk Pro",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "143",
    "bestRating": "5",
    "worstRating": "1"
  },
  "review": [
    {
      "@type": "Review",
      "author": {
        "@type": "Person",
        "name": "Lars Nielsen"
      },
      "datePublished": "2024-01-10",
      "reviewBody": "Secretária fantástica. O motor é silencioso e a função de memória funciona na perfeição. Altamente recomendada para escritórios em casa.",
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "5",
        "bestRating": "5"
      }
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoDesk Pro",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "143",
    "bestRating": "5",
    "worstRating": "1"
  },
  "review": [
    {
      "@type": "Review",
      "author": {
        "@type": "Person",
        "name": "Lars Nielsen"
      },
      "datePublished": "2024-01-10",
      "reviewBody": "Secretária fantástica. O motor é silencioso e a função de memória funciona na perfeição. Altamente recomendada para escritórios em casa.",
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "5",
        "bestRating": "5"
      }
    }
  ]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoDesk Pro",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "143",
    "bestRating": "5",
    "worstRating": "1"
  },
  "review": [
    {
      "@type": "Review",
      "author": {
        "@type": "Person",
        "name": "Lars Nielsen"
      },
      "datePublished": "2024-01-10",
      "reviewBody": "Secretária fantástica. O motor é silencioso e a função de memória funciona na perfeição. Altamente recomendada para escritórios em casa.",
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "5",
        "bestRating": "5"
      }
    }
  ]
}
</script>

Avançado: Entidades aninhadas e relacionadas

Pode ligar múltiplos esquemas para criar um contexto mais rico.

Organização com Pessoas

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nordic SaaS Solutions",
  "employee": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO",
      "sameAs": "https://linkedin.com/in/janedoe"
    },
    {
      "@type": "Person",
      "name": "John Smith",
      "jobTitle": "CTO",
      "sameAs": "https://linkedin.com/in/johnsmith"
    }
  ],
  "founder": {
    "@type": "Person",
    "name": "Jane Doe"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nordic SaaS Solutions",
  "employee": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO",
      "sameAs": "https://linkedin.com/in/janedoe"
    },
    {
      "@type": "Person",
      "name": "John Smith",
      "jobTitle": "CTO",
      "sameAs": "https://linkedin.com/in/johnsmith"
    }
  ],
  "founder": {
    "@type": "Person",
    "name": "Jane Doe"
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Nordic SaaS Solutions",
  "employee": [
    {
      "@type": "Person",
      "name": "Jane Doe",
      "jobTitle": "CEO",
      "sameAs": "https://linkedin.com/in/janedoe"
    },
    {
      "@type": "Person",
      "name": "John Smith",
      "jobTitle": "CTO",
      "sameAs": "https://linkedin.com/in/johnsmith"
    }
  ],
  "founder": {
    "@type": "Person",
    "name": "Jane Doe"
  }
}
</script>

Produto com Marca e Fabricante

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoChair Pro",
  "brand": {
    "@type": "Brand",
    "name": "ErgoFurniture",
    "logo": "https://ergofurniture.dk/logo.png"
  },
  "manufacturer": {
    "@type": "Organization",
    "name": "Nordic Manufacturing AS",
    "address": {
      "@type": "PostalAddress",
      "addressCountry": "NO"
    }
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoChair Pro",
  "brand": {
    "@type": "Brand",
    "name": "ErgoFurniture",
    "logo": "https://ergofurniture.dk/logo.png"
  },
  "manufacturer": {
    "@type": "Organization",
    "name": "Nordic Manufacturing AS",
    "address": {
      "@type": "PostalAddress",
      "addressCountry": "NO"
    }
  }
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ErgoChair Pro",
  "brand": {
    "@type": "Brand",
    "name": "ErgoFurniture",
    "logo": "https://ergofurniture.dk/logo.png"
  },
  "manufacturer": {
    "@type": "Organization",
    "name": "Nordic Manufacturing AS",
    "address": {
      "@type": "PostalAddress",
      "addressCountry": "NO"
    }
  }
}
</script>

Boas Práticas de Implementação

1. Coloque o JSON-LD em <head> ou no final do <body>

Posicionamento recomendado:

<!DOCTYPE html>
<html>
<head>
  <title>A Minha Página</title>
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "A Minha Empresa"
  }
  </script>
</head>
<body>
  <!-- Conteúdo -->
</body>
</html>
<!DOCTYPE html>
<html>
<head>
  <title>A Minha Página</title>
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "A Minha Empresa"
  }
  </script>
</head>
<body>
  <!-- Conteúdo -->
</body>
</html>
<!DOCTYPE html>
<html>
<head>
  <title>A Minha Página</title>
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "A Minha Empresa"
  }
  </script>
</head>
<body>
  <!-- Conteúdo -->
</body>
</html>

2. Utilize apenas um @context por bloco

Incorreto:

{
  "@context": "https://schema.org",
  "@context": "https://example.com",  // Duplicado!
  "@type": "Organization"
}
{
  "@context": "https://schema.org",
  "@context": "https://example.com",  // Duplicado!
  "@type": "Organization"
}
{
  "@context": "https://schema.org",
  "@context": "https://example.com",  // Duplicado!
  "@type": "Organization"
}

Correto:

{
  "@context": "https://schema.org",
  "@type": "Organization"
}
{
  "@context": "https://schema.org",
  "@type": "Organization"
}
{
  "@context": "https://schema.org",
  "@type": "Organization"
}

3. Evite datas fixas (hardcoded)

Utilize datas dinâmicas para dateModified e lastmod:

"dateModified": "<?php echo date('Y-m-d');
"dateModified": "<?php echo date('Y-m-d');
"dateModified": "<?php echo date('Y-m-d');
"dateModified": f"{datetime.now().strftime('%Y-%m-%d')}"
"dateModified": f"{datetime.now().strftime('%Y-%m-%d')}"
"dateModified": f"{datetime.now().strftime('%Y-%m-%d')}"

4. Inclua apenas informação factual

Evite exageros ou linguagem publicitária:

Mau:

"description": "O melhor, mais inovador e revolucionário produto do mundo!"
"description": "O melhor, mais inovador e revolucionário produto do mundo!"
"description": "O melhor, mais inovador e revolucionário produto do mundo!"

Bom:

"description": "Software de gestão de projetos para agências de marketing com registo de horas e faturação integrados."
"description": "Software de gestão de projetos para agências de marketing com registo de horas e faturação integrados."
"description": "Software de gestão de projetos para agências de marketing com registo de horas e faturação integrados."

5. Utilize sameAs para associar perfis externos

"sameAs": [
  "https://www.linkedin.com/company/suaempresa",
  "https://twitter.com/suaempresa",
  "https://www.crunchbase.com/organization/suaempresa",
  "https://pt.wikipedia.org/wiki/SuaEmpresa"
]
"sameAs": [
  "https://www.linkedin.com/company/suaempresa",
  "https://twitter.com/suaempresa",
  "https://www.crunchbase.com/organization/suaempresa",
  "https://pt.wikipedia.org/wiki/SuaEmpresa"
]
"sameAs": [
  "https://www.linkedin.com/company/suaempresa",
  "https://twitter.com/suaempresa",
  "https://www.crunchbase.com/organization/suaempresa",
  "https://pt.wikipedia.org/wiki/SuaEmpresa"
]

A IA utiliza estas hiperligações para cruzar informações e estabelecer autoridade.

Testes e validação

Teste de Resultados Avançados da Google

  1. Aceda a https://search.google.com/test/rich-results

  2. Introduza o seu URL ou cole o JSON-LD diretamente

  3. Verifique se existem erros ou avisos

Validador de Schema.org

  1. Aceda a https://validator.schema.org/

  2. Cole o seu JSON-LD

  3. Verifique se é um esquema válido

JSON Lint (verificação de sintaxe)

  1. Aceda a https://jsonlint.com/

  2. Cole o seu JSON-LD

  3. Verifique se existem erros de sintaxe (falta de vírgulas, parênteses, etc.)

Teste manual com o navegador

# Ver código fonte e procurar por "application/ld+json"
curl https://oseuwebsite.com/ | grep -A 20 "application/ld+json"
# Ver código fonte e procurar por "application/ld+json"
curl https://oseuwebsite.com/ | grep -A 20 "application/ld+json"
# Ver código fonte e procurar por "application/ld+json"
curl https://oseuwebsite.com/ | grep -A 20 "application/ld+json"

Erros comuns e soluções

Erro

Sintoma

Solução

Vírgula em falta

Erro ao processar JSON

Utilize o JSON Lint para localizar o erro

@type incorreto

Avisos nos validadores

Verifique os tipos no schema.org

URLs relativos

Avisos

Utilize sempre URLs absolutos (https://...)

@context duplicado

Erros de processamento

Apenas um @context por bloco

Problemas com aspas escapadas

JSON não processado

Utilize \" para aspas dentro de strings

Demasiados dados aninhados

Ilegível para a IA

Mantenha os esquemas simples e focados

Lista de Verificação para Implementação

Utilize esta lista para implementar o JSON-LD:

  1. Identifique o tipo de esquema principal – Organização, Produto, Serviço, Artigo?

  2. Implemente o esquema de Organização – Na página inicial

  3. Adicione esquemas de Produto/Serviço – Nas páginas relevantes

  4. Implemente o esquema de Artigo – Em todas as publicações do blogue

  5. Crie o esquema FAQPage – Nas páginas de perguntas frequentes

  6. Adicione esquemas de Avaliação (Review) – Se tiver avaliações de clientes

  7. Aninhe entidades relacionadas – Ligue esquemas onde for relevante

  8. Teste com validadores – Google Rich Results + Schema.org

  9. Verifique a sintaxe JSON – Utilize o JSON Lint

  10. Monitorize após a publicação – Confirme se aparece corretamente no código fonte

Conclusão

O markup de esquema JSON-LD é a forma mais direta de comunicar com os sistemas de IA. Enquanto o HTML é ambíguo e requer interpretação, o JSON-LD é explícito e inequívoco. Normalmente, demora de 2 a 4 horas para implementar esquemas básicos num website, mas o efeito na visibilidade da IA é significativo.

Comece com o esquema de Organização na sua página inicial, adicione esquemas de Produto/Serviço nas páginas relevantes e avance a partir daí com esquemas de Artigos e FAQs. Teste sempre com validadores e atualize os dados quando a sua marca sofrer alterações.

Lembre-se: o JSON-LD não serve apenas para SEO – é a base de como a IA compreende e representa a sua marca.

‹ Pequenos pormenores que afetam a credibilidade técnica

Será este o fim da USP? ›