Keitaro e a API oficial da Meta: seu tracker ao lado de uma camada de campanha em conformidade

Muitos media buyers usam o Keitaro e a API oficial da Meta lado a lado. O tracker registra cliques, ofertas e payouts em uma infraestrutura que eles controlam, e uma ferramenta de campanhas conectada pela Marketing API da Meta cuida de lançamentos, orçamentos e regras. Este guia explica por que essa divisão faz sentido, por que os dois conjuntos de números raramente batem, como o método de conexão molda o risco da conta e o que muda quando o Keitaro fica dentro da Wevion.

Se você já usa o Keitaro e quer ver como a integração funciona na prática, a página do Keitaro e dos trackers lista todas as funcionalidades. O resto deste artigo explica o raciocínio por trás dela.

Por que usar um tracker e uma ferramenta de campanhas?

Um tracker e uma ferramenta de campanhas respondem a perguntas diferentes, e é por isso que a maioria dos media buyers de afiliados acaba pagando pelos dois. O Keitaro responde ao que aconteceu depois do clique: qual oferta converteu, qual landing page prendeu a atenção, qual sub ID gerou o payout e o que a rede de afiliados acabou confirmando. Uma plataforma de anúncios responde ao que aconteceu antes e no momento do clique, e é o único lugar onde orçamentos, lances e públicos de fato mudam.

Nenhum dos lados faz o trabalho do outro. O Keitaro não consegue aumentar o orçamento de um conjunto de anúncios que está dando lucro. O Ads Manager não vê o payout que a sua rede envia três dias depois. Assim, o trabalho vira dois painéis e uma planilha, com alguém casando nomes de campanhas à mão toda manhã.

O padrão se repete entre canais. Quando uma oferta sai do social para o native, o tracker continua o mesmo e as fontes de tráfego mudam, um fluxo que descrevemos em escalar uma oferta de afiliados do social para o native com o Keitaro intacto.

Por que o Keitaro e a Meta não batem?

O Keitaro e a Meta raramente reportam o mesmo número de conversões, e essa diferença é esperada, não um sinal de que um deles está quebrado. Cada sistema mede a partir da sua própria posição, com suas regras sobre o que conta e quando.

As causas mais comuns:

• Janelas de atribuição. A Meta credita conversões dentro da sua configuração de atribuição, que por padrão inclui 7 dias após o clique e 1 dia após a visualização, e algumas dessas conversões são modeladas. O Keitaro conta os postbacks que recebe.
• Definições de clique. Um clique no link na Meta não é o mesmo evento que um clique que o seu tracker registra na landing page. Páginas lentas e saídas antes de o redirecionamento disparar já abrem uma diferença.
• Fusos horários. Uma conta de anúncios em um fuso horário e um tracker em outro dividem o mesmo dia de forma diferente.
• Postbacks atrasados. As redes muitas vezes confirmam conversões horas ou dias depois, então os números de ontem continuam mudando no tracker depois que a plataforma já fechou.
• Parâmetros ausentes. Se o ID da campanha, do conjunto de anúncios ou do anúncio nunca chega ao tracker, uma conversão pode ser contada, mas nunca ligada a um anúncio.

Uma regra que funciona é confiar no tracker para receita e payouts, confiar na plataforma para investimento e veiculação, e reconciliar os dois por IDs, e não por nomes. Nossa história de reconciliação de postbacks do Keitaro mostra como uma equipe encontrou a causa de uma divergência, e o protocolo de QA de postbacks é um checklist para pegar integrações quebradas antes que elas custem uma semana de dados.

Como a sua ferramenta de campanhas deve se conectar?

A forma como uma ferramenta de campanhas se conecta às suas contas de anúncios importa mais para o risco da conta do que quase qualquer funcionalidade que ela ofereça. Há duas abordagens gerais, e elas se comportam de forma muito diferente.

API oficial com OAuth. Você faz login com a Meta, revisa as permissões que o app Meta da ferramenta solicita e as concede. A ferramenta então trabalha pela Marketing API da Meta, o caminho que a Meta criou para softwares que gerenciam anúncios. Ninguém fica com a sua senha, o token de acesso pode ser revogado nas configurações da Meta e cada alteração é uma chamada de API documentada.

Ferramentas baseadas em sessão. Essas ferramentas conduzem a interface do Ads Manager por uma sessão de navegador salva, cookies salvos ou um login compartilhado. Elas alcançam tudo em que uma pessoa pode clicar, mas dependem de a interface não mudar, guardam credenciais que nunca deveriam ter saído do seu navegador, e os termos de coleta automatizada de dados da Meta restringem o acesso automatizado que acontece fora das APIs dela.

As restrições de conta são o problema documentado aqui, e vale ser preciso sobre isso. A Meta aplica suas políticas de publicidade a todas as contas, seja qual for a ferramenta que as gerencia, então nenhum software pode prometer que uma conta nunca será restringida. O que o método de conexão decide é se as ferramentas somam o próprio risco por cima. Nosso artigo sobre como a Wevion se conecta por OAuth com tokens criptografados explica os detalhes.

A Wevion se conecta à Meta, Google, TikTok, Taboola, Snapchat e Outbrain pela API oficial de cada plataforma, com OAuth na Meta para que ninguém compartilhe uma senha. Os dados das plataformas sincronizam a cada 15 minutos, mais ou menos, as regras rodam nos horários que você escolhe, e as mudanças propostas pelo Wavo, o copiloto de IA, esperam a aprovação de uma pessoa antes que qualquer coisa aconteça.

Um administrador também pode colar um token de System User da Meta quando a configuração exigir, embora fazer login com OAuth seja o caminho padrão.

Uma observação sobre cloaking

Alguns trackers incluem filtragem de tráfego que pode ser usada para mostrar aos revisores de anúncios uma página diferente da que os visitantes reais veem. Os Padrões de Publicidade da Meta tratam isso como burlar os seus sistemas, e esse é um motivo documentado para restringir contas de anúncios, páginas e Business Managers. A integração da Wevion lê dados de tracking do Keitaro. Ela não roteia visitantes, não filtra tráfego nem muda o que alguém vê.

O Keitaro dentro da Wevion

Conectar o Keitaro à Wevion coloca os dados do tracker no mesmo espaço de trabalho das suas contas de anúncios, e a reconciliação da manhã deixa de ser um trabalho de copiar e colar. Veja o que a integração faz hoje:

• Sua própria instância. Cole a URL e a chave de API do seu Keitaro, teste a conexão e salve. A chave fica armazenada com criptografia, e você pode revogá-la no Keitaro a qualquer momento.
• Sincronização a cada 15 minutos. A primeira importação traz os últimos 30 dias, e cada execução seguinte fica listada no Histórico de Sincronização, incluindo qualquer execução que tenha falhado e o respectivo erro.
• Cinco tabelas sincronizadas. Campanhas, ofertas, landing pages, fontes de tráfego e redes de afiliados sincronizam cada uma na sua própria tabela.
• Mapeamento de campanhas. Os parâmetros do Keitaro são mapeados para campanhas, conjuntos de anúncios e anúncios da Meta, por ID ou nome. As regras de mapeamento podem ser detectadas automaticamente, um parâmetro de fallback pega o que escapar, e a cobertura mostra o que ainda não foi mapeado.
• Detalhamentos. Cliques, conversões, receita, custo, lucro, ROI e taxa de conversão por sub ID, oferta, landing page e geo.
• Postback S2S. As conversões enviadas para a Wevion por postback server-to-server ficam armazenadas uma vez por ID de transação e aparecem junto das suas campanhas da Meta na visão Ads Manager da Wevion.
• Acesso da equipe. Cada membro da equipe é associado a um ou mais usuários do Keitaro, então as permissões que ele tem no Keitaro valem também na Wevion. Owners e admins veem tudo; qualquer outro membro sem associação não vê o tracker.

A mesma página de Trackers conecta Voluum, RedTrack, BeMob, Binom, ClickFlare e Everflow, então a abordagem não depende do tracker que a sua equipe escolheu.

Regras em uma sincronização de 15 minutos

A automação em um ciclo de dados de 15 minutos funciona melhor quando as regras protegem o investimento ao longo de horas e dias, em vez de correr atrás de conversões isoladas. Os dados das plataformas de anúncios na Wevion sincronizam a cada 15 minutos, mais ou menos, e cada regra roda no seu próprio horário: a cada 30 minutos por padrão, podendo ir até a cada 15 minutos ou no máximo uma vez por dia. As regras só agem nas condições que você define.

Esse ritmo combina com as tarefas em que as regras são boas:

• Pausar um conjunto de anúncios que gastou acima do seu limite sem conversões em três dias.
• Reduzir um orçamento quando o custo por aquisição fica acima da meta em uma janela de sete dias.
• Limitar as alterações ao horário de trabalho, para que nada mude enquanto ninguém está olhando.

Cada regra pode ser testada com um dry run que mostra o que ela pegaria sem alterar nada. Os cooldowns impedem que uma regra aja de novo na mesma entidade cedo demais, um limite diário restringe quantas vezes ela roda, e o histórico de execuções registra o estado de cada entidade antes e depois. As sugestões do Wavo, o copiloto de IA, seguem o mesmo princípio: ele propõe, você confirma.

Mantenha um hábito do mundo dos trackers. Quando o Keitaro conta uma história diferente da métrica da plataforma que uma regra lê, confira o mapeamento e os postbacks antes de confiar na regra. Nosso guia sobre passar as regras de ads da Meta por uma etapa de aprovação mostra como construir essa confiança por etapas.

O custo da stack, com honestidade

Calcular o custo real de uma configuração com tracker e ferramenta de campanhas exige olhar além das faturas. As linhas das assinaturas são fáceis de encontrar. As linhas caras costumam ser as que ninguém anota.

Uma planilha justa inclui:

• Custos de operação do tracker. Um Keitaro auto-hospedado precisa de servidor, domínios, SSL e alguém para mantê-lo atualizado.
• Custos da ferramenta de campanhas. A assinatura, mais o tempo que leva para fazer o onboarding e o offboarding de cada media buyer.
• Tempo de reconciliação. Horas por semana casando linhas do tracker com linhas da plataforma à mão.
• Custos de restrição. Tempo parado, recursos, públicos reconstruídos e histórico de pixel perdido quando uma conta é restringida. Ferramentas que dependem de logins compartilhados ou sessões por script tendem a inflar essa linha, mesmo que ela nunca apareça em uma fatura.
• Risco de acesso. O trabalho de redefinir credenciais quando alguém sai, se o acesso já foi compartilhado por senha alguma vez.

Preencha a planilha com os seus próprios números durante um mês. A maioria das equipes descobre que as linhas de reconciliação e de restrição pesam mais do que as assinaturas, e esse é o argumento mais forte para manter tracking e campanhas em conexões oficiais em um só lugar.

Pontos-chave

• O Keitaro e uma plataforma de anúncios respondem a perguntas diferentes, então usar os dois é normal.
• Espere números diferentes; reconcilie com base em IDs mapeados, não em nomes de campanhas.
• A forma como uma ferramenta se conecta importa para o risco: API oficial e OAuth, não logins compartilhados nem sessões por script.
• O cloaking é uma violação de política documentada, não uma funcionalidade a comparar.
• As regras em uma sincronização de 15 minutos devem proteger o investimento ao longo de horas e ser testadas antes com um dry run; o Wavo, o copiloto de IA, propõe mudanças que você aprova.