Guia de Integração do Keitaro

Para configurar o rastreamento de conversões servidor a servidor (S2S) para a rede Blockchain-Ads usando o Keitaro, você vai configurar o Blockchain-Ads para gerar uma URL de postback (onde o Keitaro enviará os dados de conversão) e depois integrá-la como uma fonte de tráfego personalizada no Keitaro. Isso garante que o Keitaro capture o {clickid} do tráfego recebido e envie postbacks de volta ao Blockchain-Ads com IDs de clique correspondentes, receita e outros detalhes.

Passo 1: Criar o Evento de Conversão S2S no Blockchain-Ads

1. Faça login no seu painel do Blockchain-Ads HUB.
2. Navegue até Advertising > Tracking > Create Conversion > Server to Server.
3. Siga as instruções na tela para configurar o evento:
   
   • Nomeie o evento de conversão (por exemplo, "Lead" ou "Sale").
   • Especifique o tipo de evento (por exemplo, lead, purchase) e quaisquer campos de receita, se aplicável.
   • Isso gerará um ID de rastreador único para o seu evento e uma URL de postback no formato:

GET https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={clickid}&trackerid=YOUR_TRACKERID&transaction_value={transaction_value}

• {clickid}: Espaço reservado para o ID de clique único (o Blockchain-Ads corresponderá isso ao clique original).
• trackerid: Seu ID de evento fixo (não altere).
• {transaction_value}: Espaço reservado opcional para o valor da receita/pagamento (omita se não estiver rastreando receita).

Copie esta URL de postback completa—você precisará dela no Keitaro.

4. Salve o evento. Observação: Ao criar campanhas no Blockchain-Ads, defina sua URL de destino para a URL da sua campanha no Keitaro (por exemplo, https://seu-dominio-keitaro.com/campaign123?clickid={clickid}). O Blockchain-Ads adicionará automaticamente o valor real do ID de clique.

Passo 2: Adicionar o Blockchain-Ads como Fonte de Tráfego Personalizada no Keitaro

1. Faça login no seu painel do Keitaro.
2. Vá para Traffic Sources > Create.
3. No campo "From template", procure por "Blockchain-Ads"—se não houver modelo, selecione Custom ou deixe em branco para construir manualmente.
4. Preencha os detalhes básicos:
   
   • Name: "Blockchain-Ads".
   • Parâmetro Click ID: Defina como clickid (isso diz ao Keitaro para capturar o valor ?clickid=xxx recebido do tráfego do Blockchain-Ads e armazená-lo internamente como o ID externo para postbacks).
5. Na seção de modelo de parâmetros (se solicitado):
   
   • Adicione uma linha para o ID de clique:
     
     • Coluna 1 (Alias): Deixe em branco ou defina como "External ID" para relatórios.
     • Coluna 2 (Parameter name): clickid.
     • Coluna 3 (Macro): Deixe em branco (já que o Blockchain-Ads adiciona o valor real diretamente).
   • Adicione outros parâmetros se necessário (por exemplo, para ID de campanha ou subIDs de macros do Blockchain-Ads).
6. No campo S2S Postback:
   
   • Cole a URL de postback do Passo 1.
   • Substitua os espaços reservados do Blockchain-Ads pelos equivalentes do Keitaro:
     
     • {clickid} → {external_id} (passa o ID de clique capturado de volta).
   • Exemplo de URL transformada:

https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={external_id}&trackerid=YOUR_TRACKERID&transaction_value={revenue}

Se você quiser enviar apenas status de conversão específicos (por exemplo, leads aprovados), use o menu suspenso "Send only statuses" para selecioná-los (por exemplo, "Lead", "Sale").

7. Clique em Create para salvar a fonte de tráfego.
8. (Opcional) Se você tiver várias campanhas, marque Update in campaigns para aplicar isso às existentes.

Passo 3: Configurar uma Campanha no Keitaro e Testar

1. Vá para Campaigns > Create (ou edite uma existente).
2. Selecione Blockchain-Ads como Traffic Source.
3. Construa seu fluxo: Adicione streams, landing pages e ofertas. Para conversões:
   
   • Se usar ofertas de afiliados, configure postbacks da rede de afiliados para o Keitaro (em Affiliate Networks).
   • Defina regras de conversão (por exemplo, postback S2S da oferta, disparo de pixel ou eventos personalizados).
4. Gere e copie sua URL de campanha do Keitaro (parecerá com https://seu-dominio.com/abc?clickid={external_id}—cole isso como destino na sua campanha do Blockchain-Ads).
5. Teste:
   
   • Lance uma campanha de teste no Blockchain-Ads apontando para a URL do Keitaro.
   • Simule um clique e conversão (por exemplo, através de uma oferta de teste).
   • Verifique os relatórios do Keitaro (Reports > Conversions) para cliques/conversões capturados.
   • Verifique no rastreamento do Blockchain-Ads se os postbacks estão chegando (com IDs de clique e receita correspondentes).
   • Use ferramentas como Postman para disparar manualmente um postback de teste, se necessário.

Dicas e Solução de Problemas

• Espaços reservados no Keitaro: Use {external_id} para clickid, {revenue} para valores e {status} para tipos de eventos (por exemplo, mapeie "lead" para um status). Para valores não codificados, use o prefixo _ (por exemplo, {_external_id}).
• Receita/Moeda: Se as conversões tiverem moedas diferentes, use {revenue:USD} para converter.
• Erros: Garanta que use HTTPS para postbacks. Se os dados não fluem, verifique a codificação da URL, bloqueios de firewall ou ID de rastreador incompatível. O Keitaro registra tentativas de postback em Logs > Postbacks.
• Avançado: Para vários eventos, crie eventos de conversão separados no Blockchain-Ads e adicione várias URLs de postback no Keitaro (uma por status).

Essa configuração permite atribuição precisa sem cookies. Para mais detalhes sobre o Keitaro, consulte a documentação em docs.keitaro.io