Domande frequenti

Esistono limitazioni su ciò che posso caricare?

Esistono alcune limitazioni di cui tenere conto:

  • Le singole richieste batchinsert e batchupdate sono 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.
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?

batchinsert e batchupdate elaborano le conversioni secondo il principio del "best effort": una richiesta batch può restituire una risposta HTTP 200 OK mentre le singole conversioni all'interno del batch non vanno a buon fine. Controlla sempre hasFailures nella risposta ed esamina l'elenco errors[] in ogni oggetto ConversionStatus:

  • 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 stessi ordinal, timestampMicros, floodlightActivityId e identificatore utente o clic.
  • NOT_FOUND (Riprova con ritardo): l'identificatore (gclid, dclid, matchId o mobileDeviceId) 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 conversioni NOT_FOUND (ad esempio, ogni 1-3 ore, per un massimo di 6 ore). Se NOT_FOUND persiste dopo 6 ore, consulta le sezioni seguenti per le cause comuni in base al tipo di identificatore.
  • INVALID_ARGUMENT e PERMISSION_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 5xx o un errore di quota/limite di frequenza 429, riprova a inviare la richiesta utilizzando il backoff esponenziale.

Tentativi sicuri e deduplicazione: quando riprovi una conversione non riuscita con INTERNAL o NOT_FOUND (o dopo un timeout HTTP 5xx in cui il risultato è sconosciuto), invia sempre esattamente gli stessi ordinal e timestampMicros. Se una conversione è già stata registrata, Campaign Manager 360 la deduplica automaticamente in base a ordinal, identificatore dell'utente, attività Floodlight e data di conversione.

Cosa significa quando un caricamento di mobileDeviceId non va a buon fine a causa di un errore NOT_FOUND?

Le cause più comuni di questo errore sono:

  • mobileDeviceId non è valido.
  • mobileDeviceId non è 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 gclid non va a buon fine a causa di un errore NOT_FOUND?

Le cause più comuni di questo errore sono:

  • gclid non è valido.
  • gclid non è associato a una campagna Search Ads 360 o a un elemento pubblicitario YouTube di Display & Video 360. Ciò può verificarsi se il gclid è 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 gclid si è verificato troppo tempo fa. Le conversioni possono essere inserite solo per i clic risalenti a non più di 60 giorni.
  • Il clic associato a gclid si è verificato troppo di recente. Ti consigliamo di ritardare di un'ora i caricamenti delle conversioni basate su gclid per assicurarti che il gclid venga elaborato e sia disponibile per la corrispondenza.
Cosa significa quando un caricamento di dclid non va a buon fine a causa di un errore NOT_FOUND?

Le cause più comuni di questo errore sono:

  • dclid non è valido.
  • Il clic associato a dclid si è verificato troppo tempo fa. Le conversioni possono essere inserite solo per i clic risalenti a non più di 60 giorni.
  • Il clic associato a dclid si è verificato troppo di recente. Ti consigliamo di ritardare di un'ora i caricamenti delle conversioni basate su dclid per assicurarti che il dclid venga elaborato e sia disponibile per la corrispondenza.
Cosa significa quando un caricamento di matchId non va a buon fine a causa di un errore NOT_FOUND?

Le cause più comuni di questo errore sono:

  • matchId non è noto a Campaign Manager 360. Ciò può verificarsi se il matchId è 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 tag matchId).
  • La chiamata Floodlight associata a matchId non conteneva un cookie. La chiamata Floodlight deve contenere un cookie / identificatore per consentire a Campaign Manager 360 di memorizzare correttamente matchId (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 il matchId.
  • La chiamata Floodlight associata a matchId è avvenuta troppo di recente. Ti consigliamo di ritardare di 2 ore i caricamenti delle conversioni basate su matchId per assicurarti che il matchId venga 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 nonPersonalizedAd deve essere impostato esplicitamente su false per consentire la creazione di elenchi dei segmenti di pubblico.