Strumento di controllo degli annunci

Strumento di controllo degli annunci è un overlay in-app che consente ai dispositivi autorizzati di eseguire analisi in tempo reale delle richieste di annunci di prova direttamente all'interno di un'app mobile. È incluso nell'SDK Google Mobile Ads 20.0.0 e può essere attivato senza la necessità di scrivere codice.

Utilizzando lo strumento di controllo degli annunci nelle versioni dell'SDK Mobile Ads precedenti a20.2.0, puoi:

  • Esaminare le unità pubblicitarie
  • Ispeziona gli adattatori di terze parti
  • Verificare che gli annunci vengano evasi come previsto
  • Identificare gli errori e visualizzare i dettagli su come risolverli.
  • Visualizzare i dettagli della mediazione per ciascuna rete pubblicitaria per richiesta
  • Testare singole origini annuncio per la mediazione di terze parti
  • Verifica di aver configurato correttamente ogni unità pubblicitaria per la mediazione con struttura a cascata
  • Testare le integrazioni di eventi personalizzati

Per la versione 20.2.0 e successive dell'SDK Mobile Ads, puoi anche:

  • Visualizzare i dettagli delle offerte per ciascuna rete pubblicitaria per richiesta
  • Visualizza insieme i dettagli dell'asta e della mediazione a cascata per ogni rete pubblicitaria per richiesta
  • Testare singole origini annuncio per l'asta o la mediazione con struttura a cascata di terze parti

  • Verifica di aver configurato correttamente ciascuna unità pubblicitaria per le offerte e la mediazione con struttura a cascata

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

Prerequisiti

Per utilizzare lo strumento di controllo degli annunci, devi:

  • Utilizza l'SDK Google Mobile Ads versione 20.0.0 o successiva.

Avvia lo strumento di controllo degli annunci

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

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

Avvia usando i gesti

Non sono necessarie modifiche all'app per avviare lo strumento di controllo degli annunci con un gesto; è sufficiente eseguire il gesto (doppio tocco o scuotimento) 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 propagazione), la tua app deve effettuare una richiesta di annuncio per l'SDK Google Mobile Ads per ottenere informazioni sull'impostazione dei gesti. Se il gesto specificato non funziona, prova a caricare un annuncio, a riavviare l'app e a verificare di nuovo il gesto.

Avvia in modo programmatico

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

Java

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

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

Visualizzare e risolvere i problemi relativi alle unità pubblicitarie

Dopo il lancio, viene visualizzata la schermata principale dello strumento di controllo degli annunci, contenente un elenco di tutte le unità nell'interfaccia utente di AdMob associate al tuo ID app AdMob con 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 fornisce dettagli sulla struttura a cascata di mediazione fino al momento in cui l'annuncio è stato riempito (o la struttura a cascata è terminata senza riempimento) per le richieste di annunci più recenti.

Ogni richiesta può essere espansa utilizzando l'indicatore di divulgazione per mostrare i risultati della struttura a cascata della mediazione per tale richiesta, insieme agli 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.

Visualizzazione dei dettagli delle offerte per un'unità pubblicitaria

Prerequisiti: SDK Google Mobile Ads 20.2.0 o versione successiva

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

Nel log delle richieste 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' bidding asta.

I bidding risultati vengono ordinati per avvicinare gli elementi utili all'azione in cima all'elenco:

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

  • Poi ci sono le reti pubblicitarie che presentano problemi. Puoi seguire la procedura per la risoluzione dei problemi.

  • Ci sono poi le reti pubblicitarie per le quali non sono stati restituiti annunci o non hanno fatto offerte. Questo è un possibile indicatore di molti problemi diversi dell'origine annuncio, in quanto potrebbe non aver fatto offerte a causa della sua configurazione o del suo processo decisionale. Puoi consultare la guida alla configurazione dell'origine annuncio o contattare direttamente l'origine annuncio per ricevere assistenza.

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

La struttura a cascata della mediazione può posizionare l'origine annuncio che ha vinto l'astabidding in base al 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 mediazione con struttura a cascata, vedi esempio 2 ed 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 e la risposta di annuncio per identificare dove si verifica un errore oppure condividere con l'Assistenza Google per facilitare il debug. Tocca l'icona del menu nella parte superiore della catena a cascata e seleziona Condividi richiesta di annuncio e risposta per esportare la richiesta e la risposta di annuncio complete. In questo modo puoi evitare di dover eseguire tracce di rete sulla tua app.

Inoltre, puoi visualizzare i parametri delle offerte di terze parti decodificati toccando l'opzione Parametro delle offerte di terze parti nello stesso menu della stringa di richiesta. In questo modo puoi ottenere informazioni dettagliate su quali parametri delle aste 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.

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 dell'asta o della mediazione nella tua app. Quindi, espandi le schede per visualizzare i relativi stati di inizializzazione e versioni dell'SDK. Oltre agli adattatori di terze parti supportati, puoi anche visualizzare adattatori eventi personalizzati. Gli eventi personalizzati consentono ai publisher di utilizzare reti pubblicitarie non AdMob supportate. Gli eventi personalizzati sono distinguibili dagli adattatori di terze parti standard nell'elenco degli adattatori in base ai nomi univoci delle classi. Oltre a fornire informazioni sul nome della classe e sullo stato, lo strumento di controllo degli annunci mostra anche le etichette assegnate a questi eventi personalizzati nell'interfaccia webAdMob .

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.

.

Test delle unità pubblicitarie

Se vuoi testare l'unità pubblicitaria senza doverla accedere nell'interfaccia utente dell'app, lo strumento di controllo degli annunci supporta questa funzionalità direttamente dalla schermata dei dettagli dell'unità pubblicitaria. Inoltre, puoi testare più unità pubblicitarie contemporaneamente, caricare e visualizzare le richieste di annunci di prova in modo asincrono ed eseguire test su singole origini annuncio.

Test degli annunci

I test degli annunci dello strumento di controllo degli annunci descritti in questa sezione sono un ottimo strumento per verificare l'esperienza pubblicitaria di base e per convalidare la configurazione della mediazione quando vengono utilizzati per 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 degli annunci dello strumento di controllo degli annunci. I risultati dei test vengono quindi visualizzati nel log delle richieste dell'SDK sotto l'intestazione Richiesto dallo strumento di controllo degli annunci.

Scopri come usare 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 provenienti da una singola bidding origine annuncio di mediazione 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 l'opzione Test singola origine annuncio nella parte inferiore dello schermo. Viene visualizzata la seguente finestra di dialogo per la selezione dell'origine annuncio:

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 effettuate nella stessa sessione. Tuttavia, non si applica agli annunci precedentemente memorizzati nella cache della sessione e che non sono ancora stati pubblicati. Ti consigliamo di forzare il riavvio dell'app quando applichi il test di una singola origine annuncio in modo da invalidare eventuali annunci memorizzati nella cache che potrebbero essere pubblicati al posto della ricezione di una richiesta da parte dell'origine annuncio scelta.

Dopo aver riavviato l'app, tutti i posizionamenti delle unità pubblicitarie tentano di pubblicare un annuncio solo nella rete selezionata. Se avvii lo strumento di controllo degli annunci quando il test di una singola origine annuncio è attivo, viene mostrata l'origine annuncio di test attiva:

Nella modalità di test di una singola origine annuncio, tutte le richieste di annunci tentano di soddisfare l'origine annuncio selezionata, 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 si trova nella struttura a cascata della mediazione per un'unità pubblicitaria, viene visualizzato 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 del 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 al completamento dell'annuncio o fino al termine della struttura a cascata senza un riempimento.

Interrompere il test di una singola 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, in modo da 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 tutti gli output di debug dallo strumento, inclusi i dettagli dell'appAdMob , gli stati di inizializzazione dell'adattatore e i risultati dei test di tutte le unità pubblicitarie.

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