Configurare l'SDK Google Mobile Ads (legacy)

Seleziona la piattaforma: Android iOS Unity Flutter Android (Legacy)

Integrare Google Mobile Ads SDK (Legacy) in un'app è il primo passo da compiere per poter mostrare annunci e generare entrate. Dopo aver integrato l'SDK, puoi scegliere un formato dell'annuncio (ad esempio nativo o video con premio) e seguire i passaggi per implementarlo.

Prima di iniziare

Per preparare l'app, completa i passaggi nelle sezioni seguenti.

Prerequisiti dell'app

  • Assicurati che il file di build dell'app utilizzi i seguenti valori:

    • Versione minima dell'SDK 23 o successive
    • Versione dell'SDK di compilazione 35 o successive

Configurare l'app nell'account AdMob

Registra l'app come app AdMob completando i seguenti passaggi:

  1. Accedi a un account AdMob o registrati per.

  2. Registra l'app con AdMob. Questo passaggio crea un'app AdMob con un ID app AdMob univoco AdMob App ID, necessario più avanti in questa guida.

Configura la tua app

  1. Nel file delle impostazioni di Gradle, includi il repository Maven di Google e il repository centrale Maven:

    Kotlin

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

    Groovy

    pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

  2. Aggiungi le dipendenze per Google Mobile Ads SDK (Legacy) al file di build a livello di app:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:25.4.0")
}

    Groovy

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:25.4.0'
}

  3. Fai clic su Sincronizza ora. Per maggiori dettagli sulla sincronizzazione, vedi Sincronizzare i progetti con i file Gradle.

  4. Aggiungi l'ID app AdMob, come identificato nell'interfaccia web di AdMob, al file AndroidManifest.xml dell'app. Per farlo, aggiungi un tag <meta-data>con android:name="com.google.android.gms.ads.APPLICATION_ID". Puoi trovare l'ID app nell'interfaccia web di AdMob. Per android:value, inserisci il tuo ID app AdMob, racchiuso tra virgolette.

    <manifest>
  <application>
    <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="SAMPLE_APP_ID"/>
  </application>
</manifest>

    Sostituisci SAMPLE_APP_ID con il tuo ID app AdMob. Durante i test, utilizza l'ID app di esempio mostrato nell'esempio precedente.

    Inoltre, tieni presente che se non aggiungi il <meta-data> tag esattamente come mostrato, si verifica un arresto anomalo con il messaggio:

    Missing application ID.

    (Facoltativo) Dichiara l'autorizzazione AD_ID per le versioni precedenti in modo che funzionino con Android 13.

    Se la tua app utilizza Google Mobile Ads SDK (Legacy) versione 20.4.0 o successive, puoi saltare questo passaggio, poiché l'SDK dichiara automaticamente l' com.google.android.gms.permission.AD_ID ed è in grado di accedere all'ID pubblicità quando è disponibile.

    Per le app che utilizzano Google Mobile Ads SDK (Legacy) versione 20.3.0 o precedenti e hanno come target Android 13, devi aggiungere l' com.google.android.gms.permission.AD_ID nel AndroidManifest.xml in modo che Google Mobile Ads SDK (Legacy) possa accedere all' ID pubblicità:

    <manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>

    Per saperne di più sulla com.google.android.gms.permission.AD_ID dichiarazione dell'autorizzazione, incluso come disattivarla, consulta questo articolo di Play Console.

Inizializzare il Google Mobile Ads SDK (Legacy)

Prima di caricare gli annunci, inizializza Google Mobile Ads SDK (Legacy) chiamando MobileAds.initialize().

Questo metodo inizializza l'SDK e chiama un listener di completamento al termine delle inizializzazioni di entrambi Google Mobile Ads SDK (Legacy) e dell'adattatore o dopo un timeout di 30 secondi. Questa operazione deve essere eseguita una sola volta, idealmente all'avvio dell'app.

Se utilizzi la mediazione di AdMob, attendi la chiamata del gestore di completamento prima di caricare gli annunci. In questo modo, tutti gli adattatori di mediazione vengono inizializzati.

Gli annunci potrebbero essere precaricati da Google Mobile Ads SDK (Legacy) o dagli SDK dei partner di mediazione al momento dell'inizializzazione. Se devi ottenere il consenso degli utenti nello Spazio economico europeo (SEE), impostare flag specifici per le richieste, ad esempio setTagForChildDirectedTreatment() o setTagForUnderAgeOfConsent(), o intraprendere altre azioni prima di caricare gli annunci, assicurati di farlo prima di inizializzare Google Mobile Ads SDK (Legacy).

Ecco un esempio di come chiamare il metodo initialize() in un thread in background all'interno di un'attività:

Java

new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();

Kotlin

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MainActivity) {}
}

Seleziona un formato dell'annuncio

Google Mobile Ads SDK (Legacy) è stato importato e puoi implementare un annuncio. AdMob offre diversi formati di annunci, quindi puoi scegliere quello più adatto all'esperienza utente della tua app.

Le unità pubblicitarie banner mostrano annunci rettangolari che occupano una porzione del layout dell'app. possono essere aggiornate automaticamente dopo un determinato periodo di tempo. Ciò significa che gli utenti vedranno un nuovo annuncio a intervalli regolari, anche se rimangono sulla stessa schermata della tua app. Inoltre, questo è il formato dell'annuncio più facile da implementare.

Implementare gli annunci banner

Interstitial

Le unità pubblicitarie interstitial mostrano annunci a pagina intera all'interno dell'app. Inseriscili durante le normali interruzioni e nei momenti di transizione nell'interfaccia dell'app, ad esempio dopo il completamento di un livello se si tratta di un'app di giochi.

Implementare gli annunci interstitial

Nativo

Gli annunci nativi sono annunci in cui puoi personalizzare la modalità di presentazione degli asset, come titoli e inviti all'azione, nelle tue app. Applicando uno stile personalizzato all'annuncio, puoi creare presentazioni di annunci naturali e non intrusive che possono arricchire l'esperienza utente.

Implementare gli annunci nativi

Con premio

Le unità pubblicitarie con premio consentono agli utenti di giocare, partecipare a sondaggi o guardare video per vincere premi in-app come monete, vite extra o punti. Puoi impostare premi distinti per le varie unità pubblicitarie, specificare quelli che riceveranno gli utenti e il relativo valore.

Implementare gli annunci con premio

Interstitial con premio

"Interstitial con premio" è un nuovo tipo di formato dell'annuncio con incentivi che consente di offrire premi, ad esempio monete o vite extra, per gli annunci che vengono visualizzati automaticamente durante le normali transizioni dell'app.

A differenza degli annunci con premio, gli utenti non devono attivare la visualizzazione degli annunci interstitial con premio.

Invece della richiesta di attivazione degli annunci con premio, quelli interstitial con premio prevedono una schermata introduttiva che annuncia il premio e offre agli utenti la possibilità di disattivare l'annuncio.

Implementare gli annunci interstitial con premio

Apertura app

Apertura app è un formato dell'annuncio che viene visualizzato quando gli utenti aprono la tua app o vi tornano. L'annuncio si sovrappone alla schermata di caricamento.

Implementare gli annunci apertura app

Risorse aggiuntive

Il repository Google Mobile Ads su GitHub mostra come utilizzare i diversi formati di annunci offerti da questa API.