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.
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.
I controlli video nativi sono supportati con l'SDK HTML5?
No, l'SDK HTML5 non supporta i controlli nativi.
Viene visualizzato il messaggio "Impossibile eseguire "play" su "HTMLMediaElement": l'API può essere avviata solo da un gesto dell'utente" nella mia implementazione HTML5. Come faccio a risolvere questo problema?
Sui dispositivi mobili, devi chiamare adDisplayContainer.initialize() in seguito a un'azione utente, ad esempio un tocco. Se visualizzi questo errore, molto probabilmente lo stai chiamando in un contesto non avviato dall'utente. Tieni presente che deve essere il risultato diretto di un'azione dell'utente. Ad esempio, se rispondi a un evento "tocco" riproducendo un video e poi utilizzando l'evento "riproduci" del video player per chiamare initialize(), l'SDK restituisce questo errore. Devi chiamare initialize() come risultato dell'evento tocco stesso.
Come faccio a gestire i clic sull'annuncio?
Se utilizzi i controlli da tastiera per il player, potresti notare che non funzionerà più dopo i clic su adDisplayContainer. Ciò avviene perché, una volta fatto clic su un annuncio, lo stato attivo della tastiera passa all'iframe IMA. Per mantenere lo stato attivo della tastiera sul lettore di contenuti, utilizza l'evento CLICK per spostare di nuovo l'elemento attivo della tastiera nel contenitore desiderato. Per maggiori dettagli, consulta il seguente snippet:
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });