Disattivare lo strumento di controllo degli annunci

Seleziona la piattaforma: Android iOS

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 essere avviato tramite gesti, il 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 sul rendimento della tua app.

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

Prerequisiti

Prima di continuare, completa i seguenti passaggi:

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

Disattivazione con i tipi di build

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

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

2. Assegna i valori per ogni tipo di compilazione. L'esempio seguente definisce la chiave disableAdInspector e 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 profilo e su 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 della tua 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>
   

Nota: durante lo sviluppo e i test, assicurati di attivare i dispositivi di test.

Verifica la disattivazione

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

Ad inspector is disabled in the AndroidManifest.xml.

La chiamata al metodo MobileAds.openAdInspector restituisce un oggetto AdInspectorError nel callback, che notifica 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.