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 de encaminhamento de eventos para enviar dados para Meta do Adobe Experience Platform Edge Network. 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.
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.
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 Event Forwarding 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 Extensions na navegação à esquerda e, em seguida, selecione a guia Catalog. Procure o cartão Meta Conversions API e selecione Install.
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 Save
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 Instagram facebook
A integração usando a extensão do Facebook e Instagram permite que você se autentique rapidamente em sua conta comercial do Meta. Em seguida, o Pixel ID e a API de Conversões do Meta Access Token são preenchidos automaticamente, facilitando a instalação e a configuração da API de Conversões do Meta.
Um prompt de caixa de diálogo para autenticar no Facebook e no Instagram é exibido ao instalar a extensão Meta Conversions API.
Um prompt de diálogo para autenticar no Facebook e no Instagram também é exibido na interface do usuário do workflow de início rápido no encaminhamento de eventos.
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 conversões do Meta. Essas pontuações de evento aparecem na tela de configuração Meta Conversions API extension.
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.
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.
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 Meta Conversions API Extension para a extensão e Send Conversions API Event para o tipo de ação.
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 você estiver usando Meta Pixel e Conversions API para enviar eventos, certifique-se de incluir um Event Name (
event_name) e Event ID (event_id) com cada evento, já que esses valores são usados para a desduplicação de eventos.Você também tem a opção de Enable Limited Data Use para ajudar a cumprir 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.
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.
Se estiver enviando um evento de compra, você deve usar esta seção para fornecer os atributos necessários
currency e value.Quando terminar, selecione Keep Changes para adicionar a ação à configuração de regra.
Quando estiver satisfeito com a regra, selecione Save to Library. 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 conversões do Meta (Beta) quick-start
- 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.
- 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 conversões do Meta e as extensões Meta Pixel. Essa ferramenta automatiza várias etapas executadas nas tags da Adobe e no encaminhamento de eventos, reduzindo significativamente o tempo de configuração.
Esse recurso instala e configura automaticamente as extensões da API de conversões do Meta e do Meta Pixel em uma propriedade de encaminhamento de eventos e tags recém-geradas automaticamente com as regras e os elementos de dados necessários. Além disso, ele também instala e configura automaticamente o Experience Platform Web SDK 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 Experience Platform Edge Network.
O vídeo a seguir fornece uma introdução ao recurso de início rápido.
Instalar o recurso de início rápido
Essa configuração instala automaticamente as extensões API de conversões do Meta e Meta Pixel. Essa implementação híbrida é recomendada pela 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 Get Started para Send Conversions Data to Meta na página Coleção de dados da Adobe Experience Platform Home.
Insira seu Domain e selecione Next. 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.
Na caixa de diálogo Initial Setup, digite seus Meta Pixel ID, Meta Conversion API Access Token e Data Layer Path e selecione Next.
Aguarde alguns minutos para que o processo de instalação inicial seja concluído e selecione Next.
Na caixa de diálogo Add Code on Your Site, copie o código fornecido usando a função de cópia
<head> do site de origem. Depois de implementado, selecione Start Validation
A caixa de diálogo Validation Results exibe os resultados de implementação da extensão do Meta. Selecione Next. Você também pode ver resultados de validação adicionais selecionando o link Assurance.
A exibição da tela Next Steps 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 Close.
Adição de eventos adicionais
Para adicionar novos eventos, selecione Edit Your Tags Web Property.
Selecione a regra que corresponde ao metaevento que você deseja editar. Por exemplo, MetaConversion_AddToCart.
Para adicionar um evento, selecione Add sob o cabeçalho Events.
Selecione Event Type. Neste exemplo, selecionamos o evento Click e o configuramos para disparar quando o .botão adicionar ao carrinho estiver selecionado. Selecione Keep Changes.
O novo evento foi salvo. Selecione Select a working library e selecione a biblioteca para a qual você deseja compilar.
Em seguida, selecione a lista suspensa ao lado de Save to Library e selecione Save to Library and Build. Isso publicará a alteração na biblioteca.
Repita essas etapas para qualquer outro evento de meta conversão que deseje configurar.
Configuração da camada de dados configuration
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.
É 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.
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.