ConverlayConverlay
Conversions APICAPIShopify

Conversions API (CAPI) no Shopify: Como Configurar o Server-Side Tracking para Meta, Google e TikTok

Converlay1 de março de 202612 min de leitura

A Conversions API, comumente chamada de CAPI, e a contrapartida server-side dos pixels de anuncios baseados em navegador. Em vez de depender de JavaScript rodando no navegador do seu visitante para reportar conversoes, a CAPI envia dados de eventos diretamente do seu servidor para o servidor da plataforma de anuncios. Para donos de lojas Shopify, isso agora e essencial: bloqueadores de anuncios, restricoes de privacidade do iOS e limitacoes de cookies do navegador significam que seus pixels estao perdendo de 20 a 40 por cento das conversoes reais. A CAPI recupera esses dados perdidos.

Este guia cobre como a Conversions API funciona, quais plataformas a oferecem e como configura-la na sua loja Shopify para Meta (Facebook e Instagram), Google, TikTok e Pinterest.

O que e a Conversions API (CAPI)?

A Conversions API e uma interface server-side fornecida pelas plataformas de anuncios que permite enviar eventos de conversao (compras, adicoes ao carrinho, checkouts, visualizacoes de pagina) diretamente do seu servidor. O termo "CAPI" se originou com a Conversions API do Meta para anuncios do Facebook e Instagram, mas o conceito agora existe em todas as principais plataformas com nomes diferentes:

  • Meta: Conversions API (CAPI)
  • Google: Enhanced Conversions e Measurement Protocol
  • TikTok: Events API
  • Pinterest: Conversions API
  • Snapchat: Conversions API
  • Reddit: Conversions API

Todas funcionam com o mesmo principio: seu servidor envia um payload de evento estruturado para o endpoint da API da plataforma, incluindo o tipo de evento, detalhes da transacao e identificadores de cliente em hash para correspondencia. A plataforma usa esses dados para atribuir a conversao a campanha de anuncio correta, exatamente como se o pixel tivesse disparado no navegador.

Por que Sua Loja Shopify Precisa da CAPI

Se voce esta rodando publicidade paga em qualquer plataforma e dependendo exclusivamente de pixels de navegador para rastreamento de conversoes, voce esta operando com dados incompletos. Veja exatamente o que esta acontecendo:

Seu Pixel Esta Perdendo Conversoes

Bloqueadores de anuncios (usados por 30 a 42 por cento dos usuarios de internet) bloqueiam scripts de rastreamento do Meta, Google, TikTok e outras plataformas. A Intelligent Tracking Prevention do Safari limita o tempo de vida dos cookies JavaScript a 7 dias. A Enhanced Tracking Protection do Firefox bloqueia rastreadores conhecidos por padrao. O navegador Brave remove completamente os identificadores de clique das URLs. Cada evento bloqueado e uma conversao que sua plataforma de anuncios nao consegue ver.

Dados Ausentes Prejudicam o Desempenho das Campanhas

As plataformas de anuncios usam machine learning para otimizar quem ve seus anuncios. Quando 30 por cento das conversoes estao ausentes, o algoritmo tem uma visao distorcida do seu cliente ideal. Ele nao consegue otimizar adequadamente lances, segmentacao ou selecao criativa. O resultado: CPAs mais altos, ROAS pior e gasto com anuncios desperdicado. A CAPI fornece os dados completos de conversao que o algoritmo precisa para funcionar no seu melhor.

As Plataformas Priorizam Anunciantes com Dados Server-Side

O Meta foi explicito: anunciantes que implementam a CAPI junto com o pixel veem melhor entrega de anuncios e custos mais baixos por resultado. O Google recompensa maior qualidade de dados com melhor desempenho de Smart Bidding. O motor de otimizacao do TikTok funciona melhor com dados da Events API. Configurar a CAPI nao e apenas sobre recuperacao de dados. E uma vantagem competitiva nos leiloes de anuncios.

Meta Conversions API (CAPI) para Shopify

A Conversions API do Meta e a solucao de server-side tracking mais amplamente implementada para lojas Shopify, dado que a publicidade no Meta (Facebook e Instagram) e o principal canal pago para a maioria das marcas DTC.

O que a Meta CAPI Envia

A Conversions API envia eventos para o Meta incluindo:

  • Nome do evento: Purchase, AddToCart, InitiateCheckout, PageView, ViewContent
  • Dados do evento: Valor do pedido, moeda, IDs dos produtos, nomes dos produtos, quantidade
  • Parametros do cliente: Email em hash, numero de telefone em hash, external ID, fbclid (identificador de clique), cookies fbc e fbp, endereco IP do cliente, user agent

Quanto mais parametros do cliente voce incluir, maior sera sua pontuacao de Event Match Quality (EMQ) no Events Manager. Um EMQ mais alto significa que o Meta consegue fazer a correspondencia de mais conversoes com os usuarios e campanhas de anuncios corretos. Lojas Shopify tem uma vantagem natural aqui porque os clientes fornecem seu email e numero de telefone no checkout.

Como Configurar a Meta CAPI no Shopify

Existem tres abordagens principais:

  1. Integracao nativa do Shopify com o Meta: O Shopify oferece um canal Meta nativo que inclui suporte basico a CAPI. No entanto, ele tem limitacoes: a qualidade de correspondencia de eventos geralmente e menor porque nao captura e encaminha todos os parametros de cliente disponiveis, e depende da integracao do checkout do Shopify que nao cobre todos os tipos de eventos.
  2. Implementacao manual da API: Voce pode construir uma integracao server-side personalizada usando a documentacao da Conversions API do Meta. Isso requer recursos de desenvolvimento, tratamento de autenticacao, formatacao de eventos, hashing de dados do cliente, logica de deduplicacao e manutencao continua quando o Meta atualiza a API.
  3. Converlay (recomendado): Instale o aplicativo Converlay no Shopify, conecte seu Meta Pixel ID e token de acesso da Conversions API, e os eventos comecam a fluir em minutos. O Converlay automaticamente cuida do hashing de parametros do cliente, deduplicacao de eventos, captura de click ID e toda a formatacao de eventos. A maioria dos lojistas ve sua pontuacao de Event Match Quality atingir "Good" ou "Great" em poucos dias.

Melhores Praticas para Meta CAPI

  • Rode o pixel e a CAPI simultaneamente. O Meta recomenda isso para cobertura maxima e usa IDs de evento para deduplicar.
  • Monitore sua pontuacao de Event Match Quality no Events Manager. Busque "Good" (6+) ou "Great" (8+).
  • Garanta que voce esta enviando o parametro fbclid. Este e o parametro mais importante para atribuicao baseada em clique.
  • Envie todos os eventos padrao de e-commerce: PageView, ViewContent, AddToCart, InitiateCheckout e Purchase.

Google Enhanced Conversions e Measurement Protocol para Shopify

O Google oferece duas abordagens server-side para dados de conversao: Enhanced Conversions para Google Ads e o Measurement Protocol para GA4. Ambas melhoram a precisao dos dados para lojas Shopify.

Google Enhanced Conversions

As Enhanced Conversions permitem que voce envie dados de cliente first-party em hash (email, telefone, endereco) junto com suas tags de conversao. O Google usa esses dados para fazer a correspondencia de conversoes com usuarios logados no Google, recuperando conversoes que seriam perdidas devido a restricoes de cookies. Para lojas Shopify, isso significa que o Google Ads consegue atribuir mais compras as campanhas corretas, especialmente para conversoes cross-device onde um usuario clicou em um anuncio no celular mas comprou no desktop.

GA4 Measurement Protocol

O Measurement Protocol permite enviar eventos diretamente para o Google Analytics 4 a partir do seu servidor. Isso e valioso para lojas Shopify porque eventos do GA4 enviados pelo pixel (gtag.js) sao bloqueados por bloqueadores de anuncios. Eventos server-side atraves do Measurement Protocol garantem que seus relatorios do GA4 reflitam a atividade real da loja, nao apenas a atividade dos visitantes sem bloqueadores de anuncios.

Configurando o Server-Side Tracking do Google no Shopify

Com o Converlay, conecte seu Google Ads Conversion ID e GA4 Measurement ID. O Converlay envia eventos de compra e e-commerce tanto para o Google Ads (para otimizacao de conversao e Smart Bidding) quanto para o GA4 (para analytics e relatorios). O identificador de clique gclid e capturado e encaminhado automaticamente para atribuicao precisa baseada em clique.

TikTok Events API para Shopify

A Events API do TikTok e o equivalente server-side do TikTok Pixel. Para lojas Shopify que anunciam no TikTok, a Events API e critica porque o pixel do TikTok (analytics.tiktok.com) e bloqueado por praticamente todo bloqueador de anuncios.

O que a TikTok Events API Envia

A Events API envia dados de eventos estruturados para o TikTok incluindo:

  • Tipos de evento: PageView, ViewContent, AddToCart, InitiateCheckout, CompletePayment
  • Parametros de conteudo: IDs de produto, tipo de conteudo, valor, moeda
  • Parametros de usuario: email em hash, telefone em hash, ttclid (TikTok click ID), endereco IP, user agent

Configurando a TikTok Events API no Shopify

No Converlay, adicione seu TikTok Pixel ID e token de acesso da Events API. O Converlay mapeia os eventos do Shopify para o formato esperado pelo TikTok e inclui o ttclid para atribuicao. O Events Manager do TikTok mostrara os eventos recebidos marcados como "Server" ao lado dos eventos de pixel marcados como "Browser."

Pinterest Conversions API para Shopify

A Conversions API do Pinterest segue o mesmo padrao. Para lojas Shopify que rodam anuncios no Pinterest, a Conversions API recupera dados de conversao que o Pinterest Tag perde devido a bloqueadores de anuncios e restricoes de navegador.

Conecte seu Pinterest Tag ID e token de acesso da Conversions API no Converlay. Eventos incluindo visualizacoes de pagina, adicao ao carrinho, checkout e compra sao enviados para a API do Pinterest com identificadores de cliente em hash para correspondencia. O Pinterest usa esses dados para otimizar suas campanhas de anuncios e atribuir conversoes com precisao.

Configurando a CAPI para Todas as Plataformas de Uma Vez com o Converlay

A abordagem mais eficiente e configurar o server-side tracking para todas as suas plataformas de anuncios simultaneamente. Veja o processo com o Converlay:

  1. Instale o Converlay pela Shopify App Store.
  2. Adicione as credenciais de cada plataforma no painel do Converlay: Pixel IDs, tokens de API e IDs de conversao para Meta, Google, TikTok, Pinterest e quaisquer outras plataformas que voce utilize.
  3. Ative o encaminhamento de eventos para cada plataforma. O Converlay captura os eventos do Shopify uma vez e os distribui para todas as plataformas conectadas simultaneamente.
  4. Verifique em cada plataforma que os eventos server-side estao chegando. Confira o Meta Events Manager, o status de conversao do Google Ads, o TikTok Events Manager e os diagnosticos de tag de conversao do Pinterest.
  5. Monitore o impacto durante as primeiras 2 semanas. Acompanhe o aumento nas conversoes reportadas e a melhoria na qualidade de correspondencia de eventos em todas as plataformas.

A vantagem dessa abordagem e que um unico evento de compra na sua loja Shopify e enviado para todas as plataformas conectadas de uma vez. Um cliente compra um produto e Meta, Google, TikTok e Pinterest recebem os dados da conversao atraves de suas respectivas APIs. Sem dependencia do navegador para nenhuma plataforma.

CAPI vs. Pixel: Voce Precisa de Ambos?

Sim. Todas as plataformas de anuncios recomendam rodar tanto o pixel quanto a CAPI simultaneamente. Veja por que:

Aspecto Apenas Pixel Apenas CAPI Pixel + CAPI
Visitantes sem bloqueadores de anuncios Rastreados Rastreados Rastreados
Visitantes com bloqueadores de anuncios Perdidos Rastreados Rastreados
Eventos em tempo real Sim Leve atraso Sim (pixel) + backup (CAPI)
Eventos de navegador (scroll, tempo na pagina) Sim Nao Sim
Deduplicacao N/A N/A Automatica via event ID
Completude dos dados 60-70% 85-90% 95-99%

Rodar ambos oferece a velocidade dos eventos de pixel para visitantes nao bloqueados mais a confiabilidade dos eventos server-side para todos os demais. As plataformas cuidam da deduplicacao, entao nao ha contagem dupla.

Perguntas Frequentes

Qual e a diferenca entre CAPI e um pixel?

Um pixel e um trecho de JavaScript que roda no navegador do visitante e envia eventos para a plataforma de anuncios. A CAPI (Conversions API) envia os mesmos eventos do seu servidor diretamente para o servidor da plataforma de anuncios. O pixel pode ser bloqueado por bloqueadores de anuncios e recursos de privacidade do navegador. A CAPI nao pode ser bloqueada porque contorna completamente o navegador.

A CAPI e gratuita?

As APIs em si sao gratuitas. Meta, Google, TikTok e Pinterest nao cobram para receber eventos server-side. O custo vem da implementacao: seja o tempo de desenvolvimento para construir e manter uma integracao personalizada, ou a taxa de assinatura de uma ferramenta como o Converlay que cuida da integracao para voce.

A CAPI vai corrigir meu ROAS baixo?

Se seu ROAS baixo e causado por dados de conversao ausentes (o que e extremamente comum), a CAPI melhorara diretamente seu ROAS reportado ao recuperar conversoes invisiveis. Mais importante, os dados completos ajudam os algoritmos das plataformas de anuncios a otimizar melhor, o que pode melhorar o desempenho real das campanhas ao longo do tempo.

Como sei se a CAPI esta funcionando corretamente?

Verifique o painel de gerenciamento de eventos de cada plataforma. O Meta Events Manager mostra eventos rotulados como "Server" ao lado dos eventos "Browser". O Google Ads mostra o status da acao de conversao. O TikTok Events Manager rotula os eventos por origem. Voce deve ver uma combinacao de eventos de navegador e servidor, com o total de conversoes maior do que o que voce via apenas com o pixel.

O Shopify tem suporte nativo a CAPI?

O Shopify oferece um canal Meta nativo com funcionalidade basica de CAPI. No entanto, ele cobre apenas o Meta e tem qualidade de correspondencia de eventos limitada. Para server-side tracking abrangente em Meta, Google, TikTok, Pinterest e outras plataformas, uma solucao dedicada como o Converlay oferece cobertura e qualidade de dados significativamente melhores.

Posso configurar a CAPI sem um desenvolvedor?

Sim. Com o Converlay, configurar a CAPI no Shopify nao requer codificacao. Voce instala o aplicativo, insere suas credenciais da plataforma e os eventos server-side comecam a fluir. Todo o processo de configuracao leva minutos, nao dias ou semanas de trabalho de desenvolvimento.

Como a CAPI lida com a privacidade dos dados do cliente?

As implementacoes de CAPI aplicam hash nos dados do cliente (email, numero de telefone) usando SHA-256 antes de envia-los para as plataformas de anuncios. As plataformas nunca recebem dados brutos do cliente atraves da CAPI. Alem disso, a CAPI deve enviar dados apenas de visitantes que forneceram consentimento quando necessario (GDPR, CCPA). O Converlay suporta filtragem de eventos baseada em consentimento.

Configure a CAPI na sua loja Shopify com o Converlay e comece a recuperar as conversoes que seus pixels estao perdendo. Conecte todas as suas plataformas de anuncios em minutos.