Come collegare il postback della fonte di traffico Keitaro a Adgora

Requisiti prima di iniziare

Prima di provare a collegare il postback della fonte di traffico Keitaro a Adgora, assicurati che entrambi gli account siano attivi e che tu possa modificare la fonte di traffico in Keitaro. Sembra semplice, ma è qui che molti setup si bloccano: un utente ha accesso admin in Adgora, ma solo accesso in visualizzazione in Keitaro, quindi il campo del postback rimane bloccato. Hai bisogno dell'account Adgora esatto in cui vuoi inviare eventi e hai bisogno dell'entry della fonte di traffico in Keitaro che riceve effettivamente i clic.

Controlla prima tre cose. Primo, la fonte di traffico Keitaro deve già esistere. Secondo, devi sapere quale offerta o campagna genererà l'evento di conversione. Terzo, hai bisogno degli identificatori che Adgora si aspetta nelle sue impostazioni dell'account. Se uno di questi manca, fermati lì e risolvi l'accesso prima di incollare un singolo URL.

In pratica, la configurazione più pulita è aprire entrambi gli strumenti in schede separate e confrontare il nome della fonte, il campo del postback e il campo dell'identificatore di clic affiancati. Un piccolo errore di battitura, un grande problema. Una fonte di traffico chiamata “Meta US” in Keitaro e “meta_us” in Adgora può comunque funzionare, ma solo se i parametri effettivi corrispondono, non l'etichetta che usi per tua comodità.

Se desideri un ripasso più ampio sui termini di reporting prima di inviare la richiesta, il glossario della pubblicità tecnologica può aiutarti con le parole di base che continuano a comparire negli schermi di tracciamento. Vale anche la pena controllare il resto delle guide sulla pubblicità crypto, monetizzazione & Ad-Tech se stai costruendo un stack di tracciamento più completo, perché la configurazione del postback raramente vive da sola.

Trova l'endpoint del postback di Adgora e i parametri richiesti

Il primo passo tecnico è copiare l'endpoint del postback di Adgora dall'area dell'account Adgora dove sono configurate le conversioni. Non indovinare l'URL. Non riutilizzare un postback di un altro account. Un singolo carattere nel percorso dell'endpoint può trasformare una conversione valida in un fallimento silenzioso, e i fallimenti silenziosi sono i peggiori perché sembrano “nessun traffico” invece di “configurazione errata.”

Adgora di solito si aspetta un endpoint di base più diversi parametri che identificano l'evento. In una configurazione di postback della fonte di traffico, quei parametri spesso includono un ID clic, un identificatore della fonte e un riferimento alla conversione. Keitaro deve inviare ciò che Adgora utilizza per collegare l'evento alla riga di origine corretta. Se la riga di origine è errata, la conversione finisce nel posto sbagliato o non arriva affatto.

Copia l'endpoint esattamente come mostrato in Adgora, poi annota quali macro Adgora elenca per la richiesta. Alcuni team tengono una nota testuale con l'endpoint, il metodo HTTP, i nomi dei parametri richiesti e eventuali valori opzionali come pagamento o stato. Quella nota fa risparmiare tempo in seguito, specialmente quando una seconda fonte di traffico ha bisogno dello stesso schema.

Se il tuo account Adgora è utilizzato per campagne crypto, la logica di configurazione è la stessa, che tu gestisca un network pubblicitario crypto per editori o qualcos'altro. Il postback ha comunque bisogno dei giusti identificatori. Non succede nulla di magico perché la campagna è legata alla crypto.

Crea l'URL del postback in Keitaro

Apri le impostazioni della fonte di traffico in Keitaro e trova il campo del postback o del callback di conversione per quella fonte. Incolla l'endpoint di Adgora lì, non nella casella del postback della campagna. Questa distinzione è importante. Il postback a livello di fonte invia dati dalla configurazione della fonte di traffico stessa, che è ciò di cui Adgora ha bisogno per la reportistica basata sulla fonte; il tracciamento a livello di campagna è un livello diverso e può creare confusione se li mescoli.

Ora mappa i token di Keitaro ai parametri di Adgora. Ad esempio, se Adgora si aspetta un ID clic, Keitaro deve passare il token che contiene quel valore di clic. Se Adgora si aspetta un nome della fonte o un ID della fonte, Keitaro dovrebbe inviare il token legato al record della fonte di traffico, non il nome della campagna. Mantieni la mappatura letterale. Mantienila noiosa.

Un'abitudine attenta fa risparmiare ore: scrivi l'URL finito in un editor di testo semplice prima di salvarlo in Keitaro. Poi confronta ogni parametro uno per uno. Un ampersand mancante, uno spazio copiato o un token racchiuso nelle parentesi sbagliate possono rompere la richiesta. Questo è particolarmente fastidioso quando l'URL sembra a posto a colpo d'occhio.

Alcuni team testano prima questo con una fonte a basso rischio, come una piccola campagna di test, prima di passare a acquisti più grandi. È sensato. Se stai lavorando anche con verticali di nicchia, come campagne per l'installazione di app mobili o offerte di forex e trading, la stessa logica di postback si applica ancora, anche se la pagina dell'offerta appare completamente diversa.

Abbina correttamente gli ID dei clic e gli identificatori delle fonti

Questa è la parte in cui le integrazioni di solito si rompono. Keitaro può ricevere molti ID, ma Adgora riconosce l'evento solo se l'esatto ID di clic o identificatore della fonte torna nel formato che si aspetta. Se l'ID è mancante, troncato o inviato con il nome del parametro sbagliato, Adgora non può collegare la conversione al clic originale.

Usa un unico schema di denominazione fin dall'inizio. Se la tua fonte è “fb_us_01” in Keitaro, mantieni la stessa logica nelle note di Adgora, nel tuo foglio di tracciamento e in qualsiasi documentazione interna. Un nome non corrispondente non interrompe sempre la richiesta, ma complica la risoluzione dei problemi da parte degli esseri umani. Tre etichette diverse per una fonte possono far perdere un pomeriggio.

Quando l'elenco dei parametri di Adgora include un campo ID clic, mappalo al token di Keitaro che memorizza l'identificatore di clic dal record di clic della fonte. Quando include un identificatore della fonte di traffico, passa il token della fonte, non il token della campagna. L'identificatore della fonte e l'identificatore di clic non sono la stessa cosa, e confonderli può far apparire una conversione valida mentre punta alla fonte sbagliata.

Per i team che confrontano i flussi basati su CPA, la stessa disciplina è importante anche tra i modelli di prezzo. Se stai ancora sistemando la logica dei report, l'articolo su CPC vs CPM vs CPA è un utile compagno, perché il postback ti dice solo cosa è successo; non spiega perché hai scelto quel modello in primo luogo.

Invia una conversione di prova e conferma la richiesta

Esegui una conversione di prova dopo che l'URL è stato salvato. Una. Non cinque. Attiva l'evento in modo controllato, poi controlla entrambi i sistemi. In Keitaro, apri il log della sorgente o della campagna e cerca la richiesta in uscita, il codice HTTP e l'URL finale che è stato inviato. In Adgora, cerca il record dell'evento corrispondente e il timestamp. Quei due timestamp dovrebbero essere vicini, anche se non identici al secondo.

Se Keitaro mostra una risposta 200 ma Adgora non mostra nulla, la richiesta ha raggiunto qualcosa, solo non il gestore dell'evento previsto. Se Keitaro mostra un codice 4xx, l'endpoint, il metodo o i nomi dei parametri sono probabilmente errati. Se la richiesta non appare mai nel log, il posizionamento del token in Keitaro è probabilmente errato, o il postback della sorgente non è mai stato salvato.

Usa un singolo clic di prova con una nota unica nel tuo registro. Ad esempio, “test manuale martedì, 14:20.” Questo ti dà una riga pulita da cercare in seguito. Un test disordinato con più clic e senza note appare affollato, ma è difficile da debug.

La frase come collegare il postback della sorgente di traffico Keitaro a Adgora diventa chiara solo quando puoi abbinare un clic sorgente, una richiesta in uscita e un evento all'interno di Adgora. Se tutti e tre si allineano, la configurazione è reale. Se uno manca, non procedere ancora.

Correggi gli errori di postback più comuni

Il posizionamento errato dei macro è l'errore più comune. Un token destinato ai dati della campagna viene incollato in un campo sorgente, oppure un token ID clic viene posizionato dove dovrebbe andare un ID sorgente. La richiesta viene comunque inviata, motivo per cui l'errore è facile da perdere. L'URL esiste, la conversione no.

La codifica dell'URL causa il prossimo strato di problemi. Se un parametro contiene caratteri speciali e il valore non è codificato nel modo in cui Adgora si aspetta, la richiesta potrebbe arrivare con parti danneggiate. Questo si verifica più spesso nei nomi sorgente, nelle note personalizzate o nei valori di reindirizzamento. Un segno più può diventare uno spazio. Una barra può dividere il campo. Piccoli caratteri, grande mal di testa.

Impostazioni del metodo errate causano anche fallimenti. Se Adgora si aspetta GET e Keitaro invia POST, o viceversa, l'endpoint potrebbe rifiutare la richiesta o ignorarla. Controlla il metodo in entrambi gli strumenti prima di cambiare qualsiasi altra cosa. Cambiare tre campi contemporaneamente rende impossibile sapere quale ha risolto il problema.

Parametri duplicati creano un altro pasticcio silenzioso. Due valori nello stesso campo possono far sì che un sistema legga il primo e un altro sistema legga l'ultimo. Mantieni un parametro per scopo. Se hai bisogno di testare un valore di fallback, fallo in una versione separata, non nell'URL live.

A volte il problema non è affatto l'URL. La sorgente di traffico in Keitaro può essere nominata in un modo, mentre l'entrata sorgente in Adgora si aspetta un altro account o un altro ID di rete. Questa discrepanza può far sembrare ogni richiesta “valida” ma atterrare nel posto sbagliato. Controlla la connessione dell'account prima di rielaborare il postback stesso.

Vai in diretta e monitora i primi eventi reali

Dopo che il test è passato, passa dal traffico di test al traffico reale senza cambiare il resto del funnel. Ciò significa che lasci l'offerta, il lander e la logica di instradamento intatti mentre il postback sorgente continua a attivarsi. Una modifica alla volta è la regola qui. Se modifichi il funnel e il postback insieme, non saprai quale parte ha causato un calo nel reporting.

Osserva attentamente i primi eventi reali. Le prime 10 conversioni sono le più informative, perché mostrano se il postback sorgente continua a attivarsi sotto traffico normale invece di un clic manuale. Controlla i registri degli eventi in Adgora rispetto ai log sorgente in Keitaro. Stai cercando coerenza, non solo una linea di successo.

Tieni d'occhio il nome sorgente, i valori dei parametri e il timing. Se un set di annunci genera conversioni ma un altro no, il problema potrebbe essere nella configurazione sorgente piuttosto che nel postback stesso. Un passaggio pulito in tempo reale significa che lo stesso URL, gli stessi token e lo stesso schema identificativo continuano a funzionare mentre il volume di traffico cambia.

Se il mix della tua campagna include altri settori, l'abitudine al reporting rimane la stessa. Che tu stia inviando conversioni per offerte di incontri, costruendo pubblicità crypto, o confrontando una nuova sorgente con traffico vecchio, continua a tenere sotto controllo i primi eventi dal vivo fino a quando i log e i registri non concordano. Poi continua a monitorare il postback sorgente, perché il primo fallimento silenzioso spesso si manifesta dopo il primo giorno pulito, non durante.