Pular para o conteúdo principal

Introdução

Busque e atualize o sitemap do seu projeto para ajudar os motores de busca a descobrir e indexar páginas.

Mais informações sobre a interface do usuário do módulo https://doc.oneentry.cloud/docs/category/sitemap

🎯 O que este módulo faz?​

O módulo Sitemap permite que você recupere e (re)gere o sitemap do seu projeto OneEntry - uma lista estruturada de todas as páginas usadas pelos motores de busca para indexar seu conteúdo de forma eficiente.

Um sitemap informa aos motores de busca quais páginas existem, ajudando o Google, Bing e outros crawlers a descobrir e indexar seu conteúdo mais rapidamente. A geração é acionada explicitamente via updateSitemap(body); getSitemap() retorna a lista de URLs do sitemap geradas.

🚀 Início Rápido​

Inicialize o módulo a partir de defineOneEntry:


const { Sitemap } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

Recupere a lista de URLs do sitemap geradas:

// Returns an array of sitemap URL strings (string[]).
const sitemaps = await Sitemap.getSitemap();

sitemaps.forEach((url) => {
  console.log(url);
});

✨ Conceitos Chave​

O que é um Sitemap?​

Um sitemap é um arquivo XML que lista as páginas do seu site para que os motores de busca possam descobri-las e rastreá-las de forma eficiente. Cada entrada pode conter uma URL, data da última modificação, frequência de alteração e prioridade.

Leitura vs. Atualização do Sitemap​

getSitemap() retorna um array de strings de URL do sitemap (string[]), por exemplo:

[
  'https://your-project.oneentry-cloud.com/sitemap.xml',
  'https://your-project.oneentry-cloud.com/sitemap-en.xml'
]

Os campos por entrada url, lastmod, changefreq, priority são propriedades de entrada de ISitemapQuery (passadas para updateSitemap()), não fazem parte da resposta de getSitemap().

Valores de Frequência de Alteração​

Esses valores são parte da entrada de updateSitemap() (changefreq):

ValorSignificado
alwaysA página muda toda vez que é acessada
hourlyA página muda a cada hora
dailyA página muda a cada dia
weeklyA página muda a cada semana
monthlyA página muda a cada mês
yearlyA página muda uma vez por ano
neverPágina arquivada, não mudará

📋 O que você precisa saber​

Gerando o sitemap​

O sitemap é gerado quando você chama updateSitemap(body), onde body (um ISitemapQuery) fornece os baseUrls por idioma usados para construir as URLs. Ele não é produzido automaticamente - você aciona a geração explicitamente.

Recuperando o sitemap​

Use getSitemap() para recuperar a lista de URLs do sitemap geradas (string[]).

Enviando para motores de busca​

O módulo não envia diretamente para motores de busca. Após recuperar as URLs do sitemap, envie-as através das ferramentas para webmasters do seu motor de busca (Google Search Console, Bing Webmaster Tools, etc.) e mantenha o sitemap atualizado após grandes mudanças de conteúdo.

📊 Tabela de Referência Rápida​

MétodoDescrição
getSitemap()Obter as URLs atuais do sitemap
updateSitemap()Gerar/atualizar o sitemap

❓ Perguntas Comuns (FAQ)​

Como faço para enviar meu sitemap para o Google?​

Gere sitemaps com updateSitemap(body) (passando seus baseUrls), recupere as URLs do sitemap resultantes com getSitemap(), e então envie uma URL do sitemap no Google Search Console sob Sitemaps.

Com que frequência devo atualizar meu sitemap?​

Atualize seu sitemap sempre que adicionar novas páginas, atualizar significativamente o conteúdo existente ou mudar a estrutura do seu site. Para sites de alto tráfego, considere atualizações automatizadas acionadas por mudanças de conteúdo.

O que significa o campo de prioridade?​

A prioridade (0.0 a 1.0) é uma dica para os motores de busca sobre a importância relativa das páginas no seu site. A página inicial é tipicamente 1.0, páginas de categoria 0.8, e páginas de conteúdo individuais 0.6–0.7. É parte da entrada de updateSitemap() e não afeta diretamente o ranking.

🎓 Melhores Práticas​

  • Regenerar após mudanças de conteúdo - Chame updateSitemap() após adicionar ou mudar significativamente páginas.
  • Defina a frequência de alteração com precisão - Não afirme que as páginas mudam com mais frequência do que realmente mudam.
  • Use prioridades significativas - Página inicial > Categorias > Produtos > Postagens de blog.
  • Inclua todas as páginas importantes - Não exclua páginas que você deseja que sejam indexadas.
  • Envie após grandes atualizações - Notifique os motores de busca proativamente através das ferramentas para webmasters.

🔗 Documentação Relacionada​