Especificar uma URL canônica

O compartilhamento de link do Facebook permite que você especifique uma URL canônica para um recurso nos metadados HTML do recurso. Isso é feito usando uma metatag HTML para especificar a URL canônica da página. A URL canônica é especificada usando a propriedade og:url.

<meta property="og:url" content="https://example.com/path" />

A partir de 3 de fevereiro de 2020, não será mais possível especificar URLs com um domínio diferente da URL canônica, a menos que este domínio tenha adicionado o seu à lista de permissão com a ferramenta para webmasters.

Todos os links que especificam a mesma URL canônica são tratados como o mesmo recurso pela infraestrutura de compartilhamento de links do Facebook para fins de métricas e metadados (imagem do link, título etc.). Você pode visualizar as métricas de envolvimento de uma URL usando a chamada da Graph API:

GET /?id={your_url}&fields=engagement

Há várias situações em que pode ser útil tratar vários links em seu site como idênticos. Veja alguns exemplos:

  • Você altera a URL de uma página, mas não quer perder as métricas anteriores.
  • Você fornece links para conteúdo com versão, mas, para fins de métricas, trata o conteúdo como uma única página.
  • Você deseja que o Facebook desfaça a duplicação de links semelhantes ao exibi-los em qualquer superfície.

Considerações adicionais

  • O caminho especificado para og:url não precisa ser uma página renderizada no navegador. Entretanto, deve responder ao rastreador do Facebook e retornar as metatags og:*. Para mais detalhes sobre como detectar o rastreador do Facebook, consulte Rastreador do Facebook.
  • Quando o caminho referenciado por og:url retorna um link og:url diferente, o novo link é seguido. Os detalhes de compartilhamento que o Facebook usa são os que estão no link final na cadeia de redirecionamento. O link final na sequência também deve incluir a metatag og:url. Se og:url não for especificado, a URL da página será considerada como a URL canônica.

Como preservar as métricas de envolvimento ao alterar uma URL

O exemplo a seguir demonstra como alterar a URL de uma página, preservando o link de compartilhamento do Facebook e as métricas relacionadas. A URL da página é considerada como já alterada.

  1. Use um redirecionamento HTTP 301 ou 302 para enviar visitantes à nova URL ao visitarem a antiga. O rastreador ainda precisa acessar a URL antiga, portanto, isente o agente do usuário do rastreador da ação de redirecionamento e redirecione somente os clientes rastreadores que não sejam do Facebook. Para mais informações sobre como detectar o Rastreador do Facebook, veja Compartilhamento das melhores práticas - Rastreador.
  2. Abra a nova página e adicione a tag og:url. Configure o atributo de conteúdo com o valor da URL anterior.
  3. <meta property="og:url" content="your_old_url" />
  4. Crie uma nova página na URL antiga e adicione as seguintes metatags de cabeçalho:
  5. <!-- This is the URL for this page -->
    <meta property="og:url" content="your_old_url" />
    
    <!-- This is the og:* meta from the original version of the page -->
    <meta property="og:title" content="your_link_title">
    <meta property="og:image" content="your_image_url">
  6. Publique seu conteúdo e, em seguida, use o Depurador de Compartilhamento para verificar se o servidor está retornando os metadados corretos para cada uma das suas URLs.

    Abra o Depurador de Compartilhamento