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.
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 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.
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 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.
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.
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.
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 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.
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 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.
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 Manter alterações para adicionar a ação à configuração de regra.
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
- 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 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
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.
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.
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.
Aguarde alguns minutos para que o processo de instalação inicial seja concluído e selecione Avançar.
Na caixa de diálogo Adicionar código ao seu site, copie o código fornecido usando a função de cópia
<head> do site de origem. Depois de implementado, selecione Iniciar Validação
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.
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.
Adição de eventos adicionais
Para adicionar novos eventos, selecione Editar Propriedade da Web de Marcas.
Selecione a regra que corresponde ao metaevento que você deseja editar. Por exemplo, MetaConversion_AddToCart.
Para adicionar um evento, selecione Adicionar sob o cabeçalho 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.
O novo evento foi salvo. Selecione Selecionar uma biblioteca de trabalho e selecione a biblioteca para a qual você deseja compilar.
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.
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.