- Esistono limitazioni su ciò che posso caricare?
Esistono alcune limitazioni di cui tenere conto:
- Le singole richieste
batchinsertebatchupdatesono limitate a 1000 conversioni. - Il timestamp di una conversione non può risalire a più di 28 giorni prima del momento dell'invio.
- Puoi inviare conversioni solo a una configurazione Floodlight a cui il tuo profilo utente di Campaign Manager 360 ha accesso.
- Le singole richieste
- Devo utilizzare Campaign Manager 360 o Search Ads 360 per caricare le conversioni?
Consulta il Centro assistenza Search Ads 360 per un confronto dettagliato delle funzionalità offerte da entrambi i prodotti.
- Che cosa succede se inserisco la stessa conversione sia in Campaign Manager 360 sia in Search Ads 360?
Se inserisci la stessa conversione sia in Campaign Manager 360 che in Search Ads 360, le voci non verranno deduplicate. In questo caso, utilizza attività Floodlight separate.
- Quale API devo utilizzare per caricare le conversioni offline?
Per un'esperienza di sviluppo migliore e per accedere a funzionalità aggiuntive, ti consigliamo di utilizzare l'API Data Manager.
- Che cos'è un valore ordinale e come viene utilizzato?
I valori ordinali controllano il modo in cui vengono elaborate le conversioni duplicate. Se vengono inserite più conversioni con la stessa attività Floodlight, lo stesso ID configurazione Floodlight, lo stesso identificatore dell'utente e lo stesso timestamp di conversione, l'ordinale viene utilizzato per determinare se:
- Le conversioni vengono deduplicate e ne rimane solo una. Questo accade se tutte le conversioni hanno lo stesso valore ordinale.
- Le conversioni vengono elaborate singolarmente e vengono tutte conservate. Questo accade se tutte le conversioni hanno un valore ordinale diverso.
I valori stessi non devono essere significativi. In generale, l'utilizzo di un valore fisso (ad esempio
1) per tutte le conversioni consente la deduplicazione. L'utilizzo di un valore casuale o univoco per ogni conversione disattiverà questa opzione.- Come devo gestire gli errori nella risposta dell'API e per quali errori devo riprovare?
batchinsertebatchupdateelaborano le conversioni secondo il principio del "best effort": una richiesta batch può restituire una risposta HTTP200 OKmentre le singole conversioni all'interno del batch non vanno a buon fine. Controlla semprehasFailuresnella risposta ed esamina l'elencoerrors[]in ogni oggettoConversionStatus:INTERNAL(Riprova): si è verificato un errore temporaneo nei sistemi di Google durante l'elaborazione della conversione. La conversione non è stata inserita o aggiornata. Riprova a eseguire le conversioni non riuscite utilizzando il backoff esponenziale (ad esempio, iniziando dopo alcuni minuti e riprovando per diverse ore), mantenendo esattamente gli stessiordinal,timestampMicros,floodlightActivityIde identificatore utente o clic.NOT_FOUND(Riprova con ritardo): l'identificatore (gclid,dclid,matchIdomobileDeviceId) o la conversione esistente in fase di modifica non sono ancora stati trovati. Poiché l'elaborazione e l'indicizzazione di clic online, tag Floodlight e conversioni possono richiedere da 1 a 2 ore, riprova a caricare periodicamente le conversioniNOT_FOUND(ad esempio, ogni 1-3 ore, per un massimo di 6 ore). SeNOT_FOUNDpersiste dopo 6 ore, consulta le sezioni seguenti per le cause comuni in base al tipo di identificatore.INVALID_ARGUMENTePERMISSION_DENIED(non riprovare): i dati sulle conversioni non sono validi (ad esempio, un timestamp di conversione precedente a 28 giorni o un campo non valido) o il tuo profilo utente non dispone dell'autorizzazione per la configurazione Floodlight di destinazione. Non riprovare a eseguire queste conversioni senza risolvere il problema sottostante.
Se l'intera richiesta HTTP non va a buon fine con un errore del server
5xxo un errore di quota/limite di frequenza429, riprova a inviare la richiesta utilizzando il backoff esponenziale.Tentativi sicuri e deduplicazione: quando riprovi una conversione non riuscita con
INTERNALoNOT_FOUND(o dopo un timeout HTTP5xxin cui il risultato è sconosciuto), invia sempre esattamente gli stessiordinaletimestampMicros. Se una conversione è già stata registrata, Campaign Manager 360 la deduplica automaticamente in base aordinal, identificatore dell'utente, attività Floodlight e data di conversione.- Cosa significa quando un caricamento di
mobileDeviceIdnon va a buon fine a causa di un erroreNOT_FOUND? Le cause più comuni di questo errore sono:
mobileDeviceIdnon è valido.mobileDeviceIdnon è noto a Search Ads 360. Ciò significa che Campaign Manager 360 non ha ancora pubblicato un annuncio sul dispositivo.
- Cosa significa quando un caricamento di
gclidnon va a buon fine a causa di un erroreNOT_FOUND? Le cause più comuni di questo errore sono:
gclidnon è valido.gclidnon è associato a una campagna Search Ads 360 o a un elemento pubblicitario YouTube di Display & Video 360. Ciò può verificarsi se ilgclidè stato raccolto da un reindirizzamento dei clic di Google Ads che non è passato attraverso Search Ads 360 (ad es. clic sulle estensioni di località) o da un reindirizzamento dei clic sugli annunci di YouTube non associato a un elemento pubblicitario di YouTube di Display & Video 360.- Il clic associato a
gclidsi è verificato troppo tempo fa. Le conversioni possono essere inserite solo per i clic risalenti a non più di 60 giorni. - Il clic associato a
gclidsi è verificato troppo di recente. Ti consigliamo di ritardare di un'ora i caricamenti delle conversioni basate sugclidper assicurarti che ilgclidvenga elaborato e sia disponibile per la corrispondenza.
- Cosa significa quando un caricamento di
dclidnon va a buon fine a causa di un erroreNOT_FOUND? Le cause più comuni di questo errore sono:
dclidnon è valido.- Il clic associato a
dclidsi è verificato troppo tempo fa. Le conversioni possono essere inserite solo per i clic risalenti a non più di 60 giorni. - Il clic associato a
dclidsi è verificato troppo di recente. Ti consigliamo di ritardare di un'ora i caricamenti delle conversioni basate sudclidper assicurarti che ildclidvenga elaborato e sia disponibile per la corrispondenza.
- Cosa significa quando un caricamento di
matchIdnon va a buon fine a causa di un erroreNOT_FOUND? Le cause più comuni di questo errore sono:
matchIdnon è noto a Campaign Manager 360. Ciò può verificarsi se ilmatchIdè stato raccolto da una chiamata Floodlight che non è passata correttamente attraverso Campaign Manager 360 (assicurati che le chiamate Floodlight funzionino correttamente, incluso il parametro del tagmatchId).- La chiamata Floodlight associata a
matchIdnon conteneva un cookie. La chiamata Floodlight deve contenere un cookie / identificatore per consentire a Campaign Manager 360 di memorizzare correttamentematchId(ad es. l'utente potrebbe aver bloccato i cookie o disattivato la funzionalità). - La chiamata Floodlight associata a
matchIdè avvenuta troppo tempo fa. I caricamenti delle conversioni offline devono essere effettuati entro 60 giorni dalla chiamata Floodlight contenente ilmatchId. - La chiamata Floodlight associata a
matchIdè avvenuta troppo di recente. Ti consigliamo di ritardare di 2 ore i caricamenti delle conversioni basate sumatchIdper assicurarti che ilmatchIdvenga elaborato e sia disponibile per la corrispondenza.
- Le conversioni offline con un timestamp precedente alla creazione dell'attività Floodlight sono incluse nei report?
Il caricamento di conversioni offline con un timestamp precedente alla creazione dell'attività Floodlight potrebbe essere registrato come impressioni Floodlight e come conversioni non attribuite/attribuite, fino a 28 giorni prima del momento dell'invio. Tuttavia, questo comportamento non è garantito e non è consigliabile fare affidamento su di esso. La best practice consiste nel creare attività Floodlight prima del timestamp più recente di una conversione offline.
- Quale consenso è necessario per utilizzare l'inserimento delle conversioni offline per la creazione di elenchi del segmento di pubblico?
Oltre al consenso per i dati utente degli annunci, il campo
nonPersonalizedAddeve essere impostato esplicitamente sufalseper consentire la creazione di elenchi dei segmenti di pubblico.
Domande frequenti
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2026-10-20 UTC.
[null,null,["Ultimo aggiornamento 2026-10-20 UTC."],[],[]]