Guida all'Integrazione di Keitaro

Per configurare il tracciamento delle conversioni server-to-server (S2S) per la rete Blockchain-Ads utilizzando Keitaro, configurerai Blockchain-Ads per generare un URL di postback (dove Keitaro invierà i dati di conversione) e poi lo integrerai come sorgente di traffico personalizzata in Keitaro. Questo garantisce che Keitaro catturi il {clickid} dal traffico in entrata e invii postback a Blockchain-Ads con ID clic corrispondenti, entrate e altri dettagli.

Passaggio 1: Creare l'Evento di Conversione S2S in Blockchain-Ads

1. Accedi alla dashboard di Blockchain-Ads HUB.
2. Vai a Advertising > Tracking > Create Conversion > Server to Server.
3. Segui le istruzioni sullo schermo per configurare l'evento:
   
   • Assegna un nome all'evento di conversione (ad esempio, "Lead" o "Sale").
   • Specifica il tipo di evento (ad esempio, lead, purchase) e eventuali campi di entrata se applicabile.
   • Questo genererà un ID tracker univoco per il tuo evento e un URL di postback nel formato:

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

• {clickid}: Segnaposto per l'ID clic univoco (Blockchain-Ads lo abbinerà al clic originale).
• trackerid: Il tuo ID evento fisso (non modificarlo).
• {transaction_value}: Segnaposto opzionale per l'importo delle entrate/pagamento (ometti se non tracci le entrate).

Copia questo URL di postback completo—ne avrai bisogno in Keitaro.

4. Salva l'evento. Nota: Quando crei campagne in Blockchain-Ads, imposta il tuo URL di destinazione sull'URL della campagna Keitaro (ad esempio, https://your-keitaro-domain.com/campaign123?clickid={clickid}). Blockchain-Ads aggiungerà automaticamente il valore reale dell'ID clic.

Passaggio 2: Aggiungere Blockchain-Ads come Sorgente di Traffico Personalizzata in Keitaro

1. Accedi alla dashboard di Keitaro.
2. Vai a Traffic Sources > Create.
3. Nel campo "From template", cerca "Blockchain-Ads"—se non esiste un template, seleziona Custom o lascia vuoto per costruire manualmente.
4. Compila i dettagli di base:
   
   • Name: "Blockchain-Ads".
   • Parametro Click ID: Impostalo su clickid (questo indica a Keitaro di catturare il valore ?clickid=xxx in entrata dal traffico Blockchain-Ads e memorizzarlo internamente come ID esterno per i postback).
5. Nella sezione del template dei parametri (se richiesto):
   
   • Aggiungi una riga per l'ID clic:
     
     • Colonna 1 (Alias): Lascia vuoto o imposta su "External ID" per il reporting.
     • Colonna 2 (Parameter name): clickid.
     • Colonna 3 (Macro): Lascia vuoto (poiché Blockchain-Ads aggiunge direttamente il valore reale).
   • Aggiungi altri parametri se necessario (ad esempio, per l'ID campagna o subID dai macro di Blockchain-Ads).
6. Nel campo S2S Postback:
   
   • Incolla l'URL di postback dal Passaggio 1.
   • Sostituisci i segnaposto di Blockchain-Ads con gli equivalenti di Keitaro:
     
     • {clickid} → {external_id} (passa l'ID clic catturato).
   • Esempio di URL trasformato:

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

Se desideri inviare solo stati di conversione specifici (ad esempio, lead approvati), utilizza il menu a discesa "Send only statuses" per selezionarli (ad esempio, "Lead", "Sale").

7. Fai clic su Create per salvare la sorgente di traffico.
8. (Opzionale) Se hai più campagne, seleziona Update in campaigns per applicare questo alle campagne esistenti.

Passaggio 3: Configurare una Campagna in Keitaro e Testare

1. Vai a Campaigns > Create (o modifica una esistente).
2. Seleziona Blockchain-Ads come Traffic Source.
3. Costruisci il tuo flusso: Aggiungi stream, landing page e offerte. Per le conversioni:
   
   • Se utilizzi offerte di affiliazione, configura i postback dalla rete di affiliazione a Keitaro (sotto Affiliate Networks).
   • Definisci le regole di conversione (ad esempio, postback S2S dall'offerta, attivazione di pixel o eventi personalizzati).
4. Genera e copia il tuo URL della campagna Keitaro (apparirà come https://your-domain.com/abc?clickid={external_id}—incollalo come destinazione nella tua campagna Blockchain-Ads).
5. Test:
   
   • Lancia una campagna di test in Blockchain-Ads che punta all'URL Keitaro.
   • Simula un clic e una conversione (ad esempio, tramite un'offerta di test).
   • Controlla i report di Keitaro (Reports > Conversions) per clic/conversioni catturati.
   • Verifica nel tracciamento di Blockchain-Ads che arrivino i postback (con ID clic ed entrate corrispondenti).
   • Utilizza strumenti come Postman per attivare manualmente un postback di test se necessario.

Suggerimenti e Risoluzione dei Problemi

• Segnaposto in Keitaro: Usa {external_id} per clickid, {revenue} per gli importi e {status} per i tipi di evento (ad esempio, mappa "lead" a uno stato). Per valori non codificati, usa il prefisso _ (ad esempio, {_external_id}).
• Entrate/Valuta: Se le conversioni hanno valute diverse, usa {revenue:USD} per convertire.
• Errori: Assicurati di utilizzare HTTPS per i postback. Se i dati non fluiscono, controlla la codifica dell'URL, i blocchi del firewall o l'ID tracker non corrispondente. Keitaro registra i tentativi di postback in Logs > Postbacks.
• Avanzato: Per più eventi, crea eventi di conversione separati in Blockchain-Ads e aggiungi più URL di postback in Keitaro (uno per stato).

Questa configurazione consente un'attribuzione accurata senza cookie. Per ulteriori dettagli su Keitaro, consulta la loro documentazione su docs.keitaro.io