Keitaro e la Meta API ufficiale: il tuo tracker accanto a un livello di campagne conforme
Lena Brandt
Ad Policy & Compliance Analyst
Tanti media buyer usano Keitaro e la Meta API ufficiale fianco a fianco. Il tracker registra clic, offerte e payout su un'infrastruttura che controllano loro, e un tool di campagne collegato tramite la Marketing API di Meta gestisce lanci, budget e regole. Questa guida spiega perché questa divisione ha senso, perché i due set di numeri raramente coincidono, come il metodo di connessione incide sul rischio per l'account e cosa cambia quando Keitaro sta dentro Wevion.
Risposta rapida: tieni Keitaro come registro di clic, offerte e payout, e gestisci le campagne con un tool che si collega alla Marketing API ufficiale di Meta con OAuth. Wevion mette entrambi nello stesso workspace: Keitaro si sincronizza ogni 15 minuti, le conversioni arrivano tramite postback S2S e le modifiche proposte da Wavo, il copilota AI, aspettano la tua approvazione.
Se usi già Keitaro e vuoi vedere come funziona l'integrazione in pratica, la pagina Keitaro e tracker elenca tutte le funzioni. Il resto dell'articolo spiega il ragionamento che c'è dietro.
Perché usare un tracker e un tool di campagne?
Un tracker e un tool di campagne rispondono a due domande diverse, ed è per questo che la maggior parte dei media buyer in affiliazione finisce per pagarli entrambi. Keitaro risponde a cosa è successo dopo il clic: quale offerta ha convertito, quale landing page ha tenuto l'attenzione, quale sub ID ha generato il payout e cosa ha confermato alla fine il network di affiliazione. Una piattaforma pubblicitaria risponde a cosa è successo prima del clic e al momento del clic, ed è l'unico posto in cui budget, offerte e audience cambiano davvero.
Nessuno dei due può fare il lavoro dell'altro. Keitaro non può alzare il budget di un ad set che sta macinando profitti. Ads Manager non vede il payout che il tuo network invia tre giorni dopo. Così il lavoro diventa due dashboard e un foglio di calcolo, con qualcuno che ogni mattina abbina a mano i nomi delle campagne.
Lo schema vale anche tra canali diversi. Quando un'offerta passa dal social al native, il tracker resta lo stesso mentre cambiano le sorgenti di traffico, un workflow che raccontiamo in come scalare un'offerta di affiliazione dal social al native senza toccare Keitaro.
Metti in pratica questa guida
Lancia, testa e scala le campagne su sei piattaforme pubblicitarie da un unico posto, con Wavo, il copilota AI, al tuo fianco. Gratis per 14 giorni.
Perché Keitaro e Meta non coincidono?
Keitaro e Meta raramente riportano lo stesso numero di conversioni, e questa differenza è normale, non il segno che uno dei due sia rotto. Ogni sistema misura dalla propria posizione, con le proprie regole su cosa conta e quando.
Le cause tipiche:
- Finestre di attribuzione. Meta attribuisce le conversioni all'interno della sua impostazione di attribuzione, che di default comprende 7 giorni dal clic e 1 giorno dalla visualizzazione, e una parte di queste conversioni è modellata. Keitaro conta i postback che riceve.
- Definizioni di clic. Un clic sul link in Meta non è lo stesso evento di un clic che il tuo tracker registra sulla landing page. Pagine lente e abbandoni prima che parta il redirect creano subito una differenza.
- Fusi orari. Un account pubblicitario impostato su un fuso orario e un tracker impostato su un altro dividono lo stesso giorno in modo diverso.
- Postback in ritardo. I network spesso confermano le conversioni ore o giorni dopo, quindi i numeri di ieri continuano a muoversi nel tracker quando la piattaforma si è già assestata.
- Parametri mancanti. Se l'ID della campagna, dell'ad set o dell'annuncio non arriva mai al tracker, una conversione può essere contata ma mai ricollegata a un annuncio.
Una regola che funziona è fidarsi del tracker per ricavi e payout, della piattaforma per spesa e delivery, e riconciliare i due sugli ID invece che sui nomi. La nostra storia di riconciliazione dei postback Keitaro mostra come un team ha trovato la causa di una discrepanza, e il protocollo di QA dei postback è una checklist per scoprire i collegamenti rotti prima che ti costino una settimana di dati.
Come dovrebbe collegarsi il tuo tool di campagne?
Il modo in cui un tool di campagne si collega ai tuoi account pubblicitari conta per il rischio sull'account più di quasi qualsiasi funzione offra. Ci sono due approcci principali, e si comportano in modo molto diverso.
API ufficiale con OAuth. Accedi con Meta, controlli i permessi che l'app Meta del tool richiede e li concedi. Il tool lavora poi tramite la Marketing API di Meta, la strada che Meta ha costruito per i software che gestiscono le ads. Nessuno ha la tua password, l'access token si può revocare dalle impostazioni di Meta e ogni modifica è una chiamata API documentata.
Tool basati su sessioni. Pilotano l'interfaccia di Ads Manager tramite una sessione del browser salvata, cookie memorizzati o un login condiviso. Possono arrivare a tutto ciò che una persona può cliccare, ma dipendono dal fatto che l'interfaccia resti uguale, conservano credenziali che non avrebbero mai dovuto lasciare il tuo browser, e i termini sulla raccolta automatizzata di dati di Meta limitano l'accesso automatizzato che avviene al di fuori delle sue API.
Le limitazioni dell'account sono il problema documentato, e vale la pena essere precisi. Meta applica le sue policy pubblicitarie a ogni account, qualunque tool lo gestisca, quindi nessun software può promettere che un account non verrà mai limitato. Quello che decide il metodo di connessione è se gli strumenti aggiungono un rischio proprio sopra a questo. Il nostro articolo su come Wevion si collega tramite OAuth con token cifrati entra nei dettagli.
Wevion si collega a Meta, Google, TikTok, Taboola, Snapchat e Outbrain tramite l'API ufficiale di ciascuna piattaforma, con OAuth su Meta, così nessuno condivide una password. I dati delle piattaforme si sincronizzano circa ogni 15 minuti, le regole girano con le cadenze che scegli e le modifiche proposte da Wavo, il copilota AI, aspettano che una persona le approvi prima che succeda qualsiasi cosa.
Un amministratore può anche incollare un token System User di Meta quando un setup lo richiede, anche se l'accesso con OAuth è la strada standard.
Una nota sul cloaking
Alcuni tracker includono un filtraggio del traffico che può essere usato per mostrare ai revisori degli annunci una pagina diversa da quella che vedono i visitatori reali. Gli Standard pubblicitari di Meta lo considerano un aggiramento dei suoi sistemi, ed è un motivo documentato di limitazione di account pubblicitari, Pagine e Business Manager. L'integrazione di Wevion legge i dati di tracking da Keitaro. Non instrada visitatori, non filtra il traffico e non cambia ciò che vede nessuno.
Keitaro dentro Wevion
Collegare Keitaro a Wevion mette i dati del tracker nello stesso workspace dei tuoi account pubblicitari, così la riconciliazione del mattino smette di essere un lavoro di copia e incolla. Ecco cosa fa oggi l'integrazione:
- La tua istanza. Incolla l'URL di Keitaro e la API key, testa la connessione, poi salva. La chiave viene conservata cifrata, e puoi revocarla da Keitaro in qualsiasi momento.
- Sincronizzazione ogni 15 minuti. La prima importazione recupera gli ultimi 30 giorni, e ogni esecuzione successiva è elencata nella Cronologia sincronizzazioni, comprese quelle fallite con il relativo errore.
- Cinque tabelle sincronizzate. Campagne, offerte, landing page, sorgenti di traffico e network di affiliazione si sincronizzano ognuno nella propria tabella.
- Mappatura delle campagne. I parametri di Keitaro si mappano su campagne, ad set e annunci Meta, abbinati per ID o per nome. Le regole di mappatura si possono rilevare in automatico, un parametro di riserva recupera i casi mancati e la copertura mostra cosa resta da mappare.
- Breakdown. Clic, conversioni, ricavi, costi, profitto, ROI e tasso di conversione per sub ID, offerta, landing page e area geografica.
- Postback S2S. Le conversioni inviate a Wevion tramite postback server-to-server vengono salvate una sola volta per transaction ID e compaiono accanto alle tue campagne Meta nella vista Ads Manager di Wevion.
- Accesso del team. Ogni membro del team si mappa su uno o più utenti Keitaro, così i permessi che ha in Keitaro si portano dietro. Owner e admin vedono tutto; qualsiasi altro membro senza mappatura non vede proprio il tracker.
La stessa pagina Tracker collega Voluum, RedTrack, BeMob, Binom, ClickFlare ed Everflow, quindi l'approccio non dipende dal tracker che il tuo team ha scelto.
Regole su una sincronizzazione di 15 minuti
L'automazione su un ciclo di dati di 15 minuti funziona meglio quando le regole proteggono la spesa su ore e giorni invece di inseguire singole conversioni. In Wevion i dati delle piattaforme pubblicitarie si sincronizzano circa ogni 15 minuti, e ogni regola gira con la propria cadenza: ogni 30 minuti di default, fino a ogni 15 minuti o al massimo una volta al giorno. Le regole agiscono solo alle condizioni che imposti.
Questo ritmo si adatta ai lavori in cui le regole sono brave:
- Mettere in pausa un ad set che ha superato la tua soglia di spesa senza conversioni in tre giorni.
- Ridurre un budget quando il costo per acquisizione resta sopra il target per una finestra di sette giorni.
- Limitare le modifiche all'orario di lavoro, così niente si muove quando nessuno guarda.
Ogni regola si può testare con un dry run che mostra cosa intercetterebbe senza cambiare nulla. I cooldown impediscono a una regola di agire di nuovo troppo presto sulla stessa entità, un limite giornaliero ne contiene le esecuzioni, e lo storico delle esecuzioni registra lo stato di ogni entità prima e dopo. I suggerimenti di Wavo, il copilota AI, seguono lo stesso principio: lui propone, tu confermi.
Tieni un'abitudine dal mondo dei tracker. Quando Keitaro racconta una storia diversa dalla metrica della piattaforma che una regola legge, controlla mappatura e postback prima di fidarti della regola. La nostra guida su come affidare le regole Meta ads a un passaggio di approvazione mostra come costruire questa fiducia per gradi.
Il costo dello stack, onestamente
Calcolare il costo reale di un setup con tracker e tool di campagne significa guardare oltre le fatture. Le voci degli abbonamenti si trovano facilmente. Quelle costose di solito sono quelle che nessuno scrive.
Un foglio di calcolo onesto comprende:
- Costi di gestione del tracker. Un Keitaro self-hosted ha bisogno di un server, di domini, di SSL e di qualcuno che lo tenga aggiornato.
- Costi del tool di campagne. L'abbonamento, più il tempo per far entrare e uscire ogni buyer.
- Tempo di riconciliazione. Ore a settimana passate ad abbinare a mano le righe del tracker con quelle della piattaforma.
- Costi delle limitazioni. Fermi, ricorsi, audience da ricostruire e storico del pixel perso quando un account viene limitato. I tool che si basano su login condivisi o sessioni scriptate tendono a gonfiare questa voce, anche se non compare mai in una fattura.
- Rischio sugli accessi. Il lavoro di reimpostare le credenziali quando qualcuno se ne va, se l'accesso è mai stato condiviso tramite password.
Compilalo con i tuoi numeri per un mese. La maggior parte dei team scopre che le voci di riconciliazione e limitazioni pesano più degli abbonamenti, ed è l'argomento più forte per tenere tracking e campagne su connessioni ufficiali, in un unico posto.
Punti chiave
- Keitaro e una piattaforma pubblicitaria rispondono a domande diverse, quindi usarli entrambi è normale.
- Aspettati che i loro numeri divergano; riconcilia sugli ID mappati, non sui nomi delle campagne.
- Il modo in cui un tool si collega conta per il rischio: API ufficiale e OAuth, non login condivisi o sessioni scriptate.
- Il cloaking è una violazione delle policy documentata, non una funzione da confrontare.
- Le regole su una sincronizzazione di 15 minuti devono proteggere la spesa su più ore ed essere testate prima con un dry run; Wavo, il copilota AI, propone modifiche che approvi tu.
Esplora di più in
Confronto piattaforme
Leggi la pillar page con tutte le guide su questo topic, dalle basi al livello avanzato.