Pular para o conteúdo principal

Como podemos ajudar você?

Você comprou via Digistore24

Facebook Conversion API

Este artigo foi traduzido usando IA

Tem feedback sobre esta tradução? Avise-nos aqui!

A API de Conversão do Facebook é uma ferramenta de rastreamento de conversões do lado do servidor. Permite que você, como um vendor/associado, rastreie suas campanhas de anúncios do Facebook de maneira confiável, permanecendo independente dos navegadores e dispositivos dos compradores. Com o rastreamento da API, a Digistore24 coleta informações estatísticas sobre os seguintes eventos e os encaminha para o Facebook:

  • Novo pedido
  • Início de uma assinatura
  • Pagamentos por uma assinatura
  • Fim de uma assinatura
Nota
Para configurar a API de Conversão, você precisará de uma Conta Comercial do Facebook. 

1. Configurar a API de Conversão do Facebook

a) No Facebook

  1. Configurar um Meta Tracking Pixel.
  2. Gerar uma chave de acesso para este pixel. Usar o método "via Events Manager".
  3. Opcional para testar eventos: Vá para "Test Events" no Events Manager e copie o código de teste para testes.

Após concluir estas três etapas, você deve ter o seguinte:

  • Chave de acesso à API do Facebook
  • ID do Pixel do Facebook
  • Código do evento de teste

Agora insira o pixel de rastreamento do Facebook em seu site.

b) No Digistore24

Aqui você configura duas coisas:

  • Pixel de rastreamento do Facebook no formulário de pedido
  • Conexão IPN do Facebook

2. Configurar o pixel de rastreamento do Facebook:

Como um vendor: Crie um pixel de rastreamento do Facebook em: Configurações > Rastreamento do formulário de pedido.

Siga os passos descritos aqui.

Nota:

  • Selecionar o Facebook como o tipo de rastreamento.
  • Insira o ID do Pixel do Facebook no campo.

Como um associado: Crie um pixel de rastreamento do Facebook em: Conta > Rastreamento do formulário de pedido.

Siga os passos descritos aqui a partir do passo 2.

Configurar conexão IPN do Facebook:

Como um vendor: Crie uma conexão IPN do Facebook em: Configurações > Integrações (IPN).

Siga os passos descritos aqui.

Dica:

Selecione os produtos e idiomas para os quais um evento deve ser enviado ao Facebook. Em seguida, insira a "chave de acesso da API", "ID do Pixel" e "código do evento de teste".

Se você estiver usando uma página de agradecimento do Digistore24, sua configuração está agora completa. Se você estiver usando sua própria página de agradecimento, continue com a próxima seção.

Como um associado: Crie uma conexão IPN do Facebook em: Conta > S2S Postback.

Siga os passos descritos aqui.

3. Opcional: Configurar o pixel de rastreamento na sua própria página de agradecimento

Se você estiver usando sua própria página de agradecimento, poderá rastrear pedidos lá também. Siga estas etapas:

  • Ativar a transferência de todos os IDs de pedidos para sua página de agradecimento
    É importante que todos os IDs de pedidos sejam transferidos para sua página de agradecimento para garantir que vendas já registradas não sejam contadas duas vezes.
  • Adicionar o pixel de rastreamento do Facebook à sua página de agradecimento.
    Você pode encontrá-lo no guia do Facebook. Veja o link.
  • Em seguida, adicione a seção de código mencionada abaixo.
    Insira-a abaixo do pixel de rastreamento do Facebook. Veja o link.

Aqui está como proceder:

Passo 1: Transferir todos os IDs de pedidos para sua página de agradecimento

  • Ative a transferência de todos os dados do pedido, conforme descrito aqui.
  • Ou anexe a URL da página de agradecimento com ?order_id=[ORDER_ID], conforme descrito aqui.

Passo 2: Adicionar o pixel de rastreamento do Facebook & seção de código

  • Adicionar o pixel de rastreamento à sua página de agradecimento. Você pode encontrá-lo neste guia do Facebook em "Adicionar manualmente o código do Pixel ao site." Um guia passo a passo também está disponível lá.
  • Em seguida, adicione a seguinte seção de código abaixo do pixel de rastreamento:
<!-- Insira isso abaixo do Pixel do Facebook -->
<script>
  (function () {
    function getParameterByName(name, url) {
      url = url || window.location.href;
      name = name.replace(/[\[\]]/g, "\\$&");
      var regex = new RegExp("[?&]" + name + "(=([^&#]*)|&|#|$)"),
        results = regex.exec(url);
      if (!results) return null;
      if (!results[2]) return "";
      return decodeURIComponent(results[2].replace(/\+/g, " "));
    }
    var order_id = getParameterByName("order_id");
    var queryParamToFacebookMapping = {
      product_id: "content_ids",
      product_name: "content_name ",
      currency: "currency",
      amount: "value",
      quantity: "num_items"
    };
    var purchaseData = { content_type: 'product' };
    Object.keys(queryParamToFacebookMapping).forEach(function (name) {
      var value = getParameterByName(name);
      if (value !== null) {
        purchaseData[queryParamToFacebookMapping[name]] = value;
      }
    });
    fbq('track', 'Purchase', purchaseData, {eventID: 'purchase.'+order_id});  })();
</script>

4. Como trabalhar com eventos no Facebook

No Facebook, agora você pode criar conversões personalizadas e, idealmente, filtrar seu produto pelo ID do conteúdo.

1639396769880-NLo.png

5. Como testar seu evento

  1. No Events Manager, selecione a fonte de dados que você configurou.
  2. Clique em "Test Events".
  3. Agora abra o formulário de pedido do produto que você configurou.

Se seu evento estiver configurado corretamente, você receberá informações sobre seus eventos (veja a captura de tela).

1643626858913-VII.png

Nota
Se o teste não funcionar, verifique se o EventCode no Facebook corresponde ao EventCode da sua conexão IPN. 

6. Transferindo parâmetros com uma conexão IPN

Com a conexão IPN do Facebook, esses parâmetros do Facebook podem ser transferidos. Como um vendor, você pode usá-los para visualizar métricas como ROAS (Retorno sobre o Investimento em Anúncios - despesas vs. receita) e, assim, controlar melhor as medidas publicitárias. Outros parâmetros do DS24 também podem ser transferidos, como content_type. Transferimos este parâmetro para todos os eventos com IDs de produtos. Isso ajuda o Facebook a reconhecer que essas são compras reais. Para transferir esses e outros parâmetros, siga estas etapas:

  1. Configurar seu pixel no Facebook Business Manager de acordo com este guia.
  2. Configurar a API de conversão no pixel:
    1. Abra o Gerenciador de Eventos.
    2. Vá para Fontes de Dados.
    3. Selecione o pixel e vá para a guia Configurações.
    4. Em API de Conversão, vá para o campo Configurar manualmente.
  3. Configurar a API:
    1. O evento Compra deve estar presente.
    2. Visualização de Página também pode ser usada para rastrear visualizações de página.
    3. Categoria Comércio eletrônico e Varejo.
    4. Na próxima etapa, selecione todos os parâmetros que devem ser transferidos. O país não pode ser transferido.
    5. Na etapa final, selecione "Implementar API manualmente".
  4. Uma nova seção será aberta: Aplicar a API de Conversão. Gere uma chave de acesso aqui, que será necessária para o IPN do Facebook do Digistore24. Uma vez gerada, copie a chave e selecione Concluir Implementação.
  5. Complete a configuração da API e clique em Concluir na seção de instruções.
  6. Agora mude para Digistore24. a) Vá para Configurações > Integrações (IPN) > Adicionar nova conexão. b) Em "Para Profissionais", selecione Facebook.
  7. Insira as configurações (para quais produtos e idiomas).
  8. Insira a chave da API gerada no passo 4 e também insira o ID do Pixel.
  9. Vá para Configurações > Rastreamento do formulário de pedido.
    1. Abra novo rastreamento > Selecione os produtos desejados.
    2. Escolha onde inserir o rastreamento > Selecione eventos > Escolha Facebook como o tipo de rastreamento.
    3. Insira o ID do Pixel e clique em Salvar.

Os parâmetros agora serão transferidos para o Facebook e podem ser visualizados na visão geral do Pixel.