Panoramica
Usa questa guida se mancano eventi, le richieste non riescono o i dati di Ads Manager non coincidono con quelli aziendali. Parti da un singolo acquisto completato, un lead inviato o un'altra azione. Annota cosa è successo e quando, poi scegli la domanda più pertinente tra quelle qui sotto.
Un evento registra un'azione, ad esempio un acquisto. Il Pixel invia eventi dal browser di un visitatore; l'API delle conversioni (CAPI) li invia dal tuo server. Ads Manager raccoglie questi eventi in un'origine dati. L'attribuzione determina a quale annuncio assegnare il merito dell'azione. Una finestra di attribuzione stabilisce entro quanto tempo dall'interazione con un annuncio un'azione può essergli attribuita.
Domande frequenti
1. Da dove devo iniziare?
Individua l'azione che vuoi misurare, il sistema che la invia, l'account pubblicitario e l'ID del Pixel utilizzati. La tua configurazione potrebbe usare il Pixel, la CAPI, un'integrazione con un partner o una combinazione di questi strumenti. La CAPI richiede un ID del Pixel anche se non hai installato il Pixel nel browser.
Per la configurazione iniziale, consulta: Misurazione delle conversioni e Monitoraggio delle conversioni. Il tuo sviluppatore può consultare le guide su Pixel, CAPI ed eventi supportati. Mantieni le richieste e le chiavi CAPI sul tuo server.
Se un partner gestisce la tua integrazione, consulta la guida alla configurazione dei partner di misurazione o la guida alla configurazione dei partner di misurazione mobile. Per il collegamento a HubSpot, consulta: Configurare ChatGPT Ads in HubSpot.
Se la configurazione esiste già, verifica ogni passaggio:
L'azione ha generato l'invio di una richiesta di evento?
La richiesta ha restituito un errore o è stata accettata?
Puoi confermare che l'origine dati corretta ha ricevuto l'evento?
L'evento è stato attribuito a un annuncio nel report della campagna?
2. Ho installato il Pixel. Perché non vedo acquisti o lead?
Il Pixel può caricarsi senza inviare l'evento di acquisto o lead che ti serve. Chiedi al tuo sviluppatore di verificare una singola azione completata:
Controlla il nome dell'evento, l'ID del Pixel e la pagina o il callback che lo invia. Una visualizzazione di pagina non è un acquisto completato.
Verifica che il Pixel venga inizializzato prima di inviare l'evento, anche quando viene caricato da un gestore di tag.
Controlla la console del browser e la richiesta di rete. Il solo messaggio “attivato” di un gestore di tag non conferma che l'evento sia stato inviato. La modalità di debug del Pixel può essere d'aiuto.
Verifica se le scelte di consenso, i blocchi del browser o i criteri di sicurezza del tuo sito hanno impedito la richiesta.
Controlla le pagine accessibili dopo l'accesso, il checkout, i siti di prenotazione, i reindirizzamenti e i moduli incorporati. Un Pixel funzionante sulla pagina di destinazione non conferma che il monitoraggio funzioni anche altrove.
Se non è stata inviata alcuna richiesta, risolvi prima quel passaggio. Aspettare l'aggiornamento dei report non servirà. Consulta la guida alla risoluzione dei problemi del Pixel prima di aggiungere un'altra integrazione.
3. Cosa devo fare se un evento viene rifiutato, va in timeout o restituisce un errore del server?
Salva il codice di risposta, il messaggio di errore esatto, l'ora della richiesta e l'ID dell'evento. Chiedi al tuo sviluppatore di controllare il formato dell'evento, l'ID del Pixel e la chiave. Le richieste di eventi CAPI usano una chiave dell'API delle conversioni dello stesso account pubblicitario. Le richieste di configurazione, gestione e reportistica usano una chiave distinta, quella dell'API per gli inserzionisti. Non inviare chiavi API all'assistenza.
Nei batch CAPI, un solo evento non valido può causare il fallimento dell'intero batch.
La CAPI richiede l'ora originale dell'azione come timestamp Unix in millisecondi. L'evento deve risalire al massimo a 7 giorni prima e non può essere datato oltre 10 minuti nel futuro. Questo limite di invio è distinto dalla finestra di attribuzione. Non modificare l'ora di un vecchio evento per farlo accettare.
In caso di timeout o errore del server, potresti non sapere con certezza se l'evento è arrivato. Controlla la richiesta originale e le eventuali registrazioni di ricezione. Se riprovi a inviare la stessa azione, mantieni l'ID evento e il timestamp originali. Un nuovo ID potrebbe farla apparire come un'altra azione.
Indaga tempestivamente in caso di rifiuto o di richieste che continuano a non riuscire. La stima di 24–48 ore per la visualizzazione nei report non si applica a questi errori. Per i requisiti delle richieste, consulta: API delle conversioni.
4. Vedo che l'evento è stato accettato. Perché non compare nel report?
Il fatto che un evento sia stato accettato non significa che sia stato attribuito a un annuncio. Controlla cosa conferma la risposta e se la richiesta ha usato l'origine dati corretta. Nella CAPI, validate_only impostato su true verifica gli eventi senza salvarli.
Per un nuovo evento, il tuo sviluppatore può controllare gli eventi recenti, ove disponibili. Questa vista mostra un campione recente, non una cronologia completa né un risultato di attribuzione.
Se non riesci a verificare la ricezione, contatta l'assistenza fornendo la risposta originale e un evento di esempio. Indicaci quali controlli hai completato; non devi prima individuare la causa.
Se la ricezione è confermata, passa alla domanda 5. Non inviare di nuovo l'evento con nuovi ID solo perché il report della campagna non è cambiato.
Le conversioni attribuite possono richiedere circa 24–48 ore per comparire e i totali recenti possono cambiare durante l'elaborazione. Questo non garantisce che ogni evento accettato comparirà, né ne conferma la ricezione. Consulta: Misurare i risultati.
5. Gli eventi vengono ricevuti. Perché la campagna mostra ancora zero conversioni?
Prima di modificare l'integrazione, verifica:
L'origine dati prevista è collegata all'account corretto?
L'evento che invii corrisponde alla conversione impostata per la campagna? Per gli eventi personalizzati, controlla il tipo personalizzato e il nome esatto dell'evento. Non basta che l'etichetta visualizzata corrisponda.
La conversione corretta era stata associata alla campagna prima dell'attività che stai verificando?
L'azione è avvenuta dopo un clic o una visualizzazione dell'annuncio che soddisfa i criteri delle impostazioni di attribuzione?
Stai visualizzando la campagna, la colonna degli eventi, le date e il riferimento temporale del report corretti?
Le informazioni di abbinamento aiutano a collegare un evento a un annuncio, ma non ne garantiscono l'attribuzione. Conserva il riferimento al clic effettivo di OpenAI, oppref, per tutta la visita e includilo negli eventi del server quando disponibile. Non inventare mai un riferimento e non usare quello di un altro visitatore.
Controlla separatamente gli eventi del browser e quelli del server. Un riferimento o un campo cliente disponibile per il Pixel potrebbe mancare nell'evento del server.
L'obiettivo selezionato per una campagna ottimizzata per le conversioni non può essere modificato dopo la creazione. Per usare un obiettivo diverso, crea una nuova campagna. Gli eventi personalizzati non possono essere obiettivi di ottimizzazione. Consulta: Campagne ottimizzate per le conversioni.
Dopo aver corretto una mancata corrispondenza nella configurazione, verifica le nuove attività idonee. Non dare per scontato che la modifica corregga i report precedenti. Per le regole di abbinamento, consulta: Misurazione delle conversioni.
6. Perché Ads Manager, il nostro strumento di analisi e il nostro CRM mostrano dati diversi?
Confronta le stesse azioni con le stesse regole di reportistica. Il tuo CRM potrebbe conteggiare ogni acquisto; un report pubblicitario conteggia gli acquisti attribuiti a quella piattaforma. Piattaforme diverse possono attribuire lo stesso acquisto in modo diverso.
In Ads Manager, Conversioni somma le conversioni post-clic e quelle post-visualizzazione idonee quando la finestra di reportistica post-visualizzazione è di 1 giorno. Con una finestra post-visualizzazione di 0 giorni, conteggia solo le conversioni post-clic. Usa la stessa impostazione quando confronti i report.
Ad esempio, una persona fa clic su un annuncio, torna in seguito direttamente sul sito e acquista. Uno strumento potrebbe classificare la visita come “Traffico diretto”, mentre un altro attribuisce l'acquisto all'annuncio precedente. Questa differenza, da sola, non significa che l'acquisto sia stato conteggiato due volte.
Se le etichette delle sorgenti di traffico differiscono, controlla l'URL di destinazione e i parametri di monitoraggio usati durante quella visita. Le impostazioni attuali della campagna potrebbero essere diverse da quelle usate in precedenza.
Confronta:
Account, campagna, tipo di evento, filtri e livello di dettaglio del report.
Intervallo di date, fuso orario e riferimento delle date all'interazione con l'annuncio o alla conversione stessa.
Impostazioni post-clic e post-visualizzazione e metrica o colonna esatta selezionata.
Ritardi di elaborazione recenti, gestione dei duplicati, consenso e informazioni di abbinamento disponibili.
Conversioni modellate, ove disponibili, che possono differire dalle transazioni registrate direttamente.
Per i valori: valuta, unità e utilizzo dell'intero ordine o dei singoli articoli nel confronto.
Per i ricavi, confronta imposte, spedizione, sconti e commissioni. Verifica che le copie inviate dal browser e dal server riportino lo stesso valore dell'ordine. Vendite da ordini creati e ROAS degli ordini creati conteggiano solo gli eventi order_created attribuiti.
L'attività importata da GA4 include eventi provenienti dalle varie sorgenti di traffico della proprietà selezionata. Questi totali non rappresentano le conversioni attribuite alla campagna. Consulta: Collegare Google Analytics 4 ad Ads Manager di OpenAI.
Per i confronti tramite API, annota l'endpoint e imposta esplicitamente le opzioni di reportistica. Un'impostazione omessa potrebbe non corrispondere a quella di Ads Manager. I report possono anche includere eventi diversi: alcuni coprono gli obiettivi della campagna ma non altre azioni monitorate. L'assenza di un evento da un report non dimostra che non sia mai stato ricevuto.
Usa le stesse impostazioni per un confronto tra file CSV e conserva le esportazioni senza modificarle. Consulta Misurare i risultati per le visualizzazioni di Ads Manager e Reportistica per le opzioni API.
7. Usando il Pixel e la CAPI, un acquisto viene conteggiato due volte?
Per evitare di conteggiare due volte la stessa azione, usa lo stesso ID del Pixel, nome dell'evento e ID dell'evento nelle copie inviate dal browser e dal server. Il campo dell'ID evento è id nella CAPI ed event_id nel Pixel. Usa anche lo stesso nome dell'evento personalizzato su entrambi i lati.
Mantieni lo stesso ID quando riprovi a inviare un'azione; usa un nuovo ID per ogni azione diversa. Verifica la presenza di tag duplicati, caricamenti di pagina o callback ripetuti e integrazioni con partner che potrebbero già inviare l'evento.
Non inviare un duplicato per modificare il valore o le informazioni di abbinamento dell'evento originale. Verifica il comportamento descritto nella documentazione prima di tentare una correzione. Consulta: deduplicazione degli eventi del browser e del server.
8. Usiamo Shopify. Ci serve un'altra integrazione?
Controlla il collegamento a Shopify prima di aggiungere un'altra integrazione. Verifica l'account pubblicitario e il Pixel collegati, poi controlla quali eventi l'app invia per il tuo negozio.
Se usi anche tag personalizzati, codice nel checkout o un sistema di invio dal server, verifica se inviano gli stessi eventi. Le configurazioni di Shopify possono usare diverse combinazioni di monitoraggio tramite browser e server. Consulta: Configurare ChatGPT Ads per Shopify.
9. Come dobbiamo gestire il consenso e i test?
Invia solo i dati che hai il permesso di condividere e rispetta le scelte di consenso dei visitatori. Il tuo sviluppatore deve seguire le indicazioni dell'integrazione sul consenso e sui dati di abbinamento supportati, compresi gli eventuali requisiti di normalizzazione e hashing. Non rimuovere i controlli del consenso per aumentare le conversioni riportate o migliorare un punteggio.
Il consenso alla misurazione e opt_out hanno finalità diverse. L'opzione opt_out riguarda la personalizzazione; non blocca tutte le richieste di misurazione. Chiedi al tuo sviluppatore di verificare la gestione del consenso sia nelle integrazioni del browser sia in quelle del server.
Registra l'ora, il nome e l'ID di una singola azione di test. Verifica se è stata inviata, convalidata e ricevuta. Un test di implementazione riuscito non dimostra che un annuncio soddisfi i criteri per l'attribuzione.
L'opzione validate_only della CAPI verifica gli eventi senza salvarli. La modalità di debug del Pixel registra l'attività nei log, ma non esclude gli eventi di test dai report. Contrassegna i test nei tuoi registri e non inventare acquisti né modificare gli orari degli eventi per forzare un risultato.
10. Un punteggio di qualità degli eventi basso o non disponibile significa che il monitoraggio non funziona?
Non di per sé. La qualità degli eventi valuta le informazioni ricevute da un'origine dati. Non indica quante conversioni sono state attribuite agli annunci. Un punteggio basso o non disponibile, da solo, non permette di stabilire se il monitoraggio funziona.
Verifica che le azioni reali recenti vengano registrate correttamente, poi indaga sull'avviso. Non inviare eventi aggiuntivi o identificativi inventati per aumentare il punteggio. Per i controlli e i tempi di aggiornamento, consulta: Comprendere e migliorare la qualità degli eventi.
11. Quali informazioni devo fornire quando contatto l'assistenza?
Indicaci cosa ti aspettavi, cosa è successo, quando è iniziato il problema e quali controlli hai effettuato. Includi le informazioni di questo elenco che hai a disposizione:
ID dell'account pubblicitario, ID del Pixel o origine dati e identificativi delle campagne e degli annunci interessati.
Tipo di integrazione e nome esatto dell'evento, incluso l'eventuale nome dell'evento personalizzato.
Uno o due ID di eventi esistenti da usare come esempio e i timestamp delle azioni, con il fuso orario.
Per richieste non riuscite o di cui non è certa la ricezione: codice di risposta, messaggio di errore esatto, ora della richiesta, eventuale ID richiesta o CF-Ray restituito e un payload o un estratto del log con i dati sensibili oscurati.
Per le differenze nei report: intervallo di date, riferimento temporale dei report, impostazioni di attribuzione, colonne selezionate, esportazione CSV e un confronto relativo allo stesso ambito.
Screenshot pertinenti ed eventuali modifiche recenti alla configurazione, compreso l'uso di un checkout separato o di un'integrazione con un partner.
Indicaci se hai confermato che l'evento è stato inviato, accettato o ricevuto, oppure se hai controllato solo il report. Puoi chiedere aiuto anche se non riesci a completare questi controlli.
Rimuovi dagli allegati le chiavi API, le intestazioni di autorizzazione, le password, i cookie e le informazioni sui clienti non necessarie. Segnala tempestivamente gli errori o un'integrazione prima funzionante che smette all'improvviso di funzionare. Non aspettare che trascorra il tempo previsto per la visualizzazione nei report.
