Domande frequenti sull'SDK Interactive Media Ads di Google


Perché non ricevo annunci per tutti i formati?
I tag annuncio di test sono impostati per restituire sempre annunci per le richieste valide. In questo modo, si agevola l'integrazione e il test della modalità di richiesta e rendering degli annunci da parte del player. Tuttavia, gli annunci non sono sempre disponibili in tutti i formati per il tuo sito, account o unità pubblicitaria. Se l'integrazione funziona correttamente per il tag di test, ma non per il tuo, la causa potrebbe essere una delle seguenti:
  • Pubblichi video nel formato non supportato nel tuo ambiente. Ad esempio, pubblichi annunci HTML5 solo su iOS o Android.
  • Se utilizzi Ad Manager, al momento il tuo ID publisher potrebbe non avere annunci mirati. Inoltre, assicurati di aver approvato le creatività e gli annunci pertinenti in Ad Manager.
  • Se utilizzi AdSense, i criteri di targeting per il tuo sito o la pagina di test potrebbero non avere annunci attivi. La causa più comune è l'utilizzo di siti web privati, non sottoposti a scansione.
  • Se utilizzi la Gestione dei partner di rete di Ad Exchange e descriptionURL non è impostato o non è nell'elenco di gestione dei domini di proprietà o gestiti, gli annunci non vengono pubblicati.
  • Controlla le soglie di minCPM definite in Ad Exchange Video. Un CPM abbastanza alto può comportare tassi di riempimento molto bassi. Per risolvere il problema, prova a rimuovere il minCPM o il parametro dell'unità pubblicitaria dalla richiesta di annuncio (ovvero, slotname) per verificare se questo influisce sul tasso di riempimento.
Che aspetto ha un buon descriptionUrl?
Per essere più efficaci, i contenuti della pagina a cui descriptionUrl rimanda non devono essere una raccolta di parole o frasi, ma 1-3 paragrafi che descrivono effettivamente i contenuti e il tuo ruolo nel fornire tali contenuti. Un metodo che si è rivelato efficace in passato è quello di eseguire l'unione dinamica dei contenuti della pagina descriptionUrl a partire da blocchi predefiniti. ad esempio alcune frasi sui contenuti, alcune sull'offerta del vostro sito e alcuni snippet predefiniti associati a ogni canale AdSense (ad esempio "Intrattenimento" o "Sport"). Di conseguenza, a ogni contenuto è associato un elemento descriptionUrl distinto, che fornisce informazioni generali (ad esempio descrittori di genere) e informazioni specifiche (contenuti relativi direttamente ai contenuti).

Il codice HTML dei metadati deve essere semplice, ad esempio:

<html>
  <head>
    <title>Domain.com - Your tag line here!</title>
  </head>
  <body>
    <h1>Descriptions</h1>
    <h2>About this Content</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
    <h2>About Domain.com</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
  </body>
</html>
  
Perché viene visualizzato l'errore "La risposta di un annuncio non contiene un tipo di annuncio valido"?
Questo errore solitamente si verifica perché nessun annuncio è stato scelto come target per la publisherId specifica (per il periodo di tempo specificato). Questa condizione può variare nel corso della giornata o più giorni, man mano che le campagne iniziano e finiscono. È necessario controllare che l'annuncio da impostare come target non sia scaduto e che i criteri di targeting dell'annuncio siano corretti. Se gli annunci vengono correttamente richiesti, ricevuti e visualizzati utilizzando il publisherId di test, puoi assicurarti che siano gestiti correttamente tramite publisherId in tempo reale quando gli annunci sono disponibili.
Hai un tag annuncio video di Ad Manager che posso utilizzare per i test?
I tag di esempio sono disponibili nella pagina dei tag di esempio.
Devo impostare adSlotWidth e adSlotHeight sugli stessi valori di sz nel mio tag annuncio Ad Manager?
Non necessariamente. adSlotWidth e adSlotHeight devono essere impostati sulla larghezza/altezza del player o dell'area in cui vuoi che vengano pubblicati gli annunci. Vengono utilizzati da AdSense per determinare quali annunci sono adatti a tale spazio. La coppia chiave-valore sz nel tag annuncio Ad Manager è un parametro di targeting e non influisce necessariamente sulla creatività pubblicata (maggiori informazioni di seguito).
Il tag annuncio dimostrativo ha un ottimo aspetto, ma quando lo cambio con il mio tag annuncio, non viene visualizzato alcun annuncio.
Assicurati che il traffico del tag annuncio sia richiesto. Il modo più semplice per saperlo è osservare il traffico HTTP. Se viene restituita un'immagine 1x1 pixel grey.gif in un blocco ancorato in HTML, devi controllare il targeting in Ad Manager.
Voglio richiedere annunci utilizzando lo stesso tag più di una volta, ma ricevo annunci solo per la prima richiesta. Come faccio a risolvere questo problema?
Quando richiedi annunci più di una volta, devi far sapere all'ad server che si tratta di richieste legittime e non di duplicati accidentali. L'SDK esegue questa operazione con due rapide chiamate API:
  1. Chiama destroy() sulla tua istanza AdsManager. Questo impedisce la riproduzione di eventuali post-roll quando effettui la chiamata di seguito a contentComplete(). Riceverai una nuova AdsManager quando effettuerai la tua prossima richiesta.
  2. Chiama contentComplete() sulla tua istanza AdsLoader. L'SDK viene reimpostato in modo che la nuova richiesta di annuncio non sembri un duplicato di quella precedente.
Dopo aver eseguito le due chiamate sopra riportate, puoi chiamare requestAds() sulla tua istanza AdsLoader per ricevere un altro insieme di annunci da riprodurre per il nuovo video.
Come faccio a richiedere annunci AdSense in overlay e a tutto spazio utilizzando l'SDK IMA?

Per richiedere gli annunci AdSense utilizzando l'SDK, devi prima ottenere un tag annuncio AdSense. Potete scoprire di più alla pagina AdSense per i video. Una volta ottenuto il tag, devi seguire questi passaggi per effettuare una richiesta di annuncio in overlay o a tutto spazio:

Annunci in overlay
  1. In AdsRequest, imposta le modalità di visualizzazione su NORMAL.
  2. Nel tag annuncio, aggiungi il parametro overlay=1.
Annunci a tutto spazio
  1. In AdsRequest, imposta le modalità di visualizzazione su FULLSCREEN.
  2. Nel tag annuncio, aggiungi il parametro overlay=0.
Quando faccio clic sul mio annuncio, viene visualizzato l'errore "URL di clickthrough non valido". Quale potrebbe essere la causa?
La causa più comune di questo errore è un URL di clickthrough con caratteri di escape non corretti. Se visualizzi questo errore, assicurati che il tuo URL di clickthrough sia correttamente sottoposto a escape nella risposta VAST.
Negli SDK Android e iOS esiste un modo per rendere cliccabile l'intero annuncio video?
Per quanto riguarda il monitoraggio dei clic per tutta la durata del video, l'esperienza standard degli spettatori che emergono dai video è che quando un utente tocca un video lo mette in pausa o ne attiva i controlli. Per evitare che gli utenti facciano involontariamente clic sugli annunci quando vogliono davvero accedere ai controlli del player, utilizza il pulsante Scopri di più per consentire agli utenti di fare clic su un annuncio e scoprire di più sul prodotto pubblicizzato.
Perché viene visualizzato il messaggio di errore "Documento VAST vuoto"?
Questo errore si verifica quando il tag annuncio restituisce un documento VAST vuoto, a indicare che l'annuncio non è stato pubblicato correttamente. Consulta il tuo account manager o rappresentante dell'ad server per capire perché il tag annuncio non funziona.
Posso modificare le dimensioni/il testo della casella Salta annuncio o di altri elementi dell'interfaccia utente?
Gli SDK IMA non supportano la modifica del layout, delle dimensioni o dei contenuti degli elementi UI. Per maggiori dettagli sugli elementi dell'interfaccia utente, consulta l'articolo AdsManager.uiElements.
Perché ricevo errori "Nessun metodo virtuale" durante il runtime?

I messaggi di errore simili ai seguenti sono causati dall'utilizzo di una versione precedente di Google Play Services che non include l'ID pubblicità.

No virtual method
getInfo()Lcom/google/android/gms/ads/identifier/AdvertisingIdClient$Info; in
class Lcom/google/android/gms/ads/identifier/AdvertisingIdClient; or its
super classes (declaration of 'com.google.android.gms.ads.identifier.AdvertisingIdClient'

Eseguire l'upgrade alla versione 4.0 o successiva (ma preferibilmente alla più recente) risolve il problema.

Posso utilizzare più thread per inizializzare e manipolare l'interfaccia utente?
No, tutta l'inizializzazione e la manipolazione dell'interfaccia utente devono essere eseguite sul thread principale. In Android, gli oggetti dell'interfaccia utente non sono sicuri per i thread. Per saperne di più, consulta la pagina Thread.