API de Conversões

Começar

Esta página descreve o processo e os pré-requisitos para a implementação da API de Conversões. Se você é um parceiro de terceiros oferecendo funcionalidades da API de Conversões para anunciantes, há requisitos diferentes para começar.

Caso sua empresa use um firewall para solicitações externas, consulte IPs do rastreador e agentes de usuário para obter os endereços IP do Facebook. É importante lembrar que a lista de endereços é alterada com frequência.

Os eventos de loja física, app e web compartilhados usando a API de Conversões exigem parâmetros específicos. A lista de parâmetros obrigatórios está disponível aqui.

Visão geral do processo

Veja as etapas de alto nível para configurar a integração da API de Conversões:

  1. Escolher o método de integração adequado para você.
  2. Concluir os pré-requisitos necessários para o método de implementação específico.
  3. Implementar seguindo o método escolhido.
  4. Verificar a configuração e aderir às boas práticas que ajudam a melhorar o desempenho de anúncios.

Métodos de integração

Existem diferentes métodos de integração com a API de Conversões, que variam de acordo com o nível de esforço, custos e recursos. Veja este artigo para uma visão geral das opções de configuração da API de Conversões.

O principal objetivo desta documentação para desenvolvedores é criar integrações diretas.

Requisitos

Identificação do pixel

É necessário obter a identificação do Pixel para usar a API de Conversões. Se você já configurou um pixel para seu site, recomendamos que use a mesma identificação para o navegador e os eventos do servidor.

Gerenciador de Negócios

Você também precisa ter um Gerenciador de Negócios para usar a API. O Gerenciador de Negócios ajuda os anunciantes a integrar as iniciativas de marketing do Facebook com a própria empresa e parceiros externos. Se você ainda não tiver esse recurso, consulte o artigo da Central de Ajuda sobre como criar um Gerenciador de Negócios.

Token de acesso

Para usar a API de Conversões, é necessário ter um token de acesso. Há duas maneiras de obter um token de acesso:

  • Com o Gerenciador de Eventos (recomendado)
  • Com seu app

Com o Gerenciador de Eventos (recomendado)

Para usar a API de Conversões, é necessário gerar um token de acesso, que é transmitido como um parâmetro em cada chamada de API. No Gerenciador de Eventos, siga estas etapas:

Etapa 1 – Escolha o pixel que você quer implementar.

Etapa 2 – Selecione a aba Configurações.


Etapa 3 – Encontre a seção API de Conversões e clique no link Gerar token de acesso na opção Configurar manualmente. Depois, siga as instruções da mensagem pop-up:

Observação: o link Gerar token de acesso só pode ser visto por usuários com privilégios de desenvolvedor na empresa. Ele fica oculto para os outros usuários.


Depois de obter o token, clique no botão Gerenciar integrações na aba Visão geral do Gerenciador de Eventos. Na tela pop-up, clique no botão Gerenciar ao lado de API de Conversões. Isso criará automaticamente um app e um usuário do sistema da API de Conversões para você. Não é necessário passar pela análise do app nem solicitar permissões.



Com seu app

Se você já tiver um app e um usuário do sistema, será possível gerar o token no Gerenciador de Negócios. Para fazer isso, siga estas etapas:

Etapa 1 – Acesse as Configurações da empresa.

Etapa 2 – Atribua um pixel ao usuário do sistema. Outra opção é criar um novo usuário do sistema nesta etapa.

Etapa 3 – Selecione o usuário do sistema atribuído e clique em Gerar token.

Seu app não precisa passar pelo processo de análise. Não é necessário solicitar nenhuma permissão.

Os tokens gerados na aba de configurações da API de Conversões no Gerenciador de Eventos não estão mais restritos ao uso da versão mais recente da Graph API que estava disponível no momento da geração do token. A partir da versão 12.0, tokens de acesso recém-criados podem ser usados com todas as versões disponíveis da Graph API.

Recursos