Como e por que adicionar marcação semântica do tipo «HowTo» no WordPress: guia simples e completo

Se está aqui, imagino que já saiba que a marcação semântica (schema markup) é uma técnica que ajuda o Google e outros bots a compreender melhor o conteúdo do seu site. Já existe há bastante tempo, mas agora é mais relevante do que nunca.

Porquê?

Porque o Google está a usar estes dados, entre outras coisas, para apresentar as novas respostas geradas por IA (AI Overviews) diretamente nos resultados de pesquisa.

Embora plugins populares de SEO para WordPress, como RankMath ou Yoast SEO, incluam schema markup, a implementação costuma ser genérica e limitada a determinados tipos de conteúdo.

Por isso, neste guia vou mostrar-lhe como adicionar um schema menos comum, mas muito útil devido à IA: o tipo «HowTo», ideal para tutoriais passo a passo ou guias como este.

Aqui está em vídeo:

E abaixo, em texto, com as ligações necessárias.

#1. Escrever e publicar um artigo HowTo

É a primeira coisa, obviamente.

Antes de inserir qualquer schema markup no seu site, tem de ter um artigo pronto. Neste caso, também precisa de estar estruturado de forma clara e prática em vários passos.

Se tiver dúvidas sobre o processo, este é mais ou menos o método que sigo:

1. Escolho o tema sobre «como fazer algo». No meu caso, normalmente são processos ligados à analítica, ao marketing ou à IA.
2. Faço um esquema com todos os passos.
3. Desenvolvo cada ponto, criando um guia organizado em passos numerados.
4. Além do texto, acrescento exemplos, imagens ou vídeos que apoiem o conteúdo.

#2. Pedir ao ChatGPT que gere o schema HowTo

A forma mais rápida e eficaz que conheço de gerar o schema JSON-LD correto é usar o ChatGPT.

Neste caso, e enquanto não testo a versão 4.1, recomendo que use o4-mini-high . Caso contrário, use o4-mini ou o3.

Depois de selecionar o modelo, utilize um prompt como este:

"Como experto SEO, genera un schema HowTo para la siguiente URL: https://dominio.com/articulo-ejemplo/". Incluye todos los pasos detallados con su nombre, descripción, URL e imágenes y utiliza el contexto schema.org."

Quanto aos URLs, cada passo terá de ser um título. Facilito o processo porque uso o plugin Table of Contents Plus para criar um índice e indico-lhe que retire os URLs daí.

Quando tiver a resposta, copie-a.

#3. Como adicioná-lo no WordPress

Aqui existem várias opções. Organizei-as da mais simples para a mais complexa, de acordo com o trabalho necessário.

Opções do tema Genesis

Se utilizar um tema como o Genesis, a implementação é simples, porque cada artigo tem no final uma opção para adicionar um script.

Cole o script fornecido pelo ChatGPT no passo anterior na secção body:

Plugin PixelYourSite

Outra opção prática é o plugin PixelYourSite, que facilita a inserção de scripts específicos em páginas concretas.

Para o utilizar, siga este processo:

1. Instale e ative o plugin PixelYourSite a partir do repositório do WordPress.
2. Abra o artigo onde pretende adicionar a marcação.
3. Insira o código JSON-LD na secção «Footer».
4. Guarde as alterações.

Google Tag Manager (GTM)

Por fim, se por algum motivo não tiver acesso à administração do WordPress, ainda poderá implementar o schema.

Para isso, o Google Tag Manager é seu amigo.

Siga este processo:

1. Crie uma tag do tipo «Custom HTML».
2. Insira o código schema HowTo gerado.
3. Configure um acionador específico para a página do tutorial, por exemplo Window Loaded com correspondência de URL.
4. Publique as alterações no seu contentor GTM.

O problema é que terá de criar uma tag e um acionador para cada página, pelo que o contentor ficará rapidamente cheio.

Eu só vejo esta opção como último recurso.

#4. Verificar se está correto

Depois de implementar o schema markup, só falta validar que tudo funciona como deve.

Para isso:

1. Aceda ao validador oficial: https://validator.schema.org/.
2. Introduza o seu URL.
3. Execute a validação.
4. Se tudo tiver corrido como devia, não aparecerá nenhum erro.

E assim terminámos.

Conclusão

Como vê, não é difícil.

É, no entanto, trabalhoso se, como eu, tiver mais de 100 artigos deste género e precisar de os tratar um a um. Pensei em automatizar, mas o remédio era pior do que a doença.

Por isso, recomendo que comece a implementá-lo o mais cedo possível.

E se, em vez de HowTo, quiser criar marcação Recipe, Review ou Movie, pode repetir o processo.

Espero que isto o ajude a melhorar o seu tráfego de IA. E, se quiser mais conselhos como este, receba um por semana no seu e-mail subscrevendo abaixo, ou siga-me no meu canal do YouTube.