Disattivare lo strumento di controllo degli annunci

Sebbene tu possa 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. Potresti voler disattivare lo strumento di controllo degli annunci durante la profilazione del rendimento e il controllo della memoria. Questa funzionalità assicura che lo strumento di controllo degli annunci non venga eseguito e non interferisca con le misurazioni del rendimento della tua app.

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

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

Prerequisiti

Prima di continuare, completa le seguenti operazioni:

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

Disattivazione con i tipi di build

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

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

2. Assegna valori per ogni tipo di compilazione. L'esempio seguente definisce la chiave disableAdInspector, crea un tipo di compilazione profile che eredita dal tipo di compilazione release. Questo esempio imposta anche il valore della chiave su true per le build di profili e un valore false per le build di debug e 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 che hai 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 tenti di 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 al 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.