Você provavelmente já se deparou com essas incorporações sem pensar nisso - sempre que você envia a alguém um link em uma plataforma de mídia social ou aplicativo de mensagens, o link se expande para incluir conteúdo do site, geralmente uma imagem, título e descrição. Veja como configurar isso.

O que são meta tags Open Graph?

A configuração para essas incorporações é feita usando <meta> tags, geralmente no cabeçalho do seu site. Existe um padrão para eles, originalmente criado no Facebook, chamado de “protocolo Open Graph”.

As tags sempre usarão o seguinte formato, com um valor de “propriedade” definido como “og:” seguido pelo tipo de tag e um valor de “conteúdo” definido como o valor de qualquer conteúdo que esteja na página:

<meta property="og:type" content="value" />

Por exemplo, uma configuração básica para a maioria dos sites se parece com o seguinte:

<meta property="og:image" content="https://i.imgur.com/imagelink.jpg">
 <meta property="og:title" content="Website Title" />
 <meta property="og:description" content="Website Description" />
 <meta property="og:type" content="website" />
 <meta property="og:url" content="https://example.com/" />

Isso define a imagem, o título e o link, a descrição e informa aos sites que se trata de um website. Isso resulta em uma incorporação simples como a seguinte:

outro link expandir

É um formato simples, mas há algumas opções que a maioria dos sites reconhece. Você pode encontrar a lista completa deles no site do Open Graph, mas vamos cobrir os mais importantes aqui.

O Twitter reconhecerá as tags OG, mas é importante notar que eles também têm suas próprias tags, que terão prioridade.

<meta name="twitter:title" content="Website Title"> 
 <meta name="twitter:description" content="Website Description"> 
 <meta name="twitter:image" content="https://i.imgur.com/imagelink.jpg">

Usando OG Meta Tags

Primeiro, o título. esta é uma tag extremamente simples, mas necessária para todos. Mesmo que sua incorporação esteja representando um objeto em vez de uma página, ela ainda deve ter um título explicando o que é.

<meta property="og:title" content="Website Title" />

Opcionalmente, se o seu cargo não funcionar, você pode adicionar uma descrição estendida:

<meta property="og:description" content="Website Description" />

O og:type tag também é muito importante, porque informa aos sites que tipo de conteúdo você está vinculando e como ele deve ser formatado. Também permite diferentes tipos de parâmetros opcionais, dependendo do tipo. Existem algumas opções diferentes:

  • website, que é um padrão básico.
  • article, que representa uma notícia / postagem de blog e tem os parâmetros opcionais de published_time , modified_time , author , section , e tag .
  • profile, que representa um usuário e tem opções para first_name , last_name , username , e gender.
  • video.other, que representa um vídeo. Também existem tags para filmes e programas de TV, com parâmetros próprios.
  • Vários music tags relacionadas, algumas das quais estão na lista de permissões de sites como o Facebook.

Para parâmetros opcionais, você precisa adicionar uma meta propriedade separada com o nome do parâmetro. Por exemplo, definindo music:duration:

<meta property="music:duration" content="60" />

Você também deseja definir a tag de URL para vincular de volta ao seu site.

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

Se quiser que uma imagem seja exibida com sua incorporação, você também precisará definir isso. As imagens têm muitas opções de configuração:

<meta property="og:image" content="https://example.com/ogp.jpg" />
 <meta property="og:image:secure_url" content="https://secure.example.com/ogp.jpg" />
 <meta property="og:image:type" content="image/jpeg" />
 <meta property="og:image:width" content="400" />
 <meta property="og:image:height" content="300" />
 <meta property="og:image:alt" content="A shiny red apple with a bite taken out" />

Há também og:video e og:audio tags que funcionam da mesma maneira, mas para vídeo e áudio respectivamente.

Você também pode definir o nome do site manualmente, se o título não revelar isso.

<meta property="og:site_name" content="CloudSavvy IT" />

Depuração de metatags

Enviá-los para você mesmo para depurar não é a melhor ideia - muitas plataformas armazenarão a resposta em cache, tornando mais difícil fazer alterações rápidas.

Felizmente, existem algumas ferramentas excelentes, como opengraph.xyz, onde você pode inserir seu link e visualizar a resposta de incorporação de várias plataformas.

É claro que você ainda vai querer enviar o link em cada plataforma para verificar se está funcionando.

Você pode gerar tags dinamicamente?

Claro! As tags são apenas HTML, e a maioria dos frameworks web modernos trata de renderizar HTML dinâmico. Porém, ele precisa estar no cabeçalho, então pode complicar as coisas para alguns frameworks focados em escrever no corpo da página.

No React, você pode fazer isso facilmente com um pacote chamado react-helmet, que vai em seu componente App () principal. É claro que você pode usar a sintaxe JSX padrão para substituir qualquer um dos valores por valores do estado da sua página.

import React from "react";
 import Helmet from "react-helmet";
 
 function App() {
 return (
 <main>
 <Helmet>
 <title>Example</title>
 
 <meta itemprop="name" content="Example" />
 <meta property="og:title" content="Example" />
 
 <meta itemprop="description" content="A description" />
 <meta name="description" content="A description" />
 <meta property="og:description" content="A description" />
 
 <meta itemprop="image" content="http://example.com/example.png" />
 <meta property="og:image" content="http://example.com/example.png" />
 
 <meta property="og:url" content="https://example.com" />
 <meta property="og:type" content="website" />
 </Helmet>
 </main>
 );
 }

Para WordPress, você pode configurar isso com um plug-in ou adicionar algum PHP ao seu header.php Arquivo.

<meta name="description" content="<?php if ( is_single() ) {
         single_post_title('', true); 
     } else {
         bloginfo('name'); echo " - "; bloginfo('description');
     }
     ?>" />

Para outros frameworks, eles provavelmente suportarão metatags de alguma forma, então você vai querer verificar como isso funciona para o seu aplicativo.

Adicione ao Google Notícias
Neste artigo
  1. O que são meta tags Open Graph?
  2. Usando OG Meta Tags
  3. Depuração de metatags
  4. Você pode gerar tags dinamicamente?