Guarda de Regressão de Structured Data

A structured data falha em silêncio. Uma actualização de plugin deixa cair uma propriedade obrigatória, um editor deixa um campo em branco, e o rich result desapareceu muito antes de o relatório de melhorias registar qualquer alteração. Validar um URL à mão no momento da construção não apanha nada disto, porque a falha vem da variação dos dados ao longo do catálogo e não do template que foi testado.

O ficheiro da competência

---
name: structured-data-regression-guard
description: Use quando os rich results desaparecem sem causa evidente, ou depois de qualquer alteração de CMS, template, tema ou plugin que toque na marcação das páginas.
---

# Guarda de Regressão de Structured Data

A structured data falha em silêncio. Uma actualização de plugin deixa cair uma propriedade obrigatória, um editor deixa um campo em branco, e o rich result desapareceu muito antes de o relatório de melhorias registar qualquer alteração. Validar um URL à mão no momento da construção não apanha nada disto, porque a falha vem da variação dos dados ao longo do catálogo e não do template que foi testado.

## O que precisa primeiro

- Uma lista dos templates que emitem structured data e o tipo de schema que cada um emite
- HTML renderizado, e não o código do template, para pelo menos 20 URLs por template escolhidos de modo a incluir casos limite
- Relatórios de melhorias da Search Console com contagens de erros e avisos por tipo
- A documentação actual do Google sobre propriedades obrigatórias e recomendadas para os tipos de resultado que pretende

## Método

1. Extraia o JSON-LD do HTML renderizado e não do ficheiro do template. O que é servido é o que o CMS produziu depois de os campos serem preenchidos, e as falhas estão no preenchimento, não no template.
2. Escolha a amostra deliberadamente à procura de ausências: o item sem imagem, o que não tem avaliações, o mais barato e o mais caro, um esgotado, um com um nome invulgarmente longo. Uma amostra uniforme passa e não prova nada.
3. Valide contra as propriedades obrigatórias do rich result concreto que quer, e não contra o schema.org em geral. O schema.org aceita imensa coisa que o Google nunca vai mostrar.
4. Confirme que os valores marcados coincidem com o que o utilizador consegue ver na página. Preços, classificações e disponibilidade que só existem na marcação são um risco de acção manual, e a divergência é normalmente causada por uma cache desactualizada e não por intenção de alguém.
5. Registe uma contagem de linha de base por template e por tipo, e volte a correr a mesma extracção depois de cada alteração de template, tema ou plugin. Uma contagem a descer é o alerta, e dispara semanas antes da Search Console.
6. Leia o relatório de melhorias como confirmação com atraso, e não como detector. Diz-lhe o que o Google já processou, o que é útil para arbitrar e inútil como aviso antecipado.
7. Quando a marcação é válida e o rich result continua a não aparecer, pare antes de reescrever seja o que for. Elegibilidade não é direito adquirido, o Google retira tipos de resultado por query e por site, e a verificação a fazer é se os concorrentes ainda mostram esse tipo de resultado para as mesmas queries.

## O que isto produz

Uma linha de base de structured data por template com a cobertura das propriedades obrigatórias, um conjunto de amostras deliberadamente difíceis, e uma extracção repetível que assinala quedas de contagem após qualquer alteração de marcação.

## Onde isto corre mal

- Validar o template isoladamente, o que passa enquanto as páginas em produção falham nos campos que ninguém preencheu
- Marcar valores que a página não mostra, que é a causa mais comum de uma acção manual sobre structured data
- Acrescentar todas as propriedades que o schema.org permite na teoria de que mais marcação posiciona melhor, o que aumenta a superfície de avaria e não acrescenta elegibilidade
- Reescrever marcação válida porque um rich result desapareceu, quando foi o próprio tipo de resultado que foi retirado para aquelas queries

---

Da biblioteca de competências da QuQi - https://www.quqi.io/pt/skills/structured-data-regression-guard

O que precisa primeiro

• Uma lista dos templates que emitem structured data e o tipo de schema que cada um emite
• HTML renderizado, e não o código do template, para pelo menos 20 URLs por template escolhidos de modo a incluir casos limite
• Relatórios de melhorias da Search Console com contagens de erros e avisos por tipo
• A documentação actual do Google sobre propriedades obrigatórias e recomendadas para os tipos de resultado que pretende

Método

1. 01 Extraia o JSON-LD do HTML renderizado e não do ficheiro do template. O que é servido é o que o CMS produziu depois de os campos serem preenchidos, e as falhas estão no preenchimento, não no template.
2. 02 Escolha a amostra deliberadamente à procura de ausências: o item sem imagem, o que não tem avaliações, o mais barato e o mais caro, um esgotado, um com um nome invulgarmente longo. Uma amostra uniforme passa e não prova nada.
3. 03 Valide contra as propriedades obrigatórias do rich result concreto que quer, e não contra o schema.org em geral. O schema.org aceita imensa coisa que o Google nunca vai mostrar.
4. 04 Confirme que os valores marcados coincidem com o que o utilizador consegue ver na página. Preços, classificações e disponibilidade que só existem na marcação são um risco de acção manual, e a divergência é normalmente causada por uma cache desactualizada e não por intenção de alguém.
5. 05 Registe uma contagem de linha de base por template e por tipo, e volte a correr a mesma extracção depois de cada alteração de template, tema ou plugin. Uma contagem a descer é o alerta, e dispara semanas antes da Search Console.
6. 06 Leia o relatório de melhorias como confirmação com atraso, e não como detector. Diz-lhe o que o Google já processou, o que é útil para arbitrar e inútil como aviso antecipado.
7. 07 Quando a marcação é válida e o rich result continua a não aparecer, pare antes de reescrever seja o que for. Elegibilidade não é direito adquirido, o Google retira tipos de resultado por query e por site, e a verificação a fazer é se os concorrentes ainda mostram esse tipo de resultado para as mesmas queries.

O que isto produz

Uma linha de base de structured data por template com a cobertura das propriedades obrigatórias, um conjunto de amostras deliberadamente difíceis, e uma extracção repetível que assinala quedas de contagem após qualquer alteração de marcação.

Onde isto corre mal

• Validar o template isoladamente, o que passa enquanto as páginas em produção falham nos campos que ninguém preencheu
• Marcar valores que a página não mostra, que é a causa mais comum de uma acção manual sobre structured data
• Acrescentar todas as propriedades que o schema.org permite na teoria de que mais marcação posiciona melhor, o que aumenta a superfície de avaria e não acrescenta elegibilidade
• Reescrever marcação válida porque um rich result desapareceu, quando foi o próprio tipo de resultado que foi retirado para aquelas queries

Use esta skill na sua própria IA

O ficheiro é markdown simples, com o nome e o gatilho no frontmatter. Quando um assistente consegue carregar skills sozinho, é esse frontmatter que lê para decidir que esta se aplica.

Mais em SEO técnico