Strumento di controllo degli annunci

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. Può essere attivato senza bisogno di scrivere codice.

Per il plug-in Unity Google Mobile Ads nella versione 7.0.0 e successive, puoi:

  • Controllare le unità pubblicitarie
  • Controllare gli adattatori di terze parti
  • Verificare che gli annunci vengano evasi come previsto.
  • Individuare errori e visualizzare dettagli su come risolverli
  • Visualizzare insieme i dettagli della mediazione per l'asta e la struttura a cascata per ogni rete pubblicitaria per richiesta
  • Provare singole origini annuncio di mediazione e aste di terze parti
  • Verifica di aver configurato correttamente ogni unità pubblicitaria per le offerte e la mediazione a cascata

  • Testare le integrazioni di eventi personalizzati

Questa guida mostra come avviare e utilizzare le diverse funzionalità dell'ispettore annunci.

Prerequisiti

Per utilizzare lo strumento di controllo degli annunci, devi:

  • Utilizza il plug-in Unity di Google Mobile Ads versione 7.0.0 o successive.

Avvia 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 quando registri un dispositivo di test.
  2. Utilizzo programmatico dell'API fornita.
  3. 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. Basta eseguire il gesto (doppia rotazione 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 aspettato 15 minuti per la sua propagazione), l'app deve effettuare una richiesta di annunci per consentire all'SDK Google Mobile Ads di conoscere l'impostazione del gesto. Se il gesto specificato non funziona, prova a caricare un annuncio, a riavviare l'app e a testare di nuovo il gesto.

Avvio tramite programmazione

Lo strumento di controllo degli annunci può essere avviato 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 è compatibile con i dispositivi di test registrati in modo programmatico o nell'interfaccia utente di AdMob.

Visualizzare e risolvere i problemi relativi alle unità pubblicitarie

Una volta lanciato, viene visualizzata la schermata principale dello strumento di controllo degli annunci, contenente un elenco di tutte le unità pubblicitarie nell'interfaccia utente di AdMob associate al tuo ID app AdMob con configurazioni di offerte 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 della mediazione fino al punto in cui l'annuncio è stato pubblicato (o la struttura a cascata è terminata senza pubblicazione) 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 la richiesta in questione, nonché eventuali errori e latenze applicabili.

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

Visualizzare i dettagli delle offerte per un'unità pubblicitaria

Se non hai mai effettuato offerte, leggi la panoramica.

Nel log delle richieste dell'SDK puoi vedere le origini annuncio per l'asta 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 di offerta.

I risultati dell'asta vengono ordinati in modo da avvicinare gli elementi utili alla parte superiore dell'elenco:

  • In alto è indicata la rete pubblicitaria che ha vinto l'asta.

  • Di seguito sono riportate le reti pubblicitarie che presentano problemi. Puoi seguire la procedura di risoluzione dei problemi.

  • Poi ci sono le reti pubblicitarie che non hanno restituito annunci o non hanno fatto offerte. Questo potrebbe essere un possibile indicatore di molti problemi diversi relativi all'origine annuncio, in quanto potrebbe non aver fatto offerte a causa della configurazione o del modo in cui prende decisioni. Puoi consultare la guida alla configurazione dell'origine annuncio o contattare direttamente l'origine annuncio per ricevere assistenza.

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

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

Debug avanzato delle unità pubblicitarie

Quando risolvi i problemi relativi alle unità pubblicitarie, può essere utile esaminare la richiesta di annuncio e la risposta per identificare dove si verifica un errore o 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 la richiesta di annuncio e la risposta complete. In questo modo non dovrai eseguire tracce di rete sulla tua app.

Inoltre, puoi visualizzare i parametri delle aste di terze parti decodificati toccando l'opzione Parametro dell'asta di terze parti nello stesso menu della stringa richiesta. Fornisce dettagli sui parametri di offerta di terze parti che potrebbero avere problemi, aiutandoti a eseguire il debug dell'app o a verificare che una rete stia raccogliendo correttamente i suoi indicatori.

Android
iOS

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

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

Android
iOS

Testare le unità pubblicitarie

Se vuoi testare l'unità pubblicitaria senza doverla selezionare nell'interfaccia utente dell'app, lo strumento di controllo degli annunci lo supporta direttamente dalla schermata dei dettagli dell'unità pubblicitaria. Inoltre, puoi testare più unità pubblicitarie contemporaneamente, caricare in modo asincrono e visualizzare le richieste di annunci di test, nonché eseguire test di 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 configurazione della mediazione se utilizzati con i test delle singole origini 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 dell'annuncio dello strumento di controllo degli annunci. I risultati del test vengono visualizzati nel log delle richieste dell'SDK sotto l'intestazione Richiesta dall'ispettore annunci.

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

Test di singole origini annuncio

Lo strumento di controllo degli annunci dispone di una funzionalità che consente di limitare le richieste di annunci nella tua app in modo da pubblicare solo annunci provenienti da una singola origine annuncio per l'asta o la 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/disattiva l'opzione Test singola origine annuncio nella parte inferiore dello schermo. Viene visualizzata la seguente finestra di dialogo di selezione dell'origine annuncio:

Android
iOS

Per poter utilizzare la funzionalità di prova di una singola origine annuncio, devi inizializzare l'SDK Google Mobile Ads.

Puoi quindi selezionare una singola origine annuncio da testare. Una volta selezionata un'origine annuncio, viene visualizzata la seguente schermata:

L'impostazione del test di una singola origine annuncio 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 nella sessione che non sono ancora stati mostrati. Ti consigliamo di riavviare forzatamente l'app quando applichi un test di una singola origine annuncio per invalidare gli annunci memorizzati nella cache che potrebbero essere pubblicati anziché la ricezione di una richiesta da parte dell'origine annuncio scelta.

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

Nella modalità di test di una singola origine annuncio, tutte le richieste di annunci tentano di essere soddisfatte con 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 è nella struttura a cascata della mediazione per un'unità pubblicitaria, viene visualizzato un 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 lo descrive.

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.

Interrompere un 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 per invalidare gli annunci memorizzati nella cache per l'origine annuncio testata.

Eseguire il debug delle impostazioni della privacy

Prerequisiti: plug-in Unity Google Mobile Ads versione 7.3.0 o successive

Puoi utilizzare lo strumento di controllo degli annunci per visualizzare i seguenti indicatori sulla privacy trasmessi nella richiesta di annunci nell'ambito dell'integrazione del publisher con il TCF di IAB Europe:

  • Si applica il GDPR (IABTCF_gdprApplies)
  • Stringa CA (IABTCF_AddtlConsent)
  • Stringa TC (IABTCF_TCString)

Dopo aver caricato un annuncio o eseguito 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 della privacy.

La schermata Indicatori della privacy mostra gli indicatori della privacy trasmessi nella richiesta di annuncio.

Per scoprire di più sulla stringa AC, consulta la specifica tecnica del Consenso aggiuntivo di Google. Per visualizzare i dettagli granulari del consenso nella stringa TC, ad esempio l'ID CMP e l'elenco degli identificatori dei fornitori per i quali è stato fornito il consenso associati a IAB, fai clic su Decodifica per aprire l'IAB GPP Encoder / Decoder.

Se si verificano errori, segui i passaggi descritti in Informazioni sui problemi relativi alla privacy per la risoluzione dei problemi.

Copiare l'intero output di debug

L'ispettore degli annunci supporta la copia di una stringa JSON contenente l'intero output di debug dello strumento, inclusi i dettagli dell'app 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 viene visualizzato il messaggio JSON dell'ispettore annunci copiato negli appunti.