Como usar
- Digite cada pergunta e sua resposta como aparecem na página.
- Adicione mais pares, mova-os para cima ou para baixo ou remova os que não precisar. Pares incompletos são ignorados e sinalizados.
- Copie o script e cole-o no HTML da página, no head ou no body.
- Teste a página com um validador de dados estruturados para confirmar se a marcação está sendo lida corretamente.
Como funciona
O gerador cria um objeto FAQPage do schema.org com uma Question para cada par, e cada uma contém um acceptedAnswer do tipo Answer. O JSON é gerado com um serializador JSON próprio, que escapa corretamente aspas, barras invertidas e quebras de linha no texto. Além disso, todo “<”, “>” e “&” é escrito como uma sequência de escape \u. Isso impede que textos como “</script>” ou “<!--” em uma resposta encerrem o elemento script antes da hora e quebrem a página, enquanto os parsers de JSON continuam lendo os caracteres originais.
Sobre os resultados avançados: em agosto de 2023, o Google limitou os resultados avançados de FAQ a sites governamentais e de saúde conhecidos e com autoridade. Para a maioria dos outros sites, a marcação FAQPage não gera mais perguntas expansíveis na Pesquisa Google. Ela continua sendo dado estruturado válido que descreve a página, e outros consumidores de dados do schema.org podem usá-la.
Boas práticas: as perguntas e respostas na marcação também devem estar visíveis na página; cada pergunta deve ter uma única resposta escrita pelo site (em páginas nas quais usuários enviam respostas, o tipo correto é QAPage); e a marcação não deve ser usada para publicidade. As respostas podem conter HTML simples, como links e listas, permitido pelas diretrizes do Google no texto das respostas.
Exemplos
Página de suporte do produto
Três perguntas sobre entrega, devoluções e garantia formam uma FAQPage com três itens Question. Cole o script uma vez na página de suporte que exibe essas perguntas.
Resposta com código
Uma resposta que menciona “</script>” é exibida como \u003c/script\u003e no JSON, mantendo intacta a tag script da página e sem alterar o texto visível.
Perguntas frequentes
A marcação de FAQ fará minha página aparecer nos resultados avançados do Google?
Provavelmente não, a menos que seja um site governamental ou de saúde conhecido e com autoridade. Em 2023, o Google restringiu os resultados avançados de FAQ a esses sites. A marcação continua válida e pode ser lida por outros serviços.
Onde devo inserir o script JSON-LD?
Em qualquer lugar do HTML, no head ou no body. Ela não exibe nada na página. Adicione-a somente à página que realmente mostra essas perguntas e respostas.
Posso incluir links nas respostas?
Sim. As diretrizes de FAQ do Google permitem um conjunto limitado de tags HTML no texto das respostas, como links, listas e parágrafos. Digite o HTML na resposta; ele será escapado com segurança no script.
Por que a saída contém sequências \u003c?
Essa é a sequência de escape JSON para “<”. Escrevê-lo dessa forma impede que o script seja fechado por um texto dentro das respostas. Qualquer leitor de JSON-LD decodifica a sequência de volta para “<”.
Privacidade
A marcação é gerada no seu navegador. Suas perguntas e respostas não são enviadas nem armazenadas.