Instalação Server-to-Server

Configurar o S2S é simples. Você vai criar um evento de conversão no seu painel, gerar uma URL de postback e configurar seu software de rastreamento para dispará-lo nas conversões. A Blockchain-Ads usa um parâmetro {clickid} exclusivo para combinar cliques com conversões perfeitamente.

Passo 1: Criar um Evento de Conversão

1. Faça login no seu painel do Blockchain-Ads HUB.
2. Navegue até Advertising > Tracking > Create Conversion.
3. Selecione Server to Server como método de rastreamento.
4. Preencha os detalhes do evento:
   
   • Event Name (Nome do Evento): por exemplo, "Purchase", "Lead" ou "Sign-Up".
   • Revenue Field (Campo de Receita) (opcional): Ative se estiver rastreando pagamentos ou valores de pedidos.
5. Clique em Save. Você receberá uma URL de postback exclusiva no formato:

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

• {clickid}: O ID exclusivo do clique original (retornado pelo seu rastreador).
• {revenue}: Marcador para o valor de conversão (por exemplo, 10.50 para R$10,50; omita se não usado).

6. Copie esta URL—é o seu endpoint para enviar dados de conversão.

Passo 2: Configurar Seu Software de Rastreamento

No seu rastreador ou plataforma de afiliados:

1. Adicione a Blockchain-Ads como fonte de tráfego.
   
   • Defina o Parâmetro Click ID como clickid. Isso captura o {clickid} anexado às URLs da sua campanha (por exemplo, https://your-landing-page.com/?clickid=xyz789).
2. Configure a URL de postback.
   
   • Cole a URL do Passo 1.
   • Mapeie os marcadores para as macros do seu rastreador:
     
     • {clickid} → Macro de ID de clique do seu rastreador (por exemplo, {external_id} ou {clickid}).
     • {revenue} → Sua macro de receita (por exemplo, {payout} ou {revenue}).
   • Exemplo para um rastreador genérico:

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

3. Defina regras de conversão:
   
   • Dispare postbacks em eventos como envios de formulários ou carregamentos de páginas de agradecimento.
   • Opcionalmente, passe parâmetros adicionais como status (por exemplo, &status=approved) ou currency (por exemplo, &currency=BRL).

Passo 3: Atualizar o Destino da Sua Campanha

1. Na Blockchain-Ads, edite sua campanha.
2. Defina a URL de Destino para o link de campanha do seu rastreador, garantindo que inclua a macro {clickid}:

https://your-tracker.com/campaign123?clickid={clickid}

3. Lance e teste (veja abaixo).

Passo 4: Testar a Integração

1. Crie uma campanha de teste com um orçamento baixo.
2. Clique no seu anúncio e simule uma conversão (por exemplo, complete uma oferta de teste).
3. Verifique:
   
   • Relatórios da Blockchain-Ads: Vá para Reports > Conversions—verifique se o ID do clique corresponde e a receita aparece.
   • Logs do Rastreador: Certifique-se de que o postback foi disparado com sucesso (sem erros 4xx/5xx).
4. Use ferramentas como Postman ou curl para testes manuais:

curl "https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid=TEST123&trackerid=abc123&transaction_value=5.00"

5. Espere uma resposta 200 OK.

Melhores Práticas para Rastreamento S2S

• Segurança: Use HTTPS para todos os postbacks. Adicione lista de permissões de IP se o seu rastreador suportar (contate support@blockchain-ads.com para nossas faixas de IP).
• Codificação: Codifique valores em URL (por exemplo, espaços se tornam %20) para evitar erros.
• Deduplicação: Inclua carimbos de data/hora ou IDs de transação exclusivos para evitar contagem dupla.
• Múltiplos Eventos: Crie eventos de conversão separados para diferentes ações (por exemplo, um para leads, um para vendas) e use postbacks condicionais.
• Tratamento de Erros: Monitore postbacks com falha—implemente tentativas (até 3 tentativas) no seu rastreador.
• Conformidade: Sempre divulgue o rastreamento em sua política de privacidade.
• Otimização: Use nossos Relatórios em Tempo Real para analisar dados S2S e ajustar lances dinamicamente.