Este documento foi atualizado.
A tradução para Português (Brasil) não foi concluída ainda.
Atualização em inglês: 30 de abr

Conversions API Gateway – Guia de configuração

Siga estas etapas para configurar o Conversions API Gateway.

Antes de iniciar este guia, analise e conclua os pré-requisitos para o Conversions API Gateway.

Etapa 1: primeiros passos para iniciar a implantação

Para começar o processo de configuração, navegue até a aba Configurações no Gerenciador de Eventos da Meta. Em "Configurar com o Conversions API Gateway", clique em Começar.



  • Analise os pré-requisitos do Conversions API Gateway e selecione Avançar.

Selecionar preferências

  • Escolha as configurações que você deseja habilitar e clique em Continuar.

    • Aprimorar os eventos pode ajudar a melhorar a atribuição da conversão e maximizar os benefícios de desempenho de eventos que você atualmente compartilha com a Meta.
    • O monitoramento de integridade do Conversions API Gateway permite à Meta solucionar possíveis problemas com mais eficiência.


  • Depois, selecione a região em Selecionar a região de hospedagem. Só é possível configurar o Conversions API Gateway em uma região.
  • Clique em Avançar para abrir a Amazon Web Services (AWS) ou clique em Copiar URL para enviá-la ao administrador da conta da AWS na sua organização.

Etapa 2: configurar a AWS e instalar

Entre na AWS, caso ainda não tenha feito isso.

  • Um fluxo de criação rápida para a pilha do Conversions API Gateway será aberto.

  • Todos os campos serão preenchidos automaticamente. Não altere o campo ProvisioningData.
  • Clique em Criar pilha para começar a instalação.
  • O processo de criação demora cerca de 30 a 40 minutos. Depois disso, três saídas serão escritas na aba "Saídas" da nova instância da AWS. Você saberá que ele foi concluído quando o Status mostrar "CREATE_COMPLETE" na aba de informações da pilha.
  • Depois de concluído, acesse a aba Saídas.
  • Crie um domínio personalizado para ajudar no roteamento de dados (recomendado). Consulte a etapa 4 abaixo.
  • Anote a CapigSetupURL. Você precisará dela para provisionar a interface do usuário do Conversions API Gateway.

Etapa 3: verificar a coleta de dados

Para acessar a interface do usuário administrador do Conversions API Gateway, use a CapigSetupURL da aba Saídas. Consulte a etapa 2. A CapigSetupURL também está disponível no Gerenciador de Eventos da Meta.

  • Você precisará criar uma conta de administrador quando entrar pela primeira vez na interface do usuário administrador.
  • Selecione Entrar após criar uma conta de administrador.
  • Você verá o site de interface do usuário administrador do Conversions API Gateway.
  • Ao visualizar o site pela primeira vez, os dados do servidor e do navegador talvez apareçam como 0. O preenchimento dessas informações pode demorar de 5 minutos a 2 horas.
  • Para verificar se os dados estão sendo coletados, acesse seu site e atualize a página.
  • Caso os eventos não sejam preenchidos depois de 2 horas, entre em contato com a Meta.
  • Você verá o Conversions API Gateway nas configurações do pixel.

Etapa 4: adicionar um domínio personalizado (recomendado)

Configure um domínio personalizado na interface do usuário administrador do Conversions API Gateway. Recomenda-se usar um domínio personalizado, já que ele ajuda a otimizar o roteamento de dados e pode reduzir os custos.

Observação: você precisará acessar seu fornecedor de DNS para adicionar um domínio personalizado.

  • Entre na interface do usuário administrador do Conversions API Gateway.
  • Acesse Gerenciamento de domínios na barra lateral esquerda em Configurações.
  • Escolha entre o provedor de DNS AWS Certificate Manager (ACM) ou Cloudflare.

1. AWS Certificate Manager

Siga as instruções para concluir a configuração do ACM.

2. Cloudflare

Siga as instruções de configuração do Cloudflare para finalizar o processo.

Solucionar problemas de configuração

Siga estas etapas para solucionar problemas durante a configuração do Conversions API Gateway. Para solucionar problemas gerais, consulte Conversions API Gateway - Troubleshooting Errors and Warnings.

Interferência do preenchimento automático do navegador na configuração

Se você não conseguir instalar o Conversions API Gateway por causa de dados de provisionamento expirados, mesmo que tenha iniciado a instalação no Gerenciador de Eventos, talvez o recurso de preenchimento automático esteja usando informações anteriores.

Diagnóstico

  1. Inicie a instalação por meio do Gerenciador de Eventos e salve os dados de provisionamento para analisar mais tarde.
  2. Clique em Copiar URL e salve isso em um editor de texto (como o Bloco de notas).
  3. Clique em Iniciar implantação para abrir a página de criação da AWS.
  4. Na página de criação da AWS, encontre ProvisioningData e verifique se a entrada corresponde à URL copiada anteriormente. Se não houver correspondência, isso significa que o preenchimento automático está ativado e precisa ser desativado.

Resolução

No navegador Firefox, siga estas etapas:

  1. Clique no ícone de menu do Firefox (as três barras no canto superior direito da tela).
  2. Clique em Configurações.
  3. Selecione as configurações de Privacidade e segurança.
  4. Role a tela até Histórico. Em O Firefox irá, escolha Usar minhas configurações.
  5. Desmarque Memorizar histórico de pesquisa e formulários.
  6. As alterações serão salvas automaticamente.

No navegador Chrome, siga estas etapas:

  1. Clique no ícone de menu do Chrome (os três pontos no canto superior direito da tela).
  2. Clique em Configurações.
  3. Selecione as configurações de Preenchimento automático.
  4. Expanda a área apropriada.
  5. Desative a configuração de preenchimento automático.
  6. As alterações serão salvas automaticamente.

Configurações adicionais

O Gerenciador de Eventos da Meta permite que você inclua novas conexões, configure outros domínios e adicione novos pixels à sua conexão do Conversions API Gateway. Para isso, siga as etapas abaixo:

Clique em Integrações de parceiros, que aparece no lado esquerdo da página:



Selecione Conversions API Gateway para abri-lo.



Na tela, é possível ver o seguinte:

  • Eventos do site
    1. Os eventos são ações no site configuradas no Conversions API Gateway e enviadas ao Facebook separadamente por meio do Pixel da Meta.
  • Domínios do site
    1. Os sites com os quais o Conversions API Gateway está configurado para se conectar por meio do Pixel.


Clique em Configurações e selecione a ação desejada.

Adicionar outra conexão do Conversions API Gateway

Isso permite que você configure uma nova instância do Conversions API Gateway com outro Pixel da Meta. Veja abaixo a primeira etapa no diálogo, similar àquela da página de configurações do Pixel da Meta. Depois, você precisará selecionar um Pixel da Meta para a instalação da conexão do seu novo Conversions API Gateway.

Adicionar outro Pixel da Meta a uma conexão existente do Conversions API Gateway

Essa opção permite que você integre outro Pixel da Meta a uma instalação existente do Conversions API Gateway.

Para começar o processo de configuração, navegue até a aba Configurações no Gerenciador de Eventos da Meta. Na seção "Conversions API Gateways existentes", clique no botão Conectar: