Questa guida mostra come avviare e utilizzare le diverse funzionalità dello strumento di controllo degli annunci.
Prerequisiti
Per utilizzare lo strumento di controllo degli annunci:
- Completa la Guida introduttiva.
- Utilizza l'SDK Google Mobile Ads versione 9.1.0 o successive.
- Aggiungi il tuo dispositivo come dispositivo di test. Lo strumento di controllo degli annunci viene avviato solo sui dispositivi di test.
Avvia lo strumento di controllo degli annunci
Lo strumento di controllo degli annunci può essere avviato da qualsiasi punto dell'app nei seguenti modi:
- Utilizza il gesto selezionato nell'UI di AdMob quando registri un dispositivo di test.
- A livello di programmazione utilizzando l'API fornita.
- Utilizza il pulsante di avvio dal menu di debug.
Avvio tramite gesti
Non sono necessarie modifiche all'app per avviare lo strumento di controllo degli annunci con un gesto. Esegui il gesto (doppio scorrimento o scuotimento) che hai configurato in AdMob per il dispositivo di test. Scopri di più
Dopo aver impostato un gesto nell'UI di AdMob (e aver atteso 15 minuti per la propagazione), l'app deve effettuare una richiesta di annuncio affinché l'SDK Google Mobile Ads riconosca l'impostazione del gesto. Se il gesto specificato non funziona, prova a caricare un annuncio, riavviare l'app e testare di nuovo il gesto.
Avvio a livello di programmazione
Lo strumento di controllo degli annunci può essere avviato anche a livello di programmazione:
Questa API funziona per i dispositivi di test registrati a livello di programmazione o nell'UI di AdMob.
Visualizzare e risolvere i problemi delle unità pubblicitarie
Una volta avviata, viene visualizzata la schermata principale dello strumento di controllo degli annunci, contenente un elenco di tutte le unità pubblicitarie nell'UI di AdMob associate all'ID app monetizzata con AdMob che hanno configurazioni di asta o mediazione:
Ti consigliamo di inizializzare l'SDK Google Mobile Ads prima di utilizzare lo strumento di controllo degli annunci.
Visualizzare i dettagli della struttura a cascata della mediazione per un'unità pubblicitaria
Tocca un'unità pubblicitaria per visualizzare il relativo log delle richieste SDK, che mostra in dettaglio la struttura a cascata della mediazione fino al punto in cui l'annuncio è stato riempito (o la struttura a cascata è terminata senza riempimento) per le ultime richieste di annunci.
Ogni richiesta può essere espansa utilizzando l'indicatore di divulgazione per mostrare i risultati della struttura a cascata della mediazione per quella richiesta, insieme a eventuali errori e latenze applicabili.
Per le origini annuncio di terze parti, i messaggi di errore vengono inviati direttamente dall'origine annuncio. Se hai bisogno di ulteriori informazioni, contatta l'origine annuncio di terze parti.
Visualizzare i dettagli dell'asta per un'unità pubblicitaria
Se non hai mai effettuato offerte, leggi la panoramica.
Nel log delle richieste SDK puoi visualizzare le origini annuncio per l'asta chiamate nella richiesta di annuncio. Tocca un'unità pubblicitaria nel log delle richieste SDK per visualizzare i dettagli di ogni origine annuncio nell'asta.
I risultati dell'asta vengono ordinati in modo da portare gli elementi su cui è possibile intervenire nella parte superiore dell'elenco:
Nella parte superiore è presente la rete pubblicitaria che ha vinto l'asta.
Di seguito sono riportate le reti pubblicitarie con problemi. Puoi seguire i passaggi per la risoluzione dei problemi.
Poi ci sono le reti pubblicitarie che non hanno restituito annunci o non hanno fatto offerte. Questo può essere il sintomo di molti problemi diversi relativi all'origine annuncio, in quanto potrebbe non aver fatto offerte a causa della sua configurazione o del processo decisionale. Puoi consultare la guida alla configurazione dell'origine annuncio o contattarla direttamente per ricevere assistenza.
Infine, nella parte inferiore dell'elenco sono presenti le reti pubblicitarie che hanno perso l'asta.
La struttura a cascata della mediazione può posizionare l'origine annuncio che ha vinto l'asta in base al suo valore eCPM.
Quando un'origine annuncio viene chiamata nella struttura a cascata della mediazione, può pubblicare annunci. Per scoprire di più su come funziona l'asta con la struttura a cascata della mediazione, consulta l'esempio 2 e l'esempio 3 delle origini annuncio per l'asta e con struttura a cascata in un gruppo di mediazione.
Debug avanzato delle unità pubblicitarie
Quando risolvi i problemi delle unità pubblicitarie, può essere utile esaminare la richiesta di annuncio e la risposta per identificare il punto in cui si verifica un errore o per condividerle con l'Assistenza Google per facilitare il debug. Tocca l'icona del menu nella parte superiore della catena della struttura a cascata e seleziona Condividi richiesta di annuncio e risposta per esportare l'intera richiesta e risposta dell'annuncio. In questo modo, non dovrai eseguire autonomamente le tracce di rete nella tua app.
Inoltre, puoi visualizzare i parametri delle aste di terze parti decodificati toccando l'opzione Parametro delle aste di terze parti nello stesso menu della stringa della richiesta. In questo modo, puoi visualizzare i dettagli dei parametri delle aste di terze parti che potrebbero presentare problemi, il che ti aiuta a eseguire il debug dell'app o a verificare che una rete stia raccogliendo correttamente i suoi indicatori.
Visualizzare gli adattatori disponibili
Fai clic sulla scheda Adattatori per visualizzare un elenco di tutti gli adattatori di terze parti associati alle origini annuncio nelle configurazioni di asta o mediazione nella tua app. Quindi, espandi le schede per visualizzare gli stati di inizializzazione e le versioni dell'SDK. Oltre agli adattatori di terze parti supportati, puoi visualizzare anche gli adattatori di eventi personalizzati.
Gli eventi personalizzati consentono ai publisher di utilizzare le reti pubblicitarie non supportate da AdMob. Gli eventi personalizzati si distinguono dagli adattatori di terze parti standard nell'elenco degli adattatori per i nomi delle classi univoci. Oltre a fornire il nome della classe e le informazioni sullo stato, lo strumento di controllo degli annunci mostra anche le etichette assegnate a questi eventi personalizzati nell'interfaccia web di AdMob.
Se l'adattatore non viene trovato o non viene inizializzato, consulta Risolvere i problemi rilevati con lo strumento di controllo degli annunci per ulteriori informazioni.
Testare le unità pubblicitarie
Se vuoi testare l'unità pubblicitaria senza doverla cercare nell'UI dell'app, lo strumento di controllo degli annunci supporta questa operazione direttamente dalla schermata dei dettagli dell'unità pubblicitaria. Inoltre, puoi testare più unità pubblicitarie contemporaneamente, caricare e visualizzare in modo asincrono le richieste di annunci di test ed eseguire test per una singola origine annuncio.
Test degli annunci
I test degli annunci dello strumento di controllo degli annunci descritti in questa sezione sono uno strumento ideale per verificare l'esperienza pubblicitaria di base e per convalidare la configurazione della mediazione quando vengono utilizzati con il test di una singola origine annuncio.
Quando sei pronto per testare l'unità pubblicitaria, tocca il pulsante Richiedi annuncio di test nella parte superiore della schermata dello strumento di controllo degli annunci per attivare il test degli annunci dello strumento di controllo degli annunci. I risultati dei test vengono visualizzati nel log delle richieste SDK sotto l'intestazione Richiesto dallo strumento di controllo degli annunci.
Test di una singola origine annuncio
Lo strumento di controllo degli annunci include una funzionalità per limitare le richieste di annunci nella tua app in modo da pubblicare annunci da una singola origine annuncio per l'asta o con struttura a cascata. In questo modo, puoi verificare di aver implementato correttamente l'adattatore di terze parti e che l'origine annuncio stia pubblicando annunci come previsto.
Per attivare questa funzionalità, attiva/disattiva l'opzione Test origine annuncio singola nella parte inferiore della schermata. Viene visualizzata la seguente finestra di dialogo per la selezione dell'origine annuncio:
Devi inizializzare l'SDK Google Mobile Ads per poter utilizzare il test di una singola origine annuncio.
Puoi quindi selezionare una singola origine annuncio da testare. Una volta selezionata un'origine annuncio, viene visualizzata la seguente schermata:
L'impostazione del test per un'origine annuncio singola si applica a tutte le richieste di annunci future che effettui nella stessa sessione. Tuttavia, non si applica agli annunci memorizzati nella cache in precedenza in quella sessione che non sono ancora stati mostrati. Ti consigliamo di forzare il riavvio dell'app quando applichi un test di un'origine annuncio singola per invalidare gli annunci memorizzati nella cache che potrebbero essere pubblicati anziché l'origine annuncio scelta che riceve una richiesta.
Dopo aver riavviato l'app, tutti i posizionamenti delle unità pubblicitarie tentano di mostrare un annuncio solo dalla rete selezionata. L'avvio dello strumento di controllo degli annunci quando è attivo il test di un'origine annuncio singola mostra l'origine annuncio di test attiva:
Nella modalità di test di un'origine annuncio singola, tutte le richieste di annunci tentano di utilizzare l'origine annuncio selezionata per soddisfare le richieste, indipendentemente dal fatto che l'origine annuncio sia stata configurata per l'asta o la mediazione per l'unità pubblicitaria richiesta. Se l'origine annuncio che stai testando non è nella struttura a cascata della mediazione per un'unità pubblicitaria, riceverai il messaggio di errore "Nessun riempimento".
Durante la prova di una singola origine annuncio, puoi toccare un'unità pubblicitaria per visualizzare il relativo log delle richieste SDK. In questo modo, puoi sapere se l'origine annuncio ha soddisfatto le richieste di annunci effettuate dopo l'attivazione della prova di una singola origine annuncio. Se l'origine annuncio non è riuscita a caricare un annuncio, viene visualizzato un messaggio di errore che descrive l'errore.
Se hai aggiunto più istanze dell'origine annuncio selezionata a una struttura a cascata della mediazione, vedrai ogni istanza della chiamata all'origine annuncio nella struttura a cascata fino al momento in cui l'annuncio non viene riempito o fino al termine della struttura a cascata senza un riempimento.
Interrompi il test di un'origine annuncio singola
Per interrompere il test, disattiva l'opzione:
Viene visualizzato un messaggio di conferma nella seguente schermata di riavvio:
Ti consigliamo di forzare il riavvio dell'app dopo aver interrotto il test per invalidare gli annunci memorizzati nella cache per l'origine annuncio testata.
Eseguire il debug delle impostazioni sulla privacy
Prerequisiti: SDK Google Mobile Ads versione 9.6.0 o successive
Puoi utilizzare lo strumento di controllo degli annunci per visualizzare i seguenti indicatori sulla privacy passati nella richiesta di annuncio nell'ambito dell' integrazione del publisher con il TCF di IAB Europe:
- Il GDPR si applica (
IABTCF_gdprApplies) - Stringa CA (
IABTCF_AddtlConsent) - Stringa TC (
IABTCF_TCString)
Dopo aver caricato un annuncio o eseguito il test degli annunci nello strumento di controllo degli annunci, tocca l'icona del menu nella richiesta in Log delle richieste SDK. Quindi, seleziona l'opzione Indicatori sulla privacy.
La schermata Indicatori sulla privacy mostra gli indicatori sulla privacy passati nella richiesta di annuncio.
Per scoprire di più sulla stringa CA, consulta la specifica tecnica del Consenso aggiuntivo di Google. Per visualizzare i dettagli granulari del consenso nella stringa TC, come l'ID CMP e l'elenco degli identificatori dei fornitori con consenso associati a IAB, fai clic su Decodifica per aprire il codificatore / decodificatore GPP di IAB.
Se riscontri errori, segui i passaggi descritti in Comprendere i problemi di privacy per risolverli.
Copiare tutti gli output di debug
Lo strumento di controllo degli annunci supporta la copia di una stringa JSON contenente tutti gli output di debug dallo strumento, inclusi i dettagli della tua app monetizzata con AdMob, gli stati di inizializzazione dell'adattatore e i risultati dei test di tutte le unità pubblicitarie.
Per farlo, tocca l'icona dell'app sette volte finché non visualizzi il messaggio JSON dello strumento di controllo degli annunci copiato negli appunti.