Como configurar a Conversions API na Shopify

A Shopify suporta a Conversions API do Meta?

O app Facebook & Instagram da Shopify envia compras pela Conversions API do Meta quando seu compartilhamento de dados está em Enhanced ou Maximum, então a maioria das lojas não precisa de código. Adicione um app de rastreamento quando você roda vários pixels, quer ver cada evento e a resposta do Meta, ou precisa de plataformas que seus apps de canal não cobrem. De qualquer forma, dê a cada pixel um único remetente.

A Conversions API é o caminho pelo servidor do Meta para eventos de site: um servidor os envia direto ao Meta em vez de depender do navegador do comprador (Meta). Ela não substitui o pixel. O conselho do Meta é “usar a Conversions API além do Meta Pixel, e compartilhar os mesmos eventos usando as duas ferramentas” (Meta: best practices), e ele mantém uma cópia de cada evento quando as duas trazem o mesmo nome de evento e ID de evento. O Meta também quer os eventos rapidamente, “idealmente dentro de uma hora”, e aceita uma hora de evento até 7 dias antes do envio (Meta: using the API). As páginas do Meta foram verificadas em 24 de setembro de 2026.

Qual configuração você deveria usar?

Para um único pixel do Meta numa loja Shopify típica, comece com o app Facebook & Instagram. Um app de rastreamento serve para vários pixels ou plataformas e um registro por evento; o Gateway do Meta e seu próprio servidor precisam de uma conta na nuvem ou de um desenvolvedor.

O Meta diz que configurar a Conversions API por uma plataforma de comércio como a Shopify leva “só alguns cliques” sem custo extra, e estima de 2 a 4 semanas para uma integração direta nova (Meta: compare setup options). A mesma página agora também lista uma Conversions API habilitada pelo Meta, gratuita e só para web, que envia os eventos do seu pixel do Meta por uma conexão de servidor que o Meta cria. O Gateway roda na sua própria conta da Amazon Web Services ou do Google Cloud, e o Meta o direciona a sites que não usam um parceiro de comércio como a Shopify: se seu parceiro suporta a Conversions API, o Meta recomenda usar essa em vez disso (Meta: Conversions API Gateway). Verificado em 24 de setembro de 2026.

Como você ativa isso no app do Facebook e Instagram?

Conecte o app ao Meta, ajuste o compartilhamento de dados para Enhanced ou Maximum, e impeça a Shopify de pausar o pixel. O Meta pede uma loja que não seja protegida por senha, o plano Basic Shopify ou superior, uma Página do Facebook pertencente ao seu portfólio de negócios, e permissões de administrador nesse portfólio (Meta: connect Shopify).

1. No seu admin da Shopify, vá em Sales channels → Facebook & Instagram → Settings → Data sharing settings.
2. Na seção Customer data sharing, ative o compartilhamento de dados de clientes e escolha Enhanced ou Maximum. Standard usa só o pixel do Meta; Enhanced adiciona a Conversions API, e Maximum adiciona por cima a tecnologia de anúncios mais recente do Meta (Shopify: Facebook data sharing).
3. Vá em Settings → Customer events, clique no pixel do Facebook & Instagram, escolha Always on e clique em Save. O Meta recomenda Always on “para ajudar a garantir a performance mais confiável” (Meta: connect Shopify).

O passo 3 importa porque pixels de app têm Optimized como padrão desde 13 de janeiro de 2026, e com isso a Shopify “pode pausar parte ou todos os dados compartilhados por esse pixel até que a atividade relevante volte” (Shopify: app pixels; changelog). Verificado em 24 de setembro de 2026.

Dois limites para conhecer. A página da Shopify nomeia só o evento de compra como o que viaja pela Conversions API, então não presuma que todo evento vai de servidor a servidor. E Enhanced e Maximum compartilham o nome, a localização, o e-mail e o telefone dos seus clientes com o Meta.

Como TikTok, Google, Pinterest, Snapchat e ChatGPT Ads se comparam?

Cada um tem sua própria API de servidor e seu próprio app da Shopify. Para o Meta, a Shopify diz que a compra vai de servidor a servidor; para os demais, nenhuma das páginas que conferimos diz quais eventos o app da Shopify envia por um servidor.

“Não informado” significa que a página não diz, não que nada é enviado. O Google trata seus caminhos de servidor como complementos da tag: o Measurement Protocol foi pensado “para complementar a coleta automática por gtag, Tag Manager e Google Analytics para Firebase, não para substituí-la” (Google), e a Data Manager API envia conversões como “uma fonte de dados adicional para as conversões da sua tag” (Google). A Shopify também dá a certos apps pixels de servidor, que “transferem eventos de cliente por um servidor até o dono do app” e continuam sujeitos às configurações de privacidade e consentimento da sua loja (Shopify: app pixels). Verificado em 24 de setembro de 2026.

Se você anuncia em várias dessas, cada app de canal é mais um pixel para configurar, conferir e manter com um só remetente. O ChatGPT Ads, o mais novo, tem seu próprio guia: rastreie conversões do ChatGPT Ads.

Como você configura isso com um app de rastreamento?

Instale o app, cole o ID de cada pixel e um token de acesso da Conversions API, e garanta que nenhuma outra ferramenta envie para o mesmo pixel. Os passos abaixo usam o cPixel, que nós desenvolvemos, como exemplo.

O cPixel envia para Meta, TikTok, Google Analytics 4, Google Ads, Pinterest, Snapchat e ChatGPT Ads da OpenAI, a partir dos navegadores dos compradores e, exceto para o Google Ads, a partir dos seus próprios servidores. Para o Meta, três coisas funcionam de forma diferente do app de canal:

• A compra vem do pedido. O cPixel constrói cada compra a partir do registro do pedido da Shopify nos seus servidores, não a partir da página de agradecimento, então não depende de essa página carregar no navegador do comprador.
• Uma Purchase por pedido. A Purchase pelo navegador do Meta fica desligada enquanto o envio pelo servidor do cPixel para esse pixel está ativo, então o Meta recebe cada compra uma vez, pelo servidor. Visualizações de página, adições ao carrinho e checkouts saem dos dois lados sob um único ID de evento compartilhado.
• Você pode acompanhar. Ao vivo mostra cada evento assim que o cPixel o envia, seja pelo navegador ou pelo servidor, com a resposta do Meta a cada envio de servidor.

Ele também aceita vários pixels do Meta, cada um com seu próprio token. Para conectar um:

1. No cPixel, abra Destinos e clique em Conectar Meta.
2. Cole o ID do pixel / conjunto de dados e um Token de acesso da Conversions API, depois clique em Continuar. Sem um token, essa conta envia só pelo navegador.
3. Em Escolha as opções, em O app oficial do Meta também está instalado?, mantenha Não — o cPixel cuida do Meta (recomendado) quando nada mais enviar para esse pixel, depois clique em Salvar e continuar.

Se o app Facebook & Instagram já enviar para esse pixel, escolha uma de duas configurações limpas: responda Sim — mantenha-o, e o cPixel para de enviar o Meta pelo servidor, o que na prática também para os envios do cPixel pelo navegador para esse pixel, ou conecte o cPixel a um dataset diferente. As vantagens e desvantagens estão em use o cPixel com o app do Facebook e Instagram, e o passo a passo completo em conecte o Meta ao cPixel. Todo plano envia pelo servidor, o Free incluído, e os limites estão nos preços do cPixel. Mais sobre o cPixel, que envia compras da Shopify para sete plataformas de anúncios.

Como você consegue um token de acesso da Conversions API?

Gere-o no Meta Events Manager: escolha seu dataset, abra a aba Settings e clique em Generate access token na seção Conversions API. O Meta mostra esse link só para pessoas com privilégios de desenvolvedor no negócio (Meta: get started). Você precisa de um para um app de rastreamento ou seu próprio servidor, não para o app Facebook & Instagram. Mantenha-o em segredo; como encontrar o Pixel ID e gerar um token mostra as telas do Meta.

Como o Meta evita contar uma compra duas vezes?

Ele mantém uma cópia quando um evento de navegador e um de servidor compartilham o mesmo nome de evento e ID de evento, chegam ao mesmo pixel, e chegam com menos de 48 horas de diferença, e “geralmente” prefere o que recebeu primeiro (Meta: deduplication, verificado em 24 de setembro de 2026). Duas ferramentas que cada uma cria seus próprios IDs não podem ser casadas, então o Meta conta as duas, e essa costuma ser a razão de ele relatar mais compras que a Shopify. As fontes e correções estão em por que o Meta conta compras duas vezes.

Como você confere se está funcionando?

Olhe no Meta Events Manager: abra os detalhes do evento Purchase, faça um teste com um pedido real, e observe a qualidade de correspondência. Dê tempo primeiro: o Meta diz que eventos de servidor deveriam poder ser verificados dentro de 20 minutos do envio (Meta: using the API).

1. Veja a divisão. No Events Manager, selecione seu dataset, encontre o evento Purchase e clique em View details. Event overview mostra se o evento chega do navegador, do servidor, ou dos dois, e as abas Event deduplication e Data freshness mostram como as cópias são casadas e com que rapidez os eventos de servidor chegam (Meta: server event details).
2. Teste com um pedido real. Abra Test events, digite o endereço da sua loja, clique em Open website e faça um pedido. A ferramenta lista os eventos de navegador dessa janela, como a Purchase do pixel do Facebook & Instagram; os eventos de servidor só aparecem com um código de evento de teste, algo que o Meta diz para remover dos envios reais (Meta: using the API). Então uma Purchase só de servidor, como a do cPixel, não vai aparecer ali: confira em Ao vivo e no Overview do dataset. O Meta mantém a atividade de teste: ela “continuará aparecendo” no Events Manager, nos relatórios de anúncios e nos públicos (Meta: test events), então use um pedido que você contaria de qualquer forma. Ferramentas do navegador nunca mostram eventos de servidor; se não mostrarem nenhum pixel, veja por que o Meta Pixel Helper não encontra nenhum pixel.
3. Confira o Event Match Quality. O Meta pontua eventos de site enviados pela Conversions API de 0 a 10 pelos dados de cliente que trazem, usando as últimas 48 horas de dados (Meta: event match quality). O que move a pontuação: melhore o Event Match Quality.

Com o cPixel, Ao vivo mostra o mesmo envio do seu lado, com seu ID de evento e a resposta do Meta: acompanhe cada envio no Ao vivo.

O que a Conversions API não consegue corrigir?

Ela muda como os eventos chegam ao Meta, não quais compradores podem ser rastreados nem como o Meta atribui uma venda.

• Consentimento. No Reino Unido e no EEE, os pixels da Shopify “operam com base no consentimento obtido” (Shopify: privacy settings), e a Shopify diz que pixels de servidor “continuam sujeitos às configurações de privacidade e consentimento de cliente da sua loja” (Shopify: app pixels). Um envio de servidor não é uma licença para ignorar uma recusa.
• Atribuição. O Meta atribui uma compra a um anúncio só dentro da configuração de atribuição do conjunto de anúncios (Meta: attribution), então o Ads Manager pode mostrar menos compras que o Events Manager sem nada estar quebrado (Meta: event counts). Quando os dois discordam, veja pixel do Meta não rastreia compras?
• Links despidos. A Navegação Privada do Safari ativa por padrão a proteção avançada contra rastreamento e fingerprinting, e com ela “parâmetros de rastreamento conhecidos são removidos de todas as URLs” (Apple: Safari User Guide). Um parâmetro de clique que nunca chega à sua loja não pode ser enviado depois por um servidor.
• Bots. Enviar por um servidor não distingue um bot de um comprador. Se o caminho extra vale a pena para sua loja: rastreamento pelo servidor na Shopify.

A mudança do checkout de 26 de agosto de 2026 afetou isso?

Não, se o Meta souber das compras pelo app Facebook & Instagram ou outro pixel de app. As páginas de agradecimento e de status do pedido da Shopify pararam de rodar Additional scripts e script tags em lojas Plus em 28 de agosto de 2025. As demais lojas tiveram até 26 de agosto de 2026 para atualizar essas páginas, e a Shopify atualizou automaticamente toda loja que perdeu o prazo, então uma tag de Purchase colada em Additional scripts parou de funcionar sem aviso (Shopify: upgrade; shopify.dev, verificado em 24 de setembro de 2026). Pixels de app e pixels personalizados carregam no checkout e na página de agradecimento (Shopify: pixels), e a Conversions API do app de canal envia a compra entre os servidores da Shopify e do Meta. Se suas compras caíram nessa data, comece por Additional scripts parou de funcionar.

Perguntas frequentes

A Conversions API é grátis?

O Meta não cobra por ela: por uma plataforma de comércio como a Shopify, configurá-la “não tem custo adicional” (Meta: compare setup options). O que custa dinheiro é a ferramenta que envia. O Gateway roda com hospedagem na nuvem que você paga, uma integração direta custa desenvolvimento e manutenção, e apps de rastreamento têm seus próprios planos.

Eu ainda preciso do pixel do Meta?

Sim. O Meta recomenda a Conversions API “além do Meta Pixel”, com os mesmos eventos enviados pelos dois caminhos e casados por ID de evento (Meta: best practices). O pixel vê o que acontece no navegador; a cópia de servidor cobre os eventos que o navegador perde.

Quais planos da Shopify podem usá-la?

Pelo app Facebook & Instagram, o Meta pede o plano Basic Shopify ou superior, numa loja que não seja protegida por senha (Meta: connect Shopify). Apps de rastreamento e seu próprio servidor têm seus próprios requisitos.