Metadados SEO Blazor
Gerencie metadados SEO do Blazor em um só componente
Mantenha títulos, descrições, URLs canônicos, links hreflang, tags Open Graph, diretivas de robôs e JSON-LD em um componente Blazor reutilizável.
Revise os exemplos e compre a implementação completa para aprox. R$ 29 quando desejar o mesmo padrão em seu próprio aplicativo.
Visão geral
Use uma fonte de metadados para cada página
Um aplicativo Blazor pode renderizar muitas páginas do mesmo layout. Um componente central de metadados mantém cada título de página, descrição, URL canônico, links de idioma, visualização social e carga de esquema alinhados.
Verificação de adequação
Os metadados centrais superam a marcação head copiada e colada
Copiar tags de cabeçalho em cada página funciona por um tempo, então pequenas diferenças criam títulos duplicados, URLs canônicos obsoletos, links hreflang ausentes ou esquema que não corresponde mais à página visível. Um componente mantém a regra em um só lugar.
Use um componente quando as páginas compartilharem regras de SEO
- Muitas páginas compartilham o mesmo título, descrição, regras canônicas, hreflang, Open Graph e robôs.
- As páginas localizadas precisam de links de cultura consistentes e tratamento x-default.
- Artigos, perguntas frequentes, produtos ou páginas de software precisam de JSON-LD que corresponda ao conteúdo visível.
- Editores ou desenvolvedores devem atualizar os metadados sem editar a marcação do layout.
Evite marcações de cabeça dispersas
- Cada página escreve suas próprias tags de cabeçalho manualmente.
- O H1, o título e a meta descrição repetem a mesma frase.
- URLs canônicos apontam para rotas antigas após uma movimentação de página.
- O esquema de FAQ permanece online depois que o FAQ visível foi removido.
Sumário
Sinais de SEO
Mantenha a identidade da página consistente
Mecanismos de pesquisa, plataformas sociais e rastreadores de IA leem sinais ligeiramente diferentes. Eles ainda devem descrever a mesma página em linguagem simples.
Nomeie a página claramente
Use um título curto que contenha o tópico principal sem copiar o H1 palavra por palavra.
Convide a próxima ação
Escreva uma meta descrição natural que explique o benefício e dê aos usuários um motivo para abrir, avaliar ou comprar.
Escolha um URL preferido
O URL canônico deve apontar para a página que você deseja indexar, não para um link de rastreamento, redirecionamento ou rota obsoleta.
Vincular versões de idiomas
As páginas com reconhecimento de cultura precisam de links hreflang que correspondam a URLs reais e incluam uma página x-default sensata.
Controlar visualizações compartilhadas
As visualizações sociais devem usar o mesmo título de página, descrição, URL canônico e imagem preparada que o restante dos metadados.
Defina regras de rastreamento deliberadamente
Use robôs e diretivas de IA por página para que a indexação, os snippets, os arquivos e o uso da IA correspondam à política de conteúdo.
Dados estruturados
Gere esquema a partir dos metadados da mesma página
JSON-LD não deve contar uma história diferente da página. Use o mesmo título, descrição, URL canônico, data de publicação, imagem, localização atual e dados de perguntas frequentes que o artigo visível já usa.
Schema de artigo
Use o esquema do artigo quando a página tiver um título real, data de publicação, data de modificação, imagem e estrutura de seção.
Schema de FAQ
Use FAQPage somente quando as mesmas perguntas e respostas estiverem visíveis na página.
BreadcrumbList
Crie trilhas a partir da mesma hierarquia que os usuários podem entender por meio de links e navegação.
Software ou produto
Adicione o esquema do produto ou software somente quando o preço, a oferta, o nome e a descrição estiverem visíveis para os usuários.
Erros comuns
A maioria dos bugs de metadados são pequenas incompatibilidades
O componente é útil porque transforma verificações repetidas em um padrão repetível. O objetivo não é mais tags. O objetivo é menos contradições.
Não copie H1 no título e na descrição
O título, H1 e a meta descrição podem usar o mesmo tópico, mas cada um deve ter uma função diferente.
Não se esqueça dos URLs traduzidos
Se uma página existir em diversas culturas, os metadados e o hreflang deverão apontar para a rota da cultura correspondente.
Não reutilize imagens compartilhadas obsoletas
As imagens Open Graph e JSON-LD devem representar esta página, não o último artigo que usou o componente.
Não marque conteúdo oculto
As perguntas frequentes e o esquema do produto devem descrever o conteúdo que os usuários podem realmente ver na página.
Implementação
Conecte o componente uma vez e, em seguida, alimente-o com os dados da página
O padrão permanece enfadonho de propósito: defina um objeto de metadados de página, renderize o componente no layout ou página e passe JSON-LD correspondente quando a página precisar de dados estruturados.
Definir metadados da página
var metadata = new PageMetaData(culture)
{
Name = PageLinks.BlazorSEOMetaDataComponent,
Title = "Blazor SEO Metadata Component for Blazor Apps",
Description = "Keep title, description, canonical, hreflang, Open Graph, and JSON-LD aligned.",
ImageUrl = "/images/blazor/metadatacomponente/opengraph/hero-1200.png",
Url = PageLinks.BlazorSEOMetaDataComponent,
Robots = RobotsMetaTagExtensions.Join(RobotsMetaTagEnum.Index, RobotsMetaTagEnum.Follow),
AllowAiIndexing = true
};Renderizar metadados em um layout
@inherits LayoutComponentBase
<MetadataComponent MetaData="@PageMeta"
JsonLd="@Schema?.JsonLd"
RenderArticleMeta="@Schema?.RenderArticleMeta" />
@BodyAnexe JSON-LD na página
@page "/{Culture}/guide/"
@inherits PageBase
<MetadataComponent MetaData="@PageMeta"
JsonLd="@Schema?.JsonLd"
RenderArticleMeta="@Schema?.RenderArticleMeta" />
<ArticleFaq Id="faq" FAQ="@FAQs" />Validação
Verifique o resultado antes de publicar
Um componente de metadados só é útil quando o HTML renderizado está correto. Inspecione a origem da página, teste as visualizações de compartilhamento, valide o esquema e rastreie URLs localizados antes do lançamento.
Ver fonte
Verifique o cabeçalho HTML renderizado, não apenas o arquivo Razor. Os rastreadores leem a resposta final.
Validar esquema
Execute a validação aprimorada ou de esquema e corrija avisos que apontam para conteúdo visível ausente.
Compartilhamento de teste
Use depuradores de visualização social para verificar o comportamento do título, da descrição, da imagem e do cache.
Locais de rastreamento
Rastreie URLs de cultura para capturar links canônicos, hreflang ou x-default quebrados antes do lançamento.
Comece agora
Compre o componente quando suas regras de metadados se repetirem
Se você já estiver escrevendo o mesmo título, canônico, Open Graph e lógica JSON-LD em diversas páginas, compre a implementação completa para aprox. R$ 29 e mantenha a regra em um só lugar.
Recursos relacionados
Próximos guias para metadados Blazor SEO
Use esses guias quando precisar de mais detalhes sobre roteamento, dados estruturados, visualizações sociais ou a própria plataforma Blazor.
Perguntas frequentes
O que o componente de metadados Blazor faz?
Ele renderiza metadados de página de uma fonte digitada: título, descrição, URL canônico, links hreflang, tags Open Graph, diretivas de robôs e JSON-LD opcional.
Por que o título, H1 e a meta descrição deveriam ser diferentes?
Eles aparecem em lugares diferentes. O título auxilia na pesquisa e nas guias do navegador, o H1 nomeia a página visível e a descrição deve convidar a próxima ação.
O componente evita conteúdo duplicado?
Ajuda mantendo URLs canônicos e links hreflang consistentes. Você ainda precisa de descrições e cópias de páginas exclusivas para páginas direcionadas a diferentes intenções ou idiomas.
Como o JSON-LD se encaixa no componente?
A página cria JSON-LD a partir dos mesmos metadados e conteúdo visível usados pelo artigo, FAQ, localização atual, produto ou seção de software.
Posso controlar as tags do rastreador de IA por página?
Sim. Use robôs no nível da página e opções de IA para que as regras de indexação, snippets, arquivos, noai e noimageai correspondam à política de conteúdo dessa página.
Posso usar isso no Blazor WebAssembly?
Sim, mas os metadados de SEO são mais fortes quando as tags estão presentes na resposta HTML inicial. A renderização ou pré-renderização do servidor geralmente é a escolha mais segura.