O que são Patches?
Patches permitem que você corrija problemas e faça alterações em seu website diretamente do Site Audit. Considere os Patches mais como uma correção rápida e temporária. Se você precisa corrigir algo crítico urgentemente e não tem tempo para pedir aos seus desenvolvedores, ou se deseja testar algo com a capacidade de desfazer facilmente antes de fazer a alteração final do seu lado, você pode usar Patches para isso.
O que você pode usar os Patches para alterar em uma página?
Atualmente, na primeira versão desse recurso, ele permite que você modifique apenas dois campos: Título e Metadescrição. Mais campos estarão disponíveis em breve. Temos planos para permitir o gerenciamento de redirecionamentos, canônicas, meta tags de robôs, além de adicionar e atualizar links internos, e muito mais.
Como usar os Patches?
Para criar um Patch, você precisa criar um problema relacionado a títulos de páginas ou metadescrições, ou abrir um preset de filtro relacionado a elas no Explorer de Páginas, ou adicionar esses campos lá manualmente. As questões que podem ser corrigidas são marcadas com um ícone de raio no relatório de Todos os Problemas.
Você verá uma entrada "Corrigir" no relatório ao lado de títulos e metadescrições para cada página no relatório. Você pode elaborar um novo título ou metadescrição e, quando tudo estiver pronto, publicá-lo ao vivo em seu site.
Status dos Patches
Os Patches podem ser salvos como rascunhos, publicados ou despublicados. Você pode levar o tempo que precisar para elaborar um título ou metadescrição antes de publicar. Os rascunhos são salvos automaticamente enquanto você digita. E uma vez publicado, você pode despublicar a qualquer momento para desfazer um patch.
O status atual de um patch, bem como as ações disponíveis, podem ser encontrados na entrada "Corrigir":
Você também pode rastrear o histórico completo de qualquer patch. Se você não tem certeza de quando um patch foi publicado ou quem editou seu rascunho, esse é o lugar para verificar. O link "Mostrar histórico" está disponível no menu de contexto de qualquer patch.
Relatório de Patches
Embora seja conveniente corrigir problemas diretamente nos relatórios de problemas, há também um "Relatório de Patches" dedicado onde você pode visualizar e gerenciar todos os patches que já criou para o seu site. Você pode acessar este relatório pelo cabeçalho, que também mostra o número de patches atualmente publicados.
O relatório de Patches permite filtrar patches por status e URL da página, exportar seus patches, bem como realizar todas as mesmas ações em patches como nos relatórios de problemas ou no Explorer de Páginas. Este relatório também permite configurar a implantação dos Patches.
Configurando a implantação de Patches
Para começar a configurar a implantação, clique no botão "Configurar implantação" no cabeçalho do Relatório de Patches.
Você pode implantar patches em seu site de duas maneiras:
Trecho de código do JavaScript
Para permitir que o Site Audit faça alterações em suas páginas, você precisará adicionar um pequeno trecho de JavaScript à seção <head> de cada página do seu site. O trecho JavaScript é gerado e fornecido durante a configuração da implantação.
Este trecho chama um arquivo JavaScript único hospedado pela Ahrefs. Todos os patches que você publicar são adicionados lá e aplicados no lado do cliente quando um navegador ou bot executar o JavaScript na página. Observe que bots que não executam JavaScript ao visitar sua página não verão as alterações. Mas o Google renderiza páginas antes de classificá-las, então isso geralmente não é um problema.
Você pode ativar ou desativar a implantação de JavaScript a qualquer momento. Se você desativá-la enquanto os patches estiverem ativos, será solicitado a confirmar que eles serão despublicados.
Worker da Cloudflare
Se você estiver no Cloudflare, pode permitir que o Site Audit execute um worker em sua conta Cloudflare para aplicar patches no lado do servidor, para que tanto o HTML bruto quanto a página renderizada incluam suas alterações. Isso é especialmente importante para tags como <link rel="canonical"> ou <meta name="robots">, já que o Google verifica ambas as versões antes de decidir qual honrar.
Veja como funciona:
Criar um token de API
Será solicitado que você conceda permissão à Ahrefs para criar um worker do Cloudflare em sua conta fornecendo um token de API. No seu dashboard do Cloudflare, gere um token com escopo para a zona do seu site com estas permissões:
Conta > Scripts dos Workers: Editar
Zona > Rotas dos Workers: Editar
Zona > Zona: Leitura
Criação única do worker
O Site Audit usa seu token para instalar um worker em sua conta e, para maior segurança, descarta o token imediatamente. Então, nunca mantemos acesso contínuo ao seu dashboard do Cloudflare.
Busca de patches em tempo real
O script do worker contém a lógica central de aplicação de patches, mas seus patches reais ficam em um arquivo JSON na Ahrefs. Sempre que você publicar novos patches, o worker busca o JSON mais recente em tempo real.
Mantendo seu worker sincronizado
Como não armazenamos suas credenciais, não podemos detectar edições manuais no script do worker que possam quebrar a aplicação de patches. Se isso acontecer, você pode simplesmente clicar em Reimplantar worker para restaurar o script atualizado. Ocasionalmente, o Site Audit pode solicitar que você reimplante o worker também se atualizações importantes de recursos exigirem isso.
Assim como na implantação de JavaScript, você pode desativar a implantação do Cloudflare a qualquer momento.
Implantar patches manualmente
Os patches estão disponíveis para todos os usuários, mas, para publicá-los a partir do Site Audit, seu projeto precisa de um impulso de atualização que suporte o recurso de patches. Se o projeto não for atualizado ou se você não quiser usar o Site Audit para a implantação atual, você pode criar rascunhos de patches, exportá-los e entregá-los aos seus desenvolvedores para que possam fazer e implantar as alterações do lado deles.
Pontos importantes
Considere os seguintes pontos para usar os Patches de forma mais eficaz.
As alterações são visíveis para todos que visitam seu site: Fazer alterações que as pessoas e bots possam ver é um objetivo óbvio do recurso Patches, mas apenas para deixar claro. Publicar patches exibirá mudanças visíveis no seu site. Após a publicação de um patch, pessoas e bots que visitarem seu site verão as alterações. Portanto, é importante garantir que as alterações que você publica são adequadas para o seu site.
Elaboração e publicação precisam de verificações extras: Qualquer usuário com acesso a um projeto pode elaborar patches. No entanto, somente usuários com 2FA configurado em suas configurações de conta podem publicar patches. Certifique-se de ter selecionado as pessoas certas para ter acesso a projetos que têm a implantação de Patches ativada, pois elas terão a capacidade de publicar alterações em seus sites. Além disso, os patches só podem ser publicados em projetos onde a propriedade do site foi verificada.
Os patches estão vinculados aos projetos: Se você excluir um projeto, todos os patches publicados nele serão despublicados.
O Project Boost deve ser adquirido: A implantação de patches não está disponível em todos os projetos. Seu projeto precisa de um impulso de atualização que suporte o recurso de patches para publicar patches. Se você rebaixar para um impulso que não o suporte, não poderá publicar novos patches. No entanto, os patches publicados anteriormente permanecerão ativos.
Execute JavaScript precisa estar ativado: A opção "Execute JavaScript" é automaticamente ativada nos projetos onde você configura a implantação. Isso garante que o bot do Site Audit possa detectar as mudanças implantadas via JavaScript na próxima vez que ele rastrear seu site. Observe que a velocidade de rastreamento pode ser mais lenta com a execução de JavaScript, então suas explorações levarão mais tempo se você tinha essa opção desativada antes.
Você será convidado a concordar com estes termos antes de ativar a implantação de JavaScript no Site Audit.