Visão geral da extensão do Meta Conversions API

O Meta Conversions API permite conectar seus dados de marketing do lado do servidor às tecnologias do Meta para otimizar o direcionamento de seus anúncios, reduzir o custo por ação e medir os resultados. Eventos estão vinculados a uma ID do Meta Pixel e são processados de maneira semelhante aos eventos do lado do cliente.

Usando a extensão Meta Conversions API, você pode aproveitar os recursos da API em suas regras encaminhamento de eventos para enviar dados para Meta do Edge Network Adobe Experience Platform. Este documento aborda como instalar a extensão e usar seus recursos em uma regra de encaminhamento de eventos.

Demonstração

O vídeo a seguir tem como objetivo ajudá-lo a entender o Meta Conversions API.

Pré-requisitos

É altamente recomendável usar Meta Pixel e Conversions API para compartilhar e enviar os mesmos eventos do lado do cliente e do lado do servidor, respectivamente, pois isso pode ajudar a recuperar eventos que não foram selecionados por Meta Pixel. Antes de instalar a extensão Conversions API, consulte o guia na Meta Pixel extensão para obter etapas sobre como integrá-la nas implementações de tags do lado do cliente.

NOTE
A seção sobre desduplicação de eventos, apresentada posteriormente neste documento, aborda as etapas para garantir que o mesmo evento não seja usado duas vezes, pois pode ser recebido do navegador e do servidor.

Para usar a extensão Conversions API, você deve ter acesso ao encaminhamento de eventos e ter uma conta Meta válida com acesso a Ad Manager e Event Manager. Especificamente, você deve copiar a ID de um Meta Pixel existente (ou criar um novo Pixel) para que a extensão possa ser configurada para sua conta.

INFO
Se você estiver planejando usar esta extensão com dados de aplicativo móvel ou se também trabalhar com dados de evento offline em suas campanhas do Meta, será necessário criar seu conjunto de dados por meio de um aplicativo existente e selecionar Criar a partir de uma ID de pixel quando solicitado. Consulte o artigo Decida qual opção de criação de conjunto de dados é adequada para sua empresa para obter detalhes. Consulte o documento API de Conversões para Eventos de Aplicativo para obter todos os parâmetros de rastreamento de aplicativo obrigatórios e opcionais.

Instalar a extensão

Para instalar a extensão Meta Conversions API, navegue até a interface da Coleção de dados ou a interface do Experience Platform e selecione Encaminhamento de eventos na navegação à esquerda. Aqui, selecione uma propriedade à qual adicionar a extensão ou crie uma nova propriedade.

Depois de selecionar ou criar a propriedade desejada, selecione Extensões na navegação à esquerda e selecione a guia Catálogo. Procure o cartão APIs de MetaConversões e selecione Instalar.

A opção Instalar está sendo selecionada para a extensão API de Metaconversões na interface da Coleção de Dados.

Na exibição de configuração exibida, você deve fornecer a ID do Pixel copiada anteriormente para vincular a extensão à sua conta. Você pode colar a ID diretamente na entrada ou usar um elemento de dados.

Você também precisa fornecer um token de acesso para usar o Conversions API especificamente. Consulte a documentação Conversions API em gerando um token de acesso para obter etapas sobre como obter esse valor.

Quando terminar, selecione Salvar

A ID Pixel fornecida como um elemento de dados na exibição de configuração de extensão.

A extensão é instalada e agora você pode empregar seus recursos nas regras de encaminhamento de eventos.

Integração com a extensão do Facebook e do Instagram facebook

A integração usando a extensão Facebook e Instagram permite que você se autentique rapidamente em sua conta Meta Business. Em seguida, o Pixel ID e o Token de acesso da API de metaconversões são preenchidos automaticamente, facilitando a instalação e a configuração da API de metaconversões.

Um prompt de caixa de diálogo para autenticar no Facebook e no Instagram é exibido ao instalar a extensão API de Meta Conversões.

A Extensão da API de Meta Conversões destacando a página de instalação Conectar-se a Meta.

Um prompt da caixa de diálogo para autenticar no Facebook e no Instagram também é exibido na interface do fluxo de trabalho de início rápido no encaminhamento de eventos.

A interface de início rápido do fluxo de trabalho destacando Conectar-se a Meta.

Integração com a Pontuação de correspondência de qualidade do evento (EMQ) emq

A integração com a Pontuação de correspondência de qualidade do evento (EMQ) permite visualizar facilmente a eficácia da implementação ao mostrar pontuações da EMQ. Essa integração minimiza a alternância de contexto e ajuda a melhorar o sucesso das implementações da API de Meta Conversões. Essas pontuações de eventos aparecem na tela de configuração da Extensão de API de metaconversões.

A Extensão da API de Metaconversões destacando a página de configuração Exibir Pontuação EMQ.

Integração com o LiveRamp (Alpha) alpha

LiveRamp clientes que têm a solução de tráfego autenticado (ATS) do LiveRamp implantada em seus sites podem optar por compartilhar RampIDs como um parâmetro de informações do cliente. Trabalhe com a equipe de conta do Meta para participar do programa Alpha para este recurso.

A página de configuração da Regra do encaminhamento de Metaeventos, destacando Nome do Parceiro (alfa) e ID do Parceiro (alfa).

Configurar uma regra de encaminhamento de eventos rule

Esta seção aborda como usar a extensão Conversions API em uma regra de encaminhamento de eventos genérica. Na prática, você deve configurar várias regras para enviar todos os eventos padrão aceitos via Meta Pixel e Conversions API. Para dados de aplicativos móveis, consulte os campos obrigatórios, os campos de dados de aplicativos, os parâmetros de informações do cliente e os detalhes de dados personalizados aqui.

NOTE
Os eventos devem ser enviados em tempo real ou o mais próximo possível do tempo real para uma melhor otimização da campanha publicitária.

Comece a criar uma nova regra de encaminhamento de eventos e configure as condições conforme desejado. Ao selecionar as ações para a regra, selecione Extensão da API de Metaconversões para a extensão e selecione Enviar evento da API de conversões para o tipo de ação.

O tipo de ação Enviar Exibição de Página que está sendo selecionado para uma regra na Interface da Coleção de Dados.

São exibidos controles que permitem configurar os dados do evento que serão enviados para Meta por meio de Conversions API. Essas opções podem ser inseridas diretamente nas entradas fornecidas ou você pode selecionar elementos de dados existentes para representar os valores. As opções de configuração são divididas em quatro seções principais, conforme descrito abaixo.

Seção de configuração
Descrição
Parâmetros de Evento do Servidor
Informações gerais sobre o evento, incluindo o momento em que ocorreu e a ação de origem que o acionou. Consulte a documentação do desenvolvedor Meta para obter mais informações sobre os parâmetros de evento padrão aceitos pelo Conversions API.

Se você estiver usando Meta Pixel e Conversions API para enviar eventos, certifique-se de incluir um Nome do Evento (event_name) e uma ID do Evento (event_id) com cada evento, uma vez que esses valores são usados para a eliminação de duplicação de eventos.

Você também tem a opção de Habilitar o Uso Limitado de Dados para ajudar a estar em conformidade com as opções de não participação do cliente. Consulte a documentação Conversions API em opções de processamento de dados para obter detalhes sobre este recurso.
Parâmetros de informações do cliente
Dados de identidade do usuário usados para atribuir o evento a um cliente. Alguns desses valores devem ser transformados em hash antes de serem enviados para a API.

Para garantir uma boa conexão de API comum e uma alta qualidade de correspondência de eventos (EMQ), é recomendável enviar todos os parâmetros de informações de clientes aceitos juntamente com eventos de servidor. Esses parâmetros também devem ser priorizados com base em sua importância e impacto no EMQ.
Dados personalizados
Dados adicionais a serem usados para otimização de entrega de anúncios, fornecidos no formato de um objeto JSON. Consulte a Conversions API documentação para obter mais informações sobre as propriedades aceitas para este objeto.

Se estiver enviando um evento de compra, você deve usar esta seção para fornecer os atributos necessários currency e value.
Evento de teste
Esta opção é usada para verificar se sua configuração está fazendo com que os eventos de servidor sejam recebidos por Meta conforme esperado. Para usar este recurso, marque a caixa de seleção Enviar como Evento de Teste e forneça um código de evento de teste de sua escolha na entrada abaixo. Depois que a regra de encaminhamento de eventos for implantada, se você tiver configurado a extensão e a ação corretamente, deverá ver as atividades que aparecem na exibição Test Events em Meta Events Manager.

Quando terminar, selecione Manter alterações para adicionar a ação à configuração de regra.

Manter alterações sendo selecionadas para a configuração da ação.

Quando estiver satisfeito com a regra, selecione Salvar na biblioteca. Finalmente, publique um novo encaminhamento de eventos build para habilitar as alterações feitas na biblioteca.

Desduplicação de eventos deduplication

Conforme mencionado na seção de pré-requisitos, é recomendável usar a extensão de tag Meta Pixel e a extensão de encaminhamento de eventos Conversions API para enviar os mesmos eventos do cliente e do servidor em uma configuração redundante. Isso pode ajudar a recuperar eventos que não foram coletados por uma extensão ou outra.

Se você estiver enviando tipos de evento diferentes do cliente e do servidor sem sobreposição entre os dois, a desduplicação não será necessária. No entanto, se qualquer evento for compartilhado por Meta Pixel e Conversions API, você deve garantir que esses eventos redundantes sejam desduplicados para que seus relatórios não sejam afetados negativamente.

Ao enviar eventos compartilhados, verifique se você está incluindo uma ID e um nome de evento em cada evento enviado do cliente e do servidor. Quando vários eventos com a mesma ID e o mesmo nome são recebidos, o Meta emprega automaticamente várias estratégias para desduplicá-los e manter os dados mais relevantes. Consulte a documentação do Meta sobre a desduplicação para Meta Pixel e Conversions API eventos para obter detalhes sobre esse processo.

Fluxo de trabalho de início rápido: Extensão da API de meta conversões (Beta) quick-start

IMPORTANT
  • O recurso de início rápido está disponível para clientes que compraram o pacote Real-Time CDP Prime e Ultimate. Entre em contato com o representante da Adobe para obter mais informações.
  • Esse recurso é para novas implementações e atualmente não é compatível com a instalação automática de extensões e configurações em tags existentes e propriedades de encaminhamento de eventos.
NOTE
Qualquer cliente existente pode usar os workflows de início rápido para criar uma implementação de referência que pode ser usada para o seguinte:
  • Use-a como o início de uma implementação totalmente nova.
  • Aproveite-a como uma implementação de referência que pode ser examinada para ver como ela foi configurada e replicar em suas implementações de produção atuais.

O recurso de início rápido ajuda a configurar com facilidade e eficiência a API de Meta Conversões e as extensões Meta Pixel. Essa ferramenta automatiza várias etapas executadas em tags de Adobe e no encaminhamento de eventos, reduzindo significativamente o tempo de configuração.

Esse recurso instala e configura automaticamente a API de metaconversões e as extensões de metapixels em uma propriedade de tags recém-gerada automaticamente e encaminhamento de eventos com as regras e os elementos de dados necessários. Além disso, ele também instala e configura automaticamente o SDK da Web do Experience Platform e o Datastream. Por fim, o recurso de início rápido publica automaticamente a biblioteca no URL designado em um ambiente de desenvolvimento, o que permite a coleta de dados do lado do cliente e o encaminhamento de eventos do lado do servidor em tempo real por meio do encaminhamento de eventos e do Edge Network Experience Platform.

O vídeo a seguir fornece uma introdução ao recurso de início rápido.

Instalar o recurso de início rápido

NOTE
Esse recurso foi projetado para ajudar você a começar a implementar o encaminhamento de eventos. Ele não fornecerá uma implementação completa e totalmente funcional que acomode todos os casos de uso.

Esta configuração instala automaticamente as extensões Meta Conversions API e Meta Pixel. Essa implementação híbrida é recomendada pelo Meta para coletar e encaminhar conversões de eventos no lado do servidor.
O recurso de configuração rápida foi projetado para ajudar os clientes a começar a usar uma implementação de encaminhamento de eventos, e não tem como objetivo fornecer uma implementação completa e totalmente funcional que acomode todos os casos de uso.

Para instalar o recurso, selecione Introdução para Send Conversions Data to Meta na página Página inicial da Coleção de dados da Adobe Experience Platform.

Página inicial da coleção de dados mostrando dados de conversões para meta

Insira seu Domínio e selecione Próximo. Esse domínio será usado como uma convenção de nomenclatura para suas propriedades geradas automaticamente de Tags e Encaminhamento de eventos, regras, elementos de dados, sequências de dados e assim por diante.

Tela de boas-vindas solicitando o nome de domínio

Na caixa de diálogo Configuração Inicial, insira o ID de Meta Pixel, o Token de Acesso da API de Meta Conversão e o Caminho da Camada de Dados e selecione Avançar.

Caixa de diálogo de configuração inicial

Aguarde alguns minutos para que o processo de instalação inicial seja concluído e selecione Avançar.

Tela de confirmação de conclusão da instalação inicial

Na caixa de diálogo Adicionar código ao seu site, copie o código fornecido usando a função de cópia Copiar e cole-o no <head> do site de origem. Depois de implementado, selecione Iniciar Validação

Adicionar código na caixa de diálogo do site

A caixa de diálogo Resultados da Validação exibe os resultados da implementação da Extensão Meta. Selecione Próximo. Você também pode ver resultados de validação adicionais selecionando o link Garantia.

Caixa de diálogo de resultados de teste exibindo resultados da implementação

A exibição da tela Próximas Etapas confirma a conclusão da instalação. Aqui, você tem a opção de otimizar sua implementação adicionando novos eventos, que são mostrados na próxima seção.

Se não quiser adicionar mais eventos, selecione Fechar.

Caixa de diálogo Próximas etapas

Adição de eventos adicionais

Para adicionar novos eventos, selecione Editar Propriedade da Web de Marcas.

Caixa de diálogo de próximas etapas mostrando como editar a propriedade da Web de suas marcas

Selecione a regra que corresponde ao metaevento que você deseja editar. Por exemplo, MetaConversion_AddToCart.

NOTE
Se não houver nenhum evento, essa regra não será executada. Isso é verdadeiro para todas as regras, com a regra MetaConversion_PageView sendo a exceção.

Para adicionar um evento, selecione Adicionar sob o cabeçalho Eventos.

A página de propriedades da marca não mostra eventos

Selecione o Tipo de Evento. Neste exemplo, selecionamos o evento Clique e o configuramos para disparar quando o .botão adicionar ao carrinho estiver selecionado. Selecione Manter alterações.

Tela de configuração de evento mostrando o evento de clique

O novo evento foi salvo. Selecione Selecionar uma biblioteca de trabalho e selecione a biblioteca para a qual você deseja compilar.

Selecione uma lista suspensa de biblioteca de trabalho

Em seguida, selecione a lista suspensa ao lado de Salvar na biblioteca e selecione Salvar na biblioteca e na build. Isso publicará a alteração na biblioteca.

Selecione Salvar na biblioteca e compilar

Repita essas etapas para qualquer outro evento de meta conversão que deseje configurar.

Configuração da camada de dados configuration

IMPORTANT
A maneira como você atualiza essa camada de dados global depende da arquitetura do site. Um aplicativo de página única será diferente de um aplicativo de renderização do lado do servidor. Também há a possibilidade de que você seja totalmente responsável pela criação e atualização desses dados dentro do produto de Tags. Em todas as instâncias, a camada de dados precisará ser atualizada entre a execução de cada MetaConversion_* rules. Se você não atualizar os dados entre regras, também poderá se deparar com um caso em que esteja enviando dados obsoletos do último MetaConversion_* rule no MetaConversion_* rule atual.

Durante a configuração, você foi perguntado onde está a camada de dados. Por padrão, seria window.dataLayer.meta e, dentro do objeto meta, seus dados seriam esperados, como mostrado abaixo.

Metainformações da camada de dados

É importante entender isso, pois cada regra MetaConversion_* usa essa estrutura de dados para transmitir os dados relevantes à extensão Meta Pixel e ao Meta Conversions API. Consulte a documentação em eventos padrão para obter mais informações sobre quais dados são necessários para os diferentes metaeventos.

Por exemplo, se você quiser usar a regra MetaConversion_Subscribe, será necessário atualizar window.dataLayer.meta.currency, window.dataLayer.meta.predicted_ltv e window.dataLayer.meta.value de acordo com as propriedades de objeto descritas na documentação em eventos padrão.

Veja abaixo um exemplo do que precisaria ser executado em um site para atualizar a camada de dados antes da execução da regra.

Atualizar informações meta da camada de dados

Por padrão, o <datalayerpath>.conversionData.eventId será gerado aleatoriamente pela ação "Gerar nova ID de evento" em qualquer um dos MetaConversion_* rules.

Para obter uma referência local de como a camada de dados deve ser exibida, você pode abrir o editor de código personalizado no elemento de dados MetaConversion_DataLayer na propriedade.

Próximas etapas

Este guia abordou como enviar dados de eventos do lado do servidor para o Meta usando a extensão Meta Conversions API. A partir daqui, é recomendável expandir sua integração conectando mais Pixels e compartilhando mais eventos, quando aplicável. Siga qualquer um dos procedimentos a seguir para melhorar ainda mais o desempenho dos seus anúncios:

  • Conecte qualquer outro Pixels que ainda não esteja conectado a uma integração Conversions API.
  • Se você estiver enviando determinados eventos exclusivamente por meio do Meta Pixel no lado do cliente, envie esses mesmos eventos para o Conversions API também no lado do servidor.

Consulte a documentação do Meta sobre práticas recomendadas para o Conversions API para obter mais orientações sobre como implementar efetivamente sua integração. Para obter mais informações sobre tags e encaminhamento de eventos no Adobe Experience Cloud, consulte a visão geral das tags.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743