Login do Facebook: guia para publishers de integração internos

O Login do Facebook é uma nova forma de permitir o acesso aos dados da API de Relatórios do Audience Network. Esta abordagem substitui o antigo sistema de copiar e colar o token do usuário do sistema na interface do Gerenciador de Monetização. Dessa forma, o acesso aos dados é fornecido com mais segurança, considerando o risco de o token do Gerenciador de Monetização ser vazado para fora da empresa.

Atualmente, estamos exigindo o Login do Facebook para a API de Relatórios v2. Planejamos exigir o Login do Facebook para a API de Relatórios v1 até 1º de julho. Por isso, lembre-se de migrar para o Login do Facebook.

Estou usando terceiros para obter dados da API de Relatórios

Se você estiver usando o parceiro existente (Parceiro de Métricas para Aplicativos ou de Mediação), não será necessário fazer codificações adicionais. Seu parceiro deve integrar o fluxo do Login do Facebook. Devido à natureza da antiga abordagem de copiar e colar tokens, não sabemos qual parceiro está acessando seus dados no momento.

Estou usando uma solução interna com interface do usuário

Você tem uma solução personalizada para a qual pode alterar a interface do usuário e adicionar o botão "Login do Facebook"? Siga o guia de integração e autenticação que está vinculado à documentação da API de Relatórios v2. Nele, você pode encontrar um link para o guia sobre a integração do Login do Facebook em qualquer plataforma (móvel, web e dispositivos).

Estou usando uma solução interna de servidor para servidor

Se você tem uma solução personalizada sem interface de front-end e a utiliza para consultar dados apenas para a sua empresa, pode seguir a abordagem de consultar os dados usando o acesso à API de Marketing.


Criar token de usuário por meio do Explorador da Graph API

  1. Acesse https://developers.facebook.com
  2. Crie um novo app
    • Crie um app de negócios e atribua-o à empresa no Audience Network que contém os dados que você deseja acessar
    • É importante atribuir o app à empresa. Não anexe o app a uma propriedade de monetização do Audience Network
  3. Se você já estiver usando a "API de Marketing" no seu app, pule esta etapa. Caso contrário, siga as instruções sobre como obter a permissão read_audience_network_insights
  4. Acesse o Explorador da Graph API
  5. Selecione seu app, insira as permissões necessárias e gere um token
    - Agora, você pode acessar os dados da API de Relatórios do Audience Network por um breve período com esse token (em vez do token do Gerenciador de Monetização)
    - Aviso legal: esse token expirará em duas horas. Você precisará transformá-lo em um token de acesso de longa duração usando o guia abaixo.

Transformar esse token em um token de acesso de longa duração

  1. Acesse o depurador de token de acesso
  2. Insira seu token e pressione "Depurar"
  3. Sob a tabela com informações do token, clique no botão "Estender token de acesso"
  4. Copie o token resultante

Agora, você pode acessar os dados da API de Relatórios do Audience Network com esse token (em vez do token do Gerenciador de Monetização).

Próximas etapas