Perguntas frequentes sobre plugins sociais

O botão Curtir, Compartilhar e Enviar disponíveis para web, iOS e Android. As publicações incorporadas e o plugin de página estão disponíveis exclusivamente para web.

• Web: Se você estiver usando plugins sociais na web, precisa ter uma conta de desenvolvedor do Facebook para obter um ID do aplicativo.
• iOS/Android: Se você estiver usando plugins sociais em um aplicativo iOS ou Android, precisa ter uma conta de desenvolvedor do Facebook para obter um ID do aplicativo.

• Web: Se você estiver usando plugins sociais na web, precisa ter uma conta de desenvolvedor do Facebook para obter um ID do aplicativo.
• iOS/Android: Se você estiver usando plugins sociais em um aplicativo iOS ou Android, precisa ter uma conta de desenvolvedor do Facebook para obter um ID do aplicativo.

• Web: Se você estiver usando plugins sociais na web, não precisa enviar sua integração para avaliação. Você pode usar qualquer plugin social instantâneo.
• iOS/Android: Se você estiver usando plugins sociais em um aplicativo do iOS ou Android, terá que enviar sua integração do botão Curtir para avaliação pela guia Avaliação de aplicativo no Painel de Aplicativos.

Se uma pessoa visitou o Facebook e visita seu site com um plugin social, o navegador envia para nós informações para carregar conteúdo do Facebook naquela página. Os dados que recebemmos podem incluir informações como o ID de usuário da pessoa, o site que ela está acessando, a data e o horário e outras informações relacionadas ao navegador. Nós registramos algumas dessas informações para usá-las para melhorar nossos produtos e serviços e como mostrar para as pessoas anúncios mais interessantes e úteis.

Se você estiver usando as versões HTML5 ou XFBML, você deve incluir o código de linguagem ao instanciar a biblioteca.

Quando você carregar o SDK, altere o valor de js.src para usar sua localidade. Substitua en_US pela sua localidade, por exemplo, fr_FR para usar francês (França):

// Example 1:
'https://connect.facebook.net/fr_FR/sdk.js';

// Example 2:
js.src = "https://connect.facebook.net/fr_FR/sdk.js#xfbml=1&version=v2.6"; 

As localidades compatíveis estão listadas no arquivo XML de localidades do Facebook.

Talvez você tenha que ajustar a largura do Plugin Social para acomodar idiomas diferentes. Encontre mais informações sobre sua página Localização e Tradução.

• Web: Se você estiver usando plugins sociais na web, não precisa enviar sua integração para avaliação. Você pode usar qualquer plugin social instantaneamente.
• iOS/Android: Se você estiver usando plugins sociais com um aplicativo iOS ou Android, precisará enviar sua integração do botão Curtir para avaliação por meio da guia Análise do Aplicativo no Painel de Aplicativos.

Dependendo do Plugin Social, talvez você precise implementar uma versão específica para dispositivos móveis, tablet ou desktop. Consulte as perguntas frequentes ou o documento de introdução do plugin que você deseja implementar. Nota: Não é recomendado usar consultas de mídia do CSS para ajustar o tamanho de plugins sociais.

Se precisar mudar uma página para uma URL diferente, você não conseguirá mover as curtidas, os compartilhamentos e os comentários diretamente para a nova URL, mas conseguirá usar a URL antiga como fonte canônica do número de curtidas ou compartilhamentos na nova URL. Saiba a explicação sobre como fazer isso a seguir.

Explicação

Ao decidir sobre para qual URL uma ação de curtida ou compartilhamento deve ser atribuída, o Facebook usa um processo para resolver a URL canônica da URL que está sendo carregada. Quando uma URL é carregada, o rastreador busca:

1. Um redirecionamento HTTP 301 ou 302
2. O uso de uma tag og:url do Open Graph na página
3. O uso de rel=canonical conforme descrito em RFC 6596. (O rastreador do Facebook suporta somente conteúdo, não cabeçalhos de HTTP.)

Se algum desses métodos resultar em uma URL diferente da URL originalmente carregada, a URL especificada será considerada a "URL canônica" da URL original. Caso seja necessário, o rastreador também seguirá uma cadeia de redirecionamentos para encontrar a URL canônica.

Todas as curtidas e os compartilhamentos serão atribuídos à URL canônica em vez da URL carregada.

Exemplos

Dica: Use nosso depurador para ver o que o Facebook vê ao rastrear sua página.

Ao controlar a URL canônica, você pode mover conteúdo de uma URL para outra e reter contagens de curtidas e compartilhamentos, contanto que você permita que o Facebook continue vinculando a nova URL à antiga. Isso pode ser feito por meio de dois métodos:

Adicionar uma tag og:url à nova URL apontando para a URL antiga (Preferencial)

Na nova URL, você deve incluir um link para a URL antiga. Por exemplo, se a nova URL for https://example.com/new-url, e a antiga for https://example.com/old-url, você deve incluir este trecho na new-url:

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

Ao usar esse método, você diz ao rastreador que a URL canônica está na localização antiga, e ele usará isso para gerar o número de curtidas e compartilhamentos da página. Novas curtidas e compartilhamentos serão acrescentados à URL antiga também.

Isso também exige que a URL antiga ainda gere um documento com tags do Open Graph e retorne uma resposta HTTP 200, ao menos quando carregada por um rastreador do Facebook. Se você deseja que outros clientes sejam redirecionados ao visitar a URL, deve enviar a resposta HTTP 301 para todos os clientes de rastreadores que não sejam do Facebook. A URL antiga deve conter sua própria tag og:url que aponta para si mesma.

Você pode aprender a reconhecer o rastreador do Facebook em nosso Guia de melhores práticas para compartilhamento.

Esse método funciona com rel=canonical também, mas de preferência use og:url.

Redirecionar o rastreador do Facebook para a URL antiga

Outro método para fazer isso é redirecionar o rastreador do Facebook para a URL antiga sempre que ele acessar a nova URL. Assim como no método descrito anteriormente, a URL antiga deve ser um documento válido com cabeçalhos do Open Graph. E, se você deseja incluir um redirecionamento na URL antiga, o rastreador do Facebook não deve ser redirecionado quando acessar a URL antiga.

Somente conteúdo público pode ser incorporado. Se a publicação, página ou URL tiver algum tipo de restrição de privacidade, não poderá ser incorporada. Isso se aplica aos recursos botão Curtir, plugin de Página, Publicações incorporadas e Vídeos.

Um jeito rápido de testar se um conteúdo específico pode ser incorporado é tentar carregá-lo usando o modo Anônimo ou Privado do seu navegador.

A história criada pela ação de curtir, compartilhar ou enviar sua página pode ser aperfeiçoada usando meta tags para transformar uma página HTML simples em um objeto do Open Graph.

Se você planeja usar os botões Curtir, Compartilhar ou Enviar em qualquer página do site, você deve ler nosso guia sobre melhores práticas para garantir que as histórias publicadas fiquem legais no Facebook e tenham a melhor distribuição possível.

Recomendamos que você inclua todos os botões do seu aplicativo ou site para permitir que as pessoas escolham como desejam compartilhar seu conteúdo.

A configuração ref faz com que dois parâmetros sejam adicionados à URL encaminhada quando uma pessoa clica em um link em um story em stream sobre um link compartilhado:

• fb_ref - O parâmetro ref
• fb_source - Curtir/Compartilhar: O tipo de stream (home, profile, search, ticker, tickerdialog ou other) em que o clique ocorreu e o tipo de story e (oneline ou multiline), concatenado com um sublinhado. Enviar: O tipo de story (message) em que o clique ocorreu.

Por exemplo:

http://www.facebook.com/l.php?fb_ref=top_left&fb_source=profile_oneline

Você pode monitorar esses parâmetros usando seu software de análise.

Se o botão Curtir, Compartilhar ou Enviar estiver posicionado perto da borda de um elemento HTML com a propriedade de CSS overflow definida como hidden, a janela flutuante pode ficar colada ou completamente escondida quando o botão for clicado. Isso pode ser solucionado se você definir a propriedade overflow como um valor diferente de hidden, como visible, scroll ou auto.

O Facebook precisa cortar links compartilhados com o Facebook para saber para qual link prever as informações que devem ser mostradas no Facebook.com ou no Facebook para iOS e Android. Isso acontece a cada 30 dias para garantir que as propriedades estejam atualizadas. A página vinculada também é cortada quando a URL é inserida na Ferramenta do depurador.

O Facebook observa os cabeçalhos de cache nas suas URLs - ele olhará para Expires e Cache-Control em ordem de preferência. Contudo, mesmo se você especificar um tempo mais longo, o Facebook cortará sua página a cada 30 dias.

Em alguns casos, você pode querer exibir uma versão diferente de uma página para nosso cortador (contendo mais metadados do Open Graph) do que para as pessoas que estão visualizando a página. Nesse caso, você pode direcionar o agente do navegador usado pelo cortador:

facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php)

Sim. Simplesmente especifique a URL da sua página do Facebook na configuração href do botão.

Existem proteções contra spam e de integridade vinculadas aos plugins sociais, e essa é uma delas. Se você fez muitos testes em um botão Curtir antes de lançá-lo, pode ter acionado sem querer essas proteções. Além disso, alguns domínios na internet tem mais probabilidade de conter spam, por isso, verão a etapa de confirmação com mais frequência.

Essa confirmação adiciona uma etapa extra ao processo do botão Curtir, mas depois que a curtida é confirmada separadamente por um determinado número de usuários, ela deixará de aparecer, sendo exibido somente o botão Curtir normal.

O número mostra a soma:

• Do número de curtidas da sua URL
• Do número de compartilhamentos da URL (isso inclui copiar e colar o link no Facebook)
• Do número de curtidas e comentários em stories do Facebook sobre a sua URL

Para obter o código para exibir o botão Compartilhar sozinho, visite nossa documentação sobre o botão Compartilhar.

O número mostra a soma:

• Do número de curtidas da sua URL
• Do número de compartilhamentos da URL (isso inclui copiar e colar o link no Facebook)
• Do número de curtidas e comentários em stories do Facebook sobre a sua URL

Para obter o código para exibir o botão Compartilhar sozinho, visite nossa documentação sobre o botão Compartilhar.

Sim, ainda que recomendemos usar o botão Compartilhar para oferecer a experiência mais simples e consistente para as pessoas que usam o seu site, oferecemos uma caixa de diálogo independente que pode ser invocada usando o SDK do JavaScript ou um link da URL. Leia nosso guia sobre como usar a Caixa de Diálogo de Compartilhamento.

• Adiciona pontuação (por exemplo, pontos no final das frases)
• Apaga espaços em branco extras
• Expande abreviaturas
• Adiciona um espaço depois da pontuação (por exemplo, "Oi,gato" vira "Oi, gato")
• Repara erros de gramática comuns

Você pode ativar o filtro de gramática na seção de configurações no plugin.

Os comentários para cada URL podem ser acessados via Graph API. Simplesmente faça uma solicitação do HTTP GET para:

https://graph.facebook.com/v2.6/?fields=og_object{comments}
  &id=<YOUR_URL>
  &access_token=<YOUR_TOKEN>

Para instruções detalhadas, consulte Moderação de comentários. Se você não conseguir definir a lista de moderadores usando a propriedade meta fb:admins, pode definir fb:app_id e atualizar a lista de moderadores nas configurações da ferramenta de moderação para esse aplicativo.