Como conectar o postback da fonte de tráfego Keitaro ao Adgora

Pré-requisitos antes de começar

Antes de tentar como conectar a fonte de tráfego Keitaro ao Adgora, certifique-se de que ambas as contas estão ativas e que você pode editar a fonte de tráfego no Keitaro. Isso pode parecer simples, mas é aqui que muitas configurações falham: um usuário tem acesso de administrador no Adgora, mas apenas acesso de visualização no Keitaro, então o campo de postback permanece bloqueado. Você precisa da conta exata do Adgora para a qual deseja enviar eventos, e precisa da entrada da fonte de tráfego no Keitaro que realmente recebe cliques.

Verifique três coisas primeiro. Primeiro, a fonte de tráfego Keitaro deve já existir. Segundo, você deve saber qual oferta ou campanha gerará o evento de conversão. Terceiro, você precisa dos identificadores que o Adgora espera nas configurações da conta. Se algum desses estiver faltando, pare por aí e corrija o acesso antes de colar uma única URL.

Na prática, a configuração mais limpa é abrir ambas as ferramentas em abas separadas e comparar o nome da fonte, o campo de postback e o campo de identificador de clique lado a lado. Um pequeno erro de digitação, um grande problema. Uma fonte de tráfego chamada “Meta US” no Keitaro e “meta_us” no Adgora ainda pode funcionar, mas apenas se os parâmetros reais corresponderem, não o rótulo que você usa para sua própria conveniência.

Se você quiser um resumo mais amplo sobre termos de relatórios antes de enviar o pedido, o glossário de tecnologia publicitária pode ajudar com as palavras básicas que continuam aparecendo nas telas de rastreamento. Também vale a pena conferir o restante dos guias de publicidade em criptomoeda, monetização & Ad-Tech se você estiver construindo uma pilha de rastreamento mais completa, porque a configuração de postback raramente vive sozinha.

Encontre o endpoint de postback do Adgora e os parâmetros necessários

O primeiro passo técnico é copiar o endpoint de postback do Adgora da área da conta do Adgora onde as conversões estão configuradas. Não adivinhe a URL. Não reutilize um postback de outra conta. Um único caractere no caminho do endpoint pode transformar uma conversão válida em uma falha silenciosa, e falhas silenciosas são as piores porque parecem “sem tráfego” em vez de “configuração ruim.”

O Adgora geralmente espera um endpoint base mais vários parâmetros que identificam o evento. Em uma configuração de postback de fonte de tráfego, esses parâmetros frequentemente incluem um ID de clique, um identificador de fonte e uma referência de conversão. O Keitaro deve enviar o que quer que o Adgora use para conectar o evento de volta à linha de fonte correta. Se a linha de fonte estiver errada, a conversão cai no lugar errado ou não cai.

Copie o endpoint exatamente como mostrado no Adgora, depois anote quais macros o Adgora lista para o pedido. Algumas equipes mantêm uma nota de texto com o endpoint, o método HTTP, os nomes dos parâmetros obrigatórios e quaisquer valores opcionais como pagamento ou status. Essa nota economiza tempo depois, especialmente quando uma segunda fonte de tráfego precisa do mesmo padrão.

Se sua conta Adgora for usada para campanhas de cripto, a lógica de configuração é a mesma, seja você executando um fluxo de trabalho de rede de anúncios cripto para editores ou algo diferente. O postback ainda precisa dos identificadores corretos. Nada mágico acontece porque a campanha está relacionada a cripto.

Construa a URL do postback no Keitaro

Abra as configurações da fonte de tráfego no Keitaro e encontre o campo de postback ou callback de conversão para essa fonte. Cole o endpoint do Adgora lá, não na caixa de postback da campanha. Essa distinção é importante. O postback a nível de fonte envia dados da configuração da fonte de tráfego em si, que é o que o Adgora precisa para relatórios baseados em fonte; o rastreamento a nível de campanha é uma camada diferente e pode criar confusão se você misturá-los.

Agora mapeie os tokens do Keitaro para os parâmetros do Adgora. Por exemplo, se o Adgora espera um ID de clique, o Keitaro deve passar o token que contém esse valor de clique. Se o Adgora espera um nome de fonte ou ID de fonte, o Keitaro deve enviar o token vinculado ao registro da fonte de tráfego, não o nome da campanha. Mantenha o mapeamento literal. Mantenha-o chato.

Um hábito cuidadoso economiza horas: escreva a URL final em um editor de texto simples antes de salvá-la no Keitaro. Em seguida, compare cada parâmetro um por um. Um ampersand ausente, um espaço copiado ou um token envolto nos colchetes errados pode quebrar a solicitação. Isso é especialmente irritante quando a URL parece boa à primeira vista.

Algumas equipes testam isso primeiro com uma fonte de baixo risco, como uma pequena campanha de teste, antes de passar para compras maiores. Isso é sensato. Se você também estiver trabalhando com nichos verticais, como campanhas de instalação de aplicativos móveis ou ofertas de forex e trading, a mesma lógica de postback ainda se aplica, mesmo que a página da oferta pareça completamente diferente.

Combine IDs de clique e identificadores de fonte corretamente

Esta é a parte onde as integrações geralmente falham. O Keitaro pode receber muitos IDs, mas o Adgora só reconhece o evento se o ID de clique ou identificador de fonte exato voltar no formato que espera. Se o ID estiver ausente, truncado ou enviado sob o nome de parâmetro errado, o Adgora não pode vincular a conversão ao clique original.

Use um padrão de nomenclatura desde o início. Se sua fonte é “fb_us_01” no Keitaro, mantenha a mesma lógica nas notas do Adgora, na sua planilha de rastreamento e em qualquer documentação interna. Um nome incompatível nem sempre quebra a solicitação, mas quebra a solução de problemas humana. Três rótulos diferentes para uma fonte podem desperdiçar uma tarde.

Quando a lista de parâmetros do Adgora inclui um campo de ID de clique, mapeie-o para o token do Keitaro que armazena o identificador de clique do registro de clique da fonte. Quando inclui um identificador de fonte de tráfego, passe o token da fonte, não o token da campanha. Identificador de fonte e identificador de clique não são a mesma coisa, e confundi-los pode fazer uma conversão parecer válida enquanto aponta para a fonte errada.

Para equipes que comparam fluxos baseados em CPA, a mesma disciplina é importante em todos os modelos de precificação. Se você ainda está organizando a lógica do relatório, o artigo sobre CPC vs CPM vs CPA é um companheiro útil, porque o postback apenas informa o que aconteceu; não explica por que você escolheu esse modelo em primeiro lugar.

Envie uma conversão de teste e confirme a solicitação

Execute uma conversão de teste após a URL ser salva. Uma. Não cinco. Acione o evento de forma controlada, depois verifique ambos os sistemas. No Keitaro, abra o log de origem ou campanha e procure a solicitação de saída, o código HTTP e a URL final que foi enviada. No Adgora, procure o registro de evento correspondente e o timestamp. Esses dois timestamps devem estar próximos, mesmo que não sejam idênticos ao segundo.

Se o Keitaro mostrar uma resposta 200, mas o Adgora não mostrar nada, a solicitação chegou a algum lugar, apenas não ao manipulador de eventos pretendido. Se o Keitaro mostrar um código 4xx, o endpoint, método ou nomes de parâmetros provavelmente estão errados. Se a solicitação nunca aparecer no log, a colocação do token no Keitaro provavelmente está errada, ou o postback de origem nunca foi salvo.

Use um único clique de teste com uma nota única em seu caderno de anotações. Por exemplo, “teste manual na terça-feira, 14:20.” Isso lhe dá uma linha limpa para pesquisar depois. Um teste bagunçado com múltiplos cliques e sem notas parece ocupado, mas é difícil de depurar.

A frase como conectar o postback da fonte de tráfego do Keitaro ao Adgora só se torna clara quando você pode combinar um clique de origem, uma solicitação de saída e um evento dentro do Adgora. Se os três se alinharem, a configuração é real. Se um estiver faltando, não avance ainda.

Corrija os erros de postback de origem mais comuns

A colocação errada de macros é o erro mais comum. Um token destinado a dados de campanha é colado em um campo de origem, ou um token de ID de clique é colocado onde um ID de origem deveria estar. A solicitação ainda é enviada, razão pela qual o erro é fácil de passar despercebido. A URL existe, a conversão não.

A codificação de URL causa a próxima camada de problemas. Se um parâmetro contém caracteres especiais e o valor não está codificado da maneira que o Adgora espera, a solicitação pode chegar com partes quebradas. Isso aparece com mais frequência em nomes de origem, notas personalizadas ou valores de redirecionamento. Um sinal de mais pode se tornar um espaço. Uma barra pode dividir o campo. Caracteres pequenos, grande dor de cabeça.

Configurações de método incorretas também causam falhas. Se o Adgora espera GET e o Keitaro envia POST, ou vice-versa, o endpoint pode rejeitar a solicitação ou ignorá-la. Verifique o método em ambas as ferramentas antes de mudar qualquer outra coisa. Alterar três campos ao mesmo tempo torna impossível saber qual deles resolveu o problema.

Parâmetros duplicados criam outra bagunça silenciosa. Dois valores no mesmo campo podem fazer um sistema ler o primeiro e outro sistema ler o último. Mantenha um parâmetro por propósito. Se você precisar testar um valor de fallback, faça isso em uma versão separada, não na URL ao vivo.

Às vezes, o problema não é a URL. A fonte de tráfego no Keitaro pode ser nomeada de uma forma, enquanto a entrada de origem no Adgora espera outra conta ou outro ID de rede. Essa incompatibilidade pode fazer com que cada solicitação pareça “válida”, mas caia no lugar errado. Verifique a conexão da conta antes de reestruturar o postback em si.

Vá ao vivo e monitore os primeiros eventos reais

Após o teste ser aprovado, mude do tráfego de teste para o tráfego real sem alterar o restante do funil. Isso significa que você deve deixar a oferta, a página de destino e a lógica de roteamento inalteradas enquanto o postback de origem continua a ser acionado. Uma mudança por vez é a regra aqui. Se você alterar o funil e o postback ao mesmo tempo, não saberá qual parte causou uma queda na reportação.

Observe os primeiros eventos reais de perto. As primeiras 10 conversões são as mais informativas, pois mostram se o postback de origem continua a ser acionado sob tráfego normal em vez de um clique manual. Verifique os registros de eventos no Adgora em comparação com os logs de origem no Keitaro. Você está procurando consistência, não apenas uma linha de sucesso.

Fique de olho no nome da origem, nos valores dos parâmetros e no tempo. Se um conjunto de anúncios gera conversões, mas outro não, o problema pode estar na configuração da origem em vez do postback em si. Uma transferência ao vivo limpa significa que a mesma URL, os mesmos tokens e o mesmo padrão de identificador continuam a funcionar à medida que o volume de tráfego muda.

Se a sua mistura de campanhas incluir outros verticais, o hábito de reportação permanece o mesmo. Se você está enviando conversões para ofertas de namoro, construindo publicidade em cripto, ou comparando uma nova origem com tráfego antigo, mantenha os primeiros eventos ao vivo sob revisão até que os logs e registros concordem. Então continue observando o postback de origem, porque a primeira falha silenciosa geralmente aparece após o primeiro dia limpo, e não durante ele.