Disattivare lo strumento di controllo degli annunci

Sebbene sia possibile utilizzare lo strumento di controllo degli annunci per esaminare il comportamento degli annunci durante lo sviluppo, i test e la risoluzione dei problemi, lo strumento potrebbe aumentare la memoria utilizzata quando è attivato. Ti consigliamo di disattivare lo strumento di controllo degli annunci durante la profilazione del rendimento e il controllo della memoria. Questa funzionalità garantisce che lo strumento di controllo degli annunci non venga eseguito e non interferisca con le misurazioni del rendimento dell'app.

La disattivazione dello strumento di controllo degli annunci impedisce allo strumento di aumentare la memoria utilizzata o di avviarsi tramite gesti, menu di debug o chiamate al metodo. Puoi disattivare lo strumento di controllo degli annunci durante i test del rendimento in modalità di test. In produzione, lo strumento di controllo degli annunci è sempre disattivato e non influisce sulle prestazioni dell'app.

Questa guida illustra come disattivare lo strumento di controllo degli annunci e verificare la disattivazione.

Prerequisiti

Prima di continuare, completa quanto segue:

• Configura GMA Next-Gen SDK.
• Utilizza la versione 1.3.0 o successiva di GMA Next-Gen SDK.

Disattivazione con i tipi di build

Per mantenere disponibile lo strumento di controllo degli annunci nelle build di debug e disattivarlo nelle build di profilazione, gestisci l'impostazione della configurazione di compilazione utilizzando i tipi di build Gradle e i segnaposto del manifest. Completa i seguenti passaggi:

1. Definisci le proprietà manifestPlaceholders nel file di build Gradle.

2. Assegna i valori per ogni tipo di build. L'esempio seguente definisce la chiave disableAdInspector e crea un tipo di build profile che eredita dal tipo di build release. Questo esempio imposta anche il valore della chiave su true per le build di profilo e su false per le build di debug e di release.

   Kotlin

   android {
       buildTypes {
           getByName("debug") {
               manifestPlaceholders["disableAdInspector"] = "false"
           }
           getByName("release") {
               optimization {
                   enable = false
               }
               manifestPlaceholders["disableAdInspector"] = "false"
           }
           create("profile") {
               initWith(getByName("release"))
               manifestPlaceholders["disableAdInspector"] = "true"
           }
       }
   }

   Groovy

   android {
       buildTypes {
           release {
               manifestPlaceholders = [disableAdInspector: "false"]
           }
           debug {
               manifestPlaceholders = [disableAdInspector: "false"]
           }
           create("profile") {
               initWith(getByName("release"))
               manifestPlaceholders = [disableAdInspector: "true"]
           }
       }
   }

3. Fai riferimento alla variabile segnaposto nel file manifest dell'app. L'esempio seguente utilizza il segnaposto disableAdInspector definito nel passaggio precedente.

   <application>
   <!-- Dynamically enable or disable ad inspector based on build type -->
   <meta-data
       android:name=
       "com.google.android.libraries.ads.mobile.sdk.flag.DISABLE_AD_INSPECTOR"
       android:value="${disableAdInspector}" />
   </application>
   

Verifica la disattivazione

Quando provi ad aprire lo strumento di controllo degli annunci mentre è disattivato nel file AndroidManifest.xml, in Logcat viene visualizzato il seguente messaggio:

Ad inspector is disabled in the AndroidManifest.xml.

La chiamata del metodo MobileAds.openAdInspector restituisce un oggetto AdInspectorError nel callback, che comunica all'app che lo strumento di controllo degli annunci non può essere aperto:

Ad inspector cannot be opened because it is disabled in the AndroidManifest.xml.