Errori e avvisi

Questa pagina illustra i diversi tipi di errori e avvisi che potresti riscontrare durante l'utilizzo dell'API Display & Video 360.

Errori dell'API

Le richieste all'API che non possono essere completate restituiscono un messaggio di errore. Le richieste che restituiscono errori vengono conteggiate ai fini della quota utente e verranno prese in considerazione prilikom pregleda zahtjeva za dodatnom kvotom. Le risposte di errore devono essere elaborate e gestite per evitare errori futuri.

Una risposta di errore ha il seguente formato e include un codice di risposta HTTP, un messaggio di errore e uno stato del codice RPC di Google:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

Di seguito è riportato un elenco di errori comuni dell'API, insieme all'azione consigliata da intraprendere se vengono restituiti:

Codice RPC Azione consigliata
400 INVALID_ARGUMENT Si è verificato un problema con la tua richiesta. Esamina il campo messaggio nella risposta all'errore e modifica la richiesta di conseguenza.
401 UNAUTHENTICATED Non è stato possibile autenticare correttamente la tua richiesta. Verifica di includere credenziali OAuth valide nella richiesta. Per ulteriori informazioni su questo argomento, consulta la nostra guida introduttiva.
403 PERMISSION_DENIED Non disponi delle autorizzazioni necessarie per completare la richiesta. Verifica che il tuo account utente disponga delle autorizzazioni appropriate per il partner o l'inserzionista pertinente.
404 NOT_FOUND Impossibile trovare la risorsa che stai tentando di recuperare. Verifica che l'ID che utilizzi sia corretto e per il tipo di risorsa recuperata.
409 ABORTED La risorsa che stai tentando di modificare è in fase di modifica altrove. Attendi qualche secondo, poi riprova a inviare la richiesta.
429 RESOURCE_EXHAUSTED Hai superato il limite di frequenza o la quota di richieste giornaliere. Esamina l'utilizzo delle API utilizzando la console API di Google e modifica il flusso di lavoro in modo che funzioni entro i limiti di quota esistenti. Per ulteriori informazioni, consulta la nostra pagina sull'ottimizzazione della quota.
500 INTERNAL L'API ha riscontrato un errore interno. Attendi qualche secondo, quindi riprova a inviare la richiesta. Se l'errore persiste, contatta l'assistenza.
504 DEADLINE_EXCEEDED L'API ha impiegato troppo tempo per completare la richiesta. Attendi qualche secondo, poi riprova. Se l'errore persiste, contatta l'assistenza.

Errori SDF

L'API Display & Video 360 utilizza un metodo asincrono per generare e scaricare file di dati strutturati (SDF). Per questo motivo, gli errori generati durante la generazione del file SDF vengono restituiti nell'attività di download del file SDF completata. Un'attività di download SDF che termina in error è contrassegnata come completata, ma ha un campo di errore compilato anziché un nome della risorsa multimediale nel campo response, come mostrato in questo esempio troncato:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

Se ricevi un messaggio di errore che puoi risolvere quando tenti di generare SDF, devi seguire le istruzioni riportate. Se il messaggio di errore non è chiaramente attuabile, consigliamo di intraprendere le seguenti azioni:

  • Verifica che l'utente disponga delle autorizzazioni appropriate per le risorse del partner o dell'inserzionista principale.
  • Verifica che gli ID forniti nel filtro siano accurati, corrispondano al tipo di risorsa previsto e rientrino nel contesto del ID principale specificato.
  • Assicurati di non superare il limite di venti attività di download di SDF contemporaneamente per utente.

Se continui a riscontrare errori, contatta l'assistenza per segnalare il problema.

Avvisi non bloccanti

Gli avvisi non bloccanti vengono assegnati agli elementi pubblicitari per indicare un problema che potrebbe influire sulla pubblicazione di un elemento pubblicitario. Avvisi simili vengono comunicati nell'interfaccia utente tramite un banner di notifica. Questi avvisi sono passivi e sono elencati nel campo warningMessages di un elemento pubblicitario.

Sebbene passivi, i problemi che causano questi avvisi possono influire sulla pubblicazione di un'elemento pubblicitario fino a impedirla del tutto.

Prevenzione

Molti problemi che causano avvisi non bloccanti possono essere evitati tramite la configurazione corretta delle impostazioni degli elementi pubblicitari, tra cui:

  • Campagna: se il periodo di pubblicazione di un elemento pubblicitario non è valido o se il periodo di pubblicazione dell'ordine di inserzione principale è scaduto, l'elemento pubblicitario genererà un avviso e non verrà pubblicato. Per evitare quest'ultimo problema, assicurati che il periodo di pubblicazione di un elemento pubblicitario non termini più tardi di quello dell'ordine di inserzione principale.
  • Creatività assegnate: se a un elemento pubblicitario non è assegnata una creatività valida, l'elemento pubblicitario genererà un avviso e non verrà pubblicato.
  • Targeting: se il targeting di un elemento pubblicitario non è assegnato correttamente, l'elemento pubblicitario potrebbe generare un avviso e la pubblicazione potrebbe essere interessata o addirittura impedita.

Se stai replicando le configurazioni da un elemento pubblicitario esistente, assicurati che l'elemento pubblicitario esistente non generi avvisi imprevisti.

Monitoraggio

I problemi che causano avvisi non bloccanti possono verificarsi mentre un elemento pubblicitario è in pubblicazione. Per assicurarti che i tuoi elementi pubblicitari vengano pubblicati correttamente, monitora gli elementi pubblicitari attivi per verificare la presenza di avvisi appena generati. Gli elementi pubblicitari possono essere recuperati collettivamente utilizzando la funzione advertisers.lineItems.list. Se un elemento pubblicitario genera un avviso imprevisto, devi risolvere il problema immediatamente per ridurre l'impatto sulla pubblicazione.

I problemi possono verificarsi anche se le impostazioni o il targeting di un elemento pubblicitario non sono stati modificati. Alcuni esempi sono la messa in pausa o la scadenza dell'ordine di inserzione principale e il ritiro degli elenchi di utenti o di altri tipi di targeting.