Loading

Como ativar eventos para a Meta por meio do conector da API de conversões do Data Cloud

Data da publicação: Nov 5, 2025
Pré-requisitos
Note: This feature requires Ad Audience entitlements Your org must have a CDP or Data Cloud license with Ad Audience entitlements to leverage this feature. Guidance on how to confirm access, or identify missing licenses / entitlements, can be found in the FAQ Section of this document.
Tarefa

Como levar clientes em potencial da Meta para o Data Cloud

Antes de poder configurar o Data Cloud para detectar e enviar eventos de alteração de registro de cliente em potencial para a Meta, primeiro você deve estabelecer uma conexão com o sistema onde você armazena seus clientes em potencial da Meta e configurar um fluxo de dados para ingerir os dados necessários nesses objetos de cliente em potencial.

O conteúdo a seguir fornece instruções para recuperar envios instantâneos de formulário de cliente em potencial a partir da Meta e sincronizar dados de registro de cliente em potencial entre o Salesforce CRM / Marketing Engagement e o Data Cloud.

Se você já está ingerindo seus clientes em potencial da Meta no Data Cloud, você pode ignorar esta seção e prosseguir com as etapas de configuração descritas na seção intitulada: Ativação de eventos de cliente em potencial de conversão no CAPI da Meta

 

Conexão do Data Cloud a um sistema de registros não Salesforce

Se você armazenar clientes em potencial do formulário instantâneo da Meta em uma plataforma de terceiros, precisará configurar um conector a esse sistema de registro para levar os dados de cliente em potencial para o Data Cloud.

Uma lista de conectores disponíveis e mais orientação podem ser encontradas no seguinte artigo de ajuda: Data Cloud: Conectores e integrações

  • Alguns conectores de ingestão só estão acessíveis por meio de uma licença complementar paga e, consequentemente, poderão não estar acessíveis em sua organização
  • O acesso a conectores de ingestão adicionais baseados em SKU não está incluído como parte da licença do Ad Audience

 

 

Conexão do Data Cloud ao Sales Cloud e/ou Marketing Cloud

Se você armazena/gerencia seus clientes em potencial do formulário instantâneo da Meta no Sales Cloud ou Marketing Cloud, e se ainda não começou a ingerir os registros desses clientes em potencial no Data Cloud, os seguintes artigos fornecem instruções detalhadas sobre como configurar essas conexões no Data Cloud:

 

Recuperar clientes em potencial da Meta com o aplicativo Salesforce Lead Capture (opcional)

Se você não está atualmente trazendo clientes em potencial da Meta para seu sistema CRM, a Salesforce oferece um aplicativo Lead Capture para automatizar a recuperação de envios de formulários instantâneos de anúncios de cliente em potencial da Meta, e depois importá-los para o objeto de clientes em potencial do Sales Cloud e/ou Marketing Cloud.

Se você planeja aproveitar o aplicativo Salesforce para recuperar clientes em potencial da Meta, mas ainda não instalou e configurou o aplicativo, aqui estão alguns recursos para ajudar nesse processo de configuração:

Nota: se você está usando o aplicativo Lead Capture da Salesforce para importar clientes em potencial da Meta para o Sales Cloud ou Marketing Cloud, siga as etapas abaixo:

 

Etapas
  1. Criar um novo campo em seu fluxo de dados de cliente em potencial

    O aplicativo Lead Capture da Salesforce atribui um prefixo "FB-" a valores de ID de cliente em potencial externo ao importar dados de cliente em potencial da Meta. Para garantir que os valores de cliente em potencial correspondam a um usuário Meta ao enviar de volta as informações de eventos de conversão, você deve criar um novo campo de fórmula no fluxo de dados para analisar esse prefixo e gravá-lo em um novo campo personalizado, que podemos consultar ao associar essa fonte ao DMO de cliente em potencial do Data Cloud.

    Para criar um novo campo de fórmula em seu objeto do fluxo de dados de cliente em potencial:

    1. Navegue até a guia Fluxos de dados

    2. Clique no fluxo de dados do Salesforce CRM para ingestão de cliente em potencial

    3. Clique no menu suspenso na página inicial do fluxo de dados de cliente em potencial e selecione Novo campo de fórmula

      How_to_Activate_Events_to_Meta_via_the_Data_Cloud_Conversions_API_Connector_image-1 

      4. Crie um novo campo com a seguinte fórmula a de transformação de texto. SUBSTITUTE(sourceField['External_Lead_ID__c'],"FB-","")

       

      How_to_Activate_Events_to_Meta_via_the_Data_Cloud_Conversions_API_Connector_image-2.png

      5. Atribua um nome a esse novo campo do DLO e clique em Salvar

      Nota:

      Se houver campos ausentes nos fluxos de dados de cliente em potencial/oportunidade do CRM

      Se você estiver ingerindo dados de cliente em potencial do Sales Cloud/Salesforce CRM, e o fluxo de dados do Data Cloud tiver campos ausentes do registro de cliente em potencial (por ex., ID de cliente em potencial externo), provavelmente seja devido à permissão de acesso de leitura. Você pode encontrar mais informações sobre como resolver este problema na seção de perguntas frequentes deste documento.

       

      Associar seu novo campo de fórmula ao DMO de cliente em potencial do Data Cloud

      Nota: depois de ter criado seu novo campo de fórmula, certifique-se de atualizar os mapeamentos de fluxo de dados de cliente em potencial para associar esse novo campo recém-criado ao campo de ID de registro externo em seu DMO de cliente em potencial do Data Cloud.

       How_to_Activate_Events_to_Meta_via_the_Data_Cloud_Conversions_API_Connector_image-3 

      Em uma etapa posterior, quando estiver criando uma nova ativação do DMO de cliente em potencial de conversão para a CAPI (API de Conversões) da Meta, esse campo de ID de registro externo é o que você vai associar ao atributo de ID de cliente em potencial do Facebook.

       

      Conectar o Data Cloud a um pixel/conjunto de dados da Meta

      A Salesforce usa destinos de ativação para representar uma conexão 1:1 entre um espaço de dados em sua organização do Data Cloud, e uma conta do AD ou ativo em sua conta do Meta Business Suite. A API de Conversões da Meta agora está listada como um tipo de plataforma de ativação distinta, junto com públicos personalizados da Meta.

      As etapas para criar um novo destino de ativação da CAPI da Meta no Data Cloud estão descritas em mais detalhes abaixo.


      Importante: você deve ter a função/os conjuntos de permissão corretos para concluir estas etapas
       
      Para criar uma nova conexão entre o Data Cloud e seu conjunto de dados/

      ID do pixel do Meta Business Suite, um usuário deve ter ambas as funções a seguir em cada uma das respectivas plataformas:

      • ●  Data Cloud: O usuário que está criando o novo destino deve ter um Data Cloud Marketing

        Função de gerente ou administrador do Data Cloud

      • ●  Meta/Facebook: o mesmo usuário também deve ser um administrador na conta do Meta Business Suite/Business Manager que possui o ativo de ID do conjunto de dados/pixel sendo vinculado ao Data Cloud

       

       

      Criação de um destino de ativação na API de Conversões da Meta

      1. Faça log-in no Data Cloud. Navegue até a guia Destinos de ativação e clique em Novo

      How_to_Activate_Events_to_Meta_via_the_Data_Cloud_Conversions_API_Connector_image

       

      2. Desça e selecione o bloco API de Conversões da Meta

      How_to_Activate_Events_to_Meta_via_the_Data_Cloud_Conversions_API_Connector_image-4

      3. Informe um nome para o destino de ativação, uma descrição opcional e selecione um espaço de dados. Clique em Salvar.
      Depois de clicar em salvar, você será direcionado para o log-in da Meta e o fluxo de seleção de ativos.

       Activate_Events _to_Meta_1 

      4. Faça log-in na Meta ou, se já estiver conectado, clique em Continuar

      Activate_Events _to_Meta_2

      5. Clique em Avançar para conceder ao aplicativo Salesforce Data Cloud, "Parceiros estratégicos do CDP", permissão para encontrar contas do Business Suite associadas a seu log-in de usuário.

       Activate_Events _to_Meta_3 

       

      6. Selecione um portfólio de negócios e ID do pixel/conjunto de dados da Meta

      *Se você for administrador de mais de uma empresa, primeiro selecione (ou confirme) o portfólio de negócios que possui o ID do pixel ou conjunto de dados de seu interesse

      a. Clique no portfólio de negócios.

      b. Selecione a conta do portfólio de negócios que possui o pixel/conjunto de dados para o qual os eventos devem ser enviados. Clique em Avançar

      Activate_Events _to_Meta_5 

      c. Depois que um portfólio de negócios tiver sido selecionado, se o negócio possui múltiplos IDs de pixel ou conjuntos de dados, selecione o que você quer vincular a esse novo destino de ativação do Data Cloud. Depois clique em Avançar

      Activate_Events _to_Meta_6

      7. Confirme e salve o portfólio de negócios selecionado e o conjunto de dados para seu novo destino

       

      ● Depois que estiver satisfeito com suas escolhas, clique em Continuar.

      Activate_Events _to_Meta_7

       

      • ●  Clique em Avançar para conceder ao aplicativo Salesforce Data Cloud permissão para gravar dados de eventos no conjunto de dados selecionado.

      Activate_Events _to_Meta_8  

      • ●  Clique em Concluído

      Activate_Events _to_Meta_9

      1. Depois de clicar em Concluído, você será redirecionado para a página inicial do novo destino de ativação no Salesforce Data Cloud.

       

      Etapa seguinte: Criar uma ativação do DMO para ativar dados de alteração de cliente em potencial

      Depois que tiver concluído o trabalho de conectar e ingerir registros de cliente em potencial do sistema de origem, você pode continuar com a configuração de sua instância do Data Cloud para começar a enviar eventos de alteração de registro de cliente em potencial para a CAPI da Meta.

       

      Ativação de alterações de cliente em potencial para seu destino da API de Conversões da Meta

       

      1. Navegue para a guia Ativação e clique em Novo

      Screenshot 2024-12-10 at 6.58.44 PM.png

      2. Selecione Objeto do Modelo de Dados (DMO) e clique em Novo

      Screenshot 2024-12-10 at 6.58.53 PM.png

       

      3. Defina as seguintes propriedades por meio da seleção da lista de opções e depois clique em Avançar:

      a. Espaço de dados
      b. O DMO onde seus clientes em potencial Meta estão armazenados no Data Cloud 
      c. O destino de ativação da CAPI vinculado ao seu ID do pixel/conjunto de dados
      d. (opcional) Um objeto do gráfico de dados

      How_to_Activate_Events_to_Meta_via_the_Data_Cloud_Conversions_API_Connector_image-6

      4. Selecione o tipo e a origem dos eventos que você quer ativar

      a. Selecione o bloco Evento padrão
      b. Selecione o evento padrão: "CRM - Eventos de alteração de registro de cliente em potencial"
      c. Selecione a origem da ação: "system_generated
      d. Clique em "Avançar:

      How_to_Activate_Events_to_Meta_via_the_Data_Cloud_Conversions_API_Connector_image-7

      5. Mapeie os seguintes atributos e clique em Avançar:
      a. Obrigatório:
          i. Status/Estágio do cliente em potencial ou oportunidade → event_name
      b. Pelo menos uma dos seguintes identificadores de usuário:
          i. ID para clique do Facebook → fbc
          ii. Endereço de e-mail → em
          iii. Número de telefone E164 → ph
          iv. ID de cliente em potencial do Facebook → lead_id

      How_to_Activate_Events_to_Meta_via_the_Data_Cloud_Conversions_API_Connector_image-8 

      *Opcional: você pode atribuir mapeamentos a qualquer dos atributos listados nas outras seções se quiser que eles sejam incluídos nos eventos enviados à CAPI da Meta

      6. Revise os atributos selecionados e mapeados.

      a. Opcional - clique em Adicionar filtros para criar regras de filtro de inclusão ou exclusão para controlar quais eventos são finalmente enviados
      b. Ou clique em Avançar para concluir esta configuração.

      How_to_Activate_Events_to_Meta_via_the_Data_Cloud_Conversions_API_Connector_image-9 

      1. Atribuições de regra de filtro opcionais: defina a lógica das regras para determinar quais eventos de alteração de cliente em potencial devem ser finalmente enviadas à CAPI da Meta. Depois de concluído, clique em Salvar.

      How_to_Activate_Events_to_Meta_via_the_Data_Cloud_Conversions_API_Connector_image-10

       

      8. Atribua um nome, uma descrição e uma data de início/término para a ativação de seu evento de alteração de cliente em potencial e clique em Salvar

       How_to_Activate_Events_to_Meta_via_the_Data_Cloud_Conversions_API_Connector_image-11 

      Depois de clicar em Salvar, você será direcionado à página inicial de registro da ativação de DMO recém-criada.
      Você poderá monitorar o volume de eventos enviados e seu status a partir dessa página, bem como confirmar volumes de eventos aceitos a partir de seu painel do gerenciador de eventos na Meta.

      How_to_Activate_Events_to_Meta_via_the_Data_Cloud_Conversions_API_Connector_image-12

      **Nota: se você selecionou a data de hoje como data de início, aguarde até uma hora para que o sistema comece a qualificar e ativar eventos.

       

      Perguntas frequentes sobre clientes em potencial de conversão da CAPI da Meta

      Meu fluxo de dados de cliente em potencial do CRM no Data Cloud tem campos ausentes

      Exemplo: o ID de cliente em potencial externo não está listado como um atributo no fluxo de dados de cliente em potencial do CRM

      Os objetos e atributos do Salesforce CRM devem ter permissões Exibir tudo e Leitura para que o Data Cloud identifique e ingira essas informações.

      O aplicativo Salesforce Lead Capture armazena IDs de cliente em potencial do formulário instantâneo da Meta no campo de ID de cliente em potencial externo nos registros de cliente em potencial do CRM. Esse campo às vezes carece das permissões Exibir tudo e Leitura exigidas pelo Data Cloud.

      Se esse campo, ou qualquer outro campo importante, estiver ausente de um fluxo de dados do Salesforce CRM, trabalhe com seu administrador do Salesforce CRM para verificar e atualizar quaisquer permissões ausentes.

      Para obter orientação sobre como atualizar as permissões de campo/objeto, consulte os seguintes artigos de ajuda:

       

       

Número do artigo do Knowledge

003960741

 
Carregando
Salesforce Help | Article