Strumento di controllo degli annunci

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

Per gli annunci mobile 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 ogni annuncio rete per richiesta
  • Testare singole origini annuncio per l'asta e la mediazione di terze parti
  • Verifica di aver configurato correttamente ciascuna unità pubblicitaria per le offerte e mediazione a cascata

  • Testare le integrazioni di eventi personalizzati

Questa guida spiega come lanciare e utilizzare le diverse funzionalità negli annunci controllore.

Prerequisiti

Per utilizzare lo strumento di controllo degli annunci, devi:

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

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'UI di AdMob quando registrare 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

Non sono necessarie modifiche alla tua app per avviare lo strumento di controllo degli annunci con un gesto. solo eseguire il gesto (ruotato 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 che venga si propaga), l'app deve effettuare una richiesta di annuncio per gli per scoprire di più sull'impostazione dei gesti. 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((AdInspectorError error) =>
  {
    // Error will be set if there was an issue and the inspector was not displayed.
  });
}

Questa API funziona per i dispositivi di test registrato 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 di controllo degli annunci, che contiene un elenco di tutti gli annunci unità Nell'interfaccia utente di AdMob associata all'ID app AdMob che dispone di asta o mediazione configurazioni:

Consigliamo di inizializzare gli annunci per cellulari di Google SDK prima di usare 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 informazioni dettagliate su struttura a cascata della mediazione fino al momento in cui l'annuncio è stato riempito (o la struttura a cascata hanno terminato senza un riempimento) per le ultime richieste di annunci.

Ogni richiesta può essere espansa utilizzando l'indicatore di informativa per mostrare i risultati della struttura a cascata della mediazione per tale richiesta, insieme a eventuali errori e latenza applicabile alla richiesta.

Per le origini annuncio di terze parti, i messaggi di errore vengono inviati direttamente dalla 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 le Panoramica.

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

I risultati bidding vengono ordinati in modo da visualizzare elementi interattivi più vicini 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 passaggi per la 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, potrebbe non avere un'offerta a causa della configurazione o del processo decisionale. Puoi fare riferimento all'annuncio guida alla configurazione della fonte, contattare direttamente l'origine annuncio per assistenza.

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

La struttura a cascata della mediazione può posizionare l'origine annuncio che ha vinto il bidding in base al relativo valore eCPM.

Quando un'origine annuncio viene chiamata nella struttura a cascata della mediazione, può pubblicare annunci. Per saperne di più su come funzionano le offerte con la struttura a cascata della mediazione, consulta example 2 e esempio 3 di offerta con struttura a cascata e con struttura a cascata.

Debug avanzato delle unità pubblicitarie

Durante la risoluzione dei problemi relativi alle unità pubblicitarie, può essere utile esaminare approfonditamente la richiesta di annuncio. e la risposta per identificare dove qualcosa non funziona o per condividerla con Google Supporto per facilitare il debug. Tocca l'icona del menu in cima alla cascata e seleziona Condividi richiesta di annuncio e risposta per esportare l'intera richiesta di annuncio e la risposta. In questo modo non è necessario eseguire tracce di rete sui la tua app.

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

Android
iOS

Visualizza gli adattatori disponibili

Fai clic sulla scheda Alimentatori per visualizzare un elenco di tutti gli adattatori di terze parti associati. con le 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 anche visualizzare eventi personalizzati adattatori. Gli eventi personalizzati consentono I publisher utilizzano reti pubblicitarie che AdMob non supporta. Gli eventi personalizzati sono distinguibili da quelli standard di terze parti adattatori nell'elenco di adattatori in base ai relativi nomi univoci delle classi. Oltre a fornendo il nome della classe e le informazioni sullo stato, lo strumento di controllo degli annunci mostra anche le etichette assegnate agli eventi personalizzati AdMob interfaccia web.

Nel caso in cui l'adattatore non venga trovato o non venga inizializzato, consulta Risolvere i problemi rilevati utilizzando lo strumento di controllo degli annunci per ulteriori informazioni.

Android
iOS

Test delle unità pubblicitarie

Se vuoi testare l'unità pubblicitaria senza doverla aprire nella 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, caricandole 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 convalidare la 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 in nella parte superiore della schermata dello strumento di controllo degli annunci per attivare quest'ultimo. Testa i risultati vengono quindi visualizzati nel log delle richieste SDK sotto l'intestazione Requested" dallo strumento di controllo degli annunci.

Scopri come utilizzare lo strumento di controllo degli annunci nelle 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 che vengano pubblicate solo annunci di un singolo bidding annuncio di mediazione a cascata o con struttura a cascata sorgente. In questo modo puoi verificare di aver implementato correttamente il provider di terze parti e che l'origine annuncio venga pubblicata come previsto.

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

Android
iOS

È necessario inizializzare gli annunci per cellulari di Google SDK prima di poter usare il test di una singola origine annuncio.

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

L'impostazione di test della singola origine annuncio si applica a tutte le richieste di annunci future che effettuerai in per la stessa sessione. Tuttavia, non si applica agli annunci precedentemente memorizzati nella cache in sessioni che non sono ancora state mostrate. È consigliabile forzare il riavvio dell'app quando si applica un singolo test dell'origine annuncio al fine di invalidare qualsiasi annuncio memorizzato nella cache che potrebbe essere pubblicato invece di ricevere una richiesta dall'origine annuncio che hai scelto.

Dopo il riavvio dell'app, tutti i posizionamenti di unità pubblicitarie tentano di mostrare un annuncio proveniente dalla solo sulla rete selezionata. Avvio dello strumento di controllo degli annunci quando viene eseguito il test di una singola origine annuncio "Attiva" mostra l'origine annuncio di prova attiva:

In modalità di test di una singola origine annuncio, tutte le richieste di annunci tentano di soddisfare con i valori selezionati dell'origine annuncio, indipendentemente dal fatto che sia stata configurata per le offerte o la mediazione per l'unità pubblicitaria richiesta. Se l'origine annuncio che stai testando non è presente alla struttura a cascata della mediazione per un'unità pubblicitaria, visualizzi il messaggio "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 di una singola origine annuncio. Se l'origine annuncio non ha caricato un annuncio, appare un messaggio che descrive l'errore.

Se hai aggiunto a una mediazione più istanze dell'origine annuncio selezionata a cascata, vedresti ogni istanza della chiamata all'origine annuncio nella struttura a cascata finché l'annuncio non è riempito o la struttura a cascata non è 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 della tua app dopo aver interrotto il test per invalidare qualsiasi annuncio memorizzato nella cache per l'origine annuncio che è stata testata.

Copia interi output di debug

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

A tale scopo, tocca l'icona dell'app sette volte fino a visualizzare il messaggio Annuncio copiato JSON inspector negli appunti.