Strumento di controllo degli annunci

Strumento di controllo degli annunci è un overlay in-app che consente ai dispositivi autorizzati di eseguire l'analisi in tempo reale delle richieste di annunci di test direttamente all'interno di un'app mobile. Può essere abilitata senza dover scrivere codice.

Per gli annunci per dispositivi mobili Unity 7.0.0 e versioni successive, puoi:

• Controlla le unità pubblicitarie
• Ispeziona gli adattatori di terze parti
• Verificare se gli annunci vengono riempiti come previsto
• Identificare gli errori e visualizzare i dettagli su come risolverli.
• Visualizzare insieme i dettagli dell'asta e della mediazione a cascata per ciascuna rete pubblicitaria per richiesta
• Testare singole origini annuncio per l'asta e la mediazione di terze parti

• Verifica di aver configurato correttamente ogni unità pubblicitaria per l'asta e la mediazione con struttura a cascata

• Testare le integrazioni di eventi personalizzati

Questa guida illustra come lanciare e utilizzare le diverse funzionalità nello strumento di controllo degli annunci.

Prerequisiti

Per utilizzare lo strumento di controllo degli annunci, devi:

• Crea un account AdMob e configura un'app.

• Completa la Guida introduttiva.

• Utilizza la Unity versione del plug-in 7.0.0 o successiva degli annunci per dispositivi mobili.

• Aggiungi il dispositivo come dispositivo di test. Lo strumento di controllo degli annunci viene avviato solo sui dispositivi di test.

Lancia lo strumento di controllo degli annunci

Lo strumento di controllo degli annunci può essere avviato da qualsiasi punto dell'app nei seguenti modi:

1. Utilizza il gesto selezionato nell'interfaccia utente di AdMob durante la registrazione di un dispositivo di test.
2. In modo programmatico utilizzando l'API fornita.
3. Utilizza il pulsante di avvio dal menu di debug.

Avvia con i gesti

Per avviare lo strumento di controllo degli annunci con un gesto, non sono necessarie modifiche all'app; esegui semplicemente il gesto (due volte o scuoti) che hai configurato in AdMob per il dispositivo di test. Scopri di più

Dopo aver impostato un gesto nell'interfaccia utente di AdMob (e aver atteso 15 minuti per la sua propagazione), la tua app deve effettuare una richiesta di annuncio per consentire all'SDK Google Mobile Ads di conoscere le impostazioni del gesto. Se il gesto specificato non funziona, prova a caricare un annuncio, a riavviare l'app e a testare di nuovo il gesto.

Lanciare in modo programmatico

Lo strumento di controllo degli annunci può essere lanciato anche in modo programmatico:

public void OnButtonClick() {
  MobileAds.OpenAdInspector(error => {
    // Error will be set if there was an issue and the inspector was not displayed.
  });
}

Questa API funziona per i dispositivi di test registrati in modo programmatico o nell'interfaccia utente di AdMob.

Visualizzazione e risoluzione dei problemi relativi alle unità pubblicitarie

Una volta avviata l'app, viene visualizzata la schermata principale dello strumento di controllo degli annunci, che contiene un elenco di tutte le unità pubblicitarie nell'interfaccia utente di AdMob associata all'ID dell'app AdMob con configurazioni di asta o mediazione:

Ti consigliamo di iniziare 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 dell'SDK, che fornisce dettagli sulla struttura a cascata della mediazione fino al momento in cui l'annuncio è stato riempito (o la struttura a cascata ha terminato senza un 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 tale richiesta, insieme a eventuali errori e latenza applicabili alla richiesta.

Per le origini annuncio di terze parti, i messaggi di errore vengono inviati direttamente dall'origine annuncio. Per saperne di più, consulta l'origine annuncio di terze parti.

Visualizzare i dettagli delle offerte per un'unità pubblicitaria

Se non hai mai utilizzato le offerte, leggi la panoramica.

Nel log delle richieste dell'SDK puoi vedere le bidding origini annuncio chiamate nella richiesta di annuncio. Tocca un'unità pubblicitaria nel log delle richieste dell'SDK per visualizzare i dettagli di ogni origine annuncio nell'asta bidding .

I risultati bidding vengono ordinati in modo da avvicinare le voci utilizzabili all'inizio dell'elenco:

• Nella parte superiore viene visualizzata la rete pubblicitaria che ha vinto l'asta.

• Poi ci sono le reti pubblicitarie con problemi. Puoi seguire la procedura di risoluzione dei problemi.

• Poi ci sono le reti pubblicitarie in cui non sono stati restituiti annunci o non hanno fatto offerte. Questo è un possibile indicatore di molti problemi diversi con l'origine annuncio, in quanto potrebbe non avere offerte a causa della sua configurazione o del suo processo decisionale. Puoi fare riferimento alla guida alla configurazione dell'origine annuncio oppure contattare direttamente l'origine annuncio per ricevere assistenza.

• Infine, in fondo all'elenco sono indicate le reti pubblicitarie che hanno perso l'asta dibidding .

  

La struttura a cascata della mediazione può posizionare l'origine annuncio che ha vinto l'astabidding in base al proprio 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 di origini annuncio per l'asta e con struttura a cascata in un gruppo di mediazione.

Debug avanzato delle unità pubblicitarie

Durante la risoluzione dei problemi relativi alle unità pubblicitarie, può essere utile analizzare la richiesta di annuncio e la risposta per identificare dove si è verificato un errore oppure condividere con l'Assistenza Google per facilitare il debug. Tocca l'icona del menu in alto nella struttura a cascata e seleziona Condividi richiesta e risposta di annuncio per esportare l'intera richiesta e risposta di annuncio. In questo modo puoi evitare di dover eseguire tracce di rete sulla tua app.

Nota: puoi esportare la risposta all'annuncio solo dopo aver aggiunto il dispositivo di test nell'UI di AdMob.

Inoltre, puoi visualizzare i parametri delle offerte di terze parti decodificati toccando l'opzione Parametro di offerta di terze parti nello stesso menu della stringa della richiesta. Forniscono dettagli su quali parametri delle offerte di terze parti potrebbero presentare problemi, aiutandoti a eseguire il debug della tua app o a verificare che una rete stia raccogliendo correttamente i suoi indicatori.

Android

iOS

Visualizza 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 offerta o mediazione nella tua app. Quindi, espandi le schede per visualizzare i relativi stati di inizializzazione e le versioni dell'SDK. Oltre agli adattatori di terze parti supportati, puoi anche visualizzare adattatori evento personalizzati. Gli eventi personalizzati consentono ai publisher di utilizzare reti pubblicitarie AdMob non supportate. Gli eventi personalizzati si distinguono dagli adattatori standard di terze parti nell'elenco degli adattatori per i nomi univoci delle classi. 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'AdMob interfaccia web.

Se l'adattatore non viene trovato o non viene inizializzato, consulta Risolvere i problemi rilevati utilizzando lo strumento di controllo degli annunci per ulteriori informazioni.

Android

iOS

Nota: implementazioni precedenti di eventi personalizzati, precedenti all'API versione v20.0.0 (Android) e v9.0.0 (iOS), le API deprecate delle sottoclassi non supportano l'inizializzazione e vengono visualizzate come Problema rilevato nello strumento di controllo degli annunci. Se vedi questo avviso nello strumento di controllo degli annunci, anche se l'integrazione degli eventi personalizzati sembra funzionare, verifica se la tua app utilizza interfacce deprecate come CustomEventBanner (Android) | GADCustomEventBanner (iOS) e sostituiscile con la nuova classe Adapter (Android) | GADMediationAdapter (iOS) .

Test delle unità pubblicitarie

Se vuoi testare l'unità pubblicitaria senza doverla aprire nell'interfaccia utente 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 e persino eseguire test di una singola origine annuncio.

Importante: quando esegui uno di questi test dello strumento di controllo degli annunci, le richieste non includono un numero di parametri che verrebbero attivati nell'interfaccia utente dell'app, tra cui la configurazione del trattamento per siti o servizi destinati ai minori, il targeting personalizzato, gli extra di rete, dimensioni diverse e altro ancora. A causa della natura più limitata di queste richieste, ti consigliamo di eseguire il test utilizzando l'UI dell'app, se possibile.

Test degli annunci

I test degli annunci dello strumento di controllo degli annunci descritti in questa sezione sono un ottimo strumento per verificare la tua esperienza pubblicitaria di base e convalidare la configurazione della mediazione se utilizzata con i test di una singola origine annuncio.

Quando è tutto pronto per testare l'unità pubblicitaria, tocca il pulsante Richiedi annuncio di prova nella parte superiore della schermata dello strumento di controllo degli annunci per attivare il test. I risultati dei test vengono quindi visualizzati nel log delle richieste SDK sotto l'intestazione Requested from ad inspector.

Scopri come utilizzare lo strumento di controllo degli annunci nella tua app

Test di una singola origine annuncio

Lo strumento di controllo degli annunci ha una funzionalità per limitare le richieste di annunci nella tua app in modo da pubblicare solo annunci da una singola bidding origine annuncio con mediazione a cascata. In questo modo puoi verificare di aver implementato correttamente l'adattatore di terze parti e che l'origine annuncio venga pubblicata come previsto.

Per attivare questa funzionalità, attiva/disattiva l'opzione Test di singola origine annuncio nella parte inferiore dello schermo. Viene visualizzata la seguente finestra di dialogo per la selezione dell'origine annuncio:

Android

iOS

Devi inizializzare l'SDK Google Mobile Ads prima di poter utilizzare il test di una singola origine annuncio.

Puoi quindi selezionare una singola origine annuncio da testare. Dopo aver selezionato un'origine annuncio, viene visualizzata la seguente schermata:

L'impostazione di test della singola origine annuncio si applica a tutte le richieste di annunci future che effettuerai nella stessa sessione. Tuttavia, non si applica agli annunci precedentemente memorizzati nella cache in quella sessione che non sono ancora stati mostrati. Ti consigliamo di forzare il riavvio dell'app quando applichi un singolo test dell'origine annuncio al fine di invalidare eventuali annunci memorizzati nella cache che potrebbero essere pubblicati anziché che l'origine annuncio scelta riceva una richiesta.

Dopo aver riavviato l'app, tutti i posizionamenti delle unità pubblicitarie tentano di mostrare un annuncio solo della rete selezionata. Quando si avvia lo strumento di controllo degli annunci quando un singolo test dell'origine annuncio è attivo, viene mostrata l'origine annuncio di test attiva:

In modalità di test di una singola origine annuncio, tutte le richieste di annunci tentano di soddisfare l'origine annuncio selezionata, indipendentemente dal fatto che quest'ultima sia stata configurata per le offerte o la mediazione per l'unità pubblicitaria richiesta. Se l'origine annuncio che stai testando non si trova nella struttura a cascata della mediazione per un'unità pubblicitaria, viene visualizzato il messaggio di errore "Nessun riempimento".

Nel test 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 dei test di una singola origine annuncio. Se l'origine annuncio non riesce a caricare un annuncio, viene visualizzato un messaggio che descrive l'errore.

Se hai aggiunto più istanze dell'origine annuncio selezionata a una struttura a cascata di mediazione, vedrai ogni istanza della chiamata all'origine annuncio nella struttura a cascata fino a quando l'annuncio non viene riempito o la struttura a cascata è terminata senza riempimento.

Interrompere un singolo test dell'origine annuncio

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 eventuali annunci memorizzati nella cache per l'origine annuncio testata.

Copia interi output di debug

Lo strumento di controllo degli annunci supporta la copia di una stringa JSON contenente interi output di debug dallo strumento, inclusi i dettagli dell'AdMob app, gli stati di inizializzazione degli adattatori e i risultati dei test di tutte le unità pubblicitarie.

A tale scopo, tocca l'icona dell'app sette volte finché non viene visualizzato il messaggio JSON copiato negli appunti.