Inizia

L'integrazione dell'SDK Google Mobile Ads in un'app è il primo passo per mostrare gli annunci e generare entrate. Dopo aver integrato l'SDK, puoi scegliere un formato dell'annuncio (ad esempio video nativo o con premio) e seguire la procedura 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:

    • minSdkVersion di 19 o superiore
    • compileSdkVersion di 33 o superiore

Configura l'app nell'account AdMob

Per registrare la tua app come app AdMob:

  1. Accedi o registrati per creare un account AdMob.

  2. Registra la tua app con AdMob. Questo passaggio crea un'app AdMob con un ID app AdMob univoco che dovrai utilizzare più avanti in questa guida.

Configura la tua app

  1. Nel file build.gradle a livello di progetto, includi il repository Maven di Google e il repository centrale Maven nelle sezioni buildscript e allprojects:

    buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

  2. Aggiungi le dipendenze per l'SDK Google Mobile Ads al file Gradle a livello di app del modulo, solitamente app/build.gradle:

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

  3. Aggiungi l' AdMob ID app, così come identificato nell'interfaccia webAdMob, al file AndroidManifest.xml dell'app. A questo scopo, aggiungi un tag <meta-data> con android:name="com.google.android.gms.ads.APPLICATION_ID". Puoi trovare il tuo ID app nell' AdMob interfaccia web. Per android:value, inserisci il tuo AdMob ID app 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="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>

    In un'app reale, utilizza il tuo ID AdMob app effettivo, non quello elencato sopra. Se vuoi solo fare esperimenti con l'SDK in un'app Hello World, puoi utilizzare l'ID app di esempio mostrato sopra.

    Tieni inoltre presente che la mancata aggiunta del tag <meta-data> come mostrato sopra comporta un arresto anomalo con il messaggio:

    The Google Mobile Ads SDK was initialized incorrectly.

    (Facoltativo) Dichiara l'autorizzazione AD_ID per consentire alle versioni precedenti di funzionare con Android 13.

    Se la tua app utilizza la versione 20.4.0 o una successiva dell'SDK Google Mobile Ads, puoi saltare questo passaggio poiché l'SDK dichiara automaticamente l'autorizzazione com.google.android.gms.permission.AD_ID ed è in grado di accedere all'ID pubblicità ogni volta che è disponibile.

    Per le app che utilizzano l'SDK Google Mobile Ads versione 20.3.0 o precedente e hanno come target Android 13, devi aggiungere l'autorizzazione com.google.android.gms.permission.AD_ID nel file AndroidManifest.xml affinché l'SDK Google Mobile Ads 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 scoprire di più sulla dichiarazione delle autorizzazioni com.google.android.gms.permission.AD_ID, incluse informazioni su come disattivarla, leggi questo articolo di Play Console.

Inizializzare l'SDK Google Mobile Ads

Prima di caricare gli annunci, fai in modo che la tua app inizializza l'SDK Google Mobile Ads chiamando MobileAds.initialize() che inizializza l'SDK e richiama un listener di completamento una volta completata l'inizializzazione o dopo un timeout di 30 secondi. Questa operazione deve essere eseguita una sola volta, idealmente al momento del lancio dell'app.

Gli annunci possono essere precaricati dall'SDK Google Mobile Ads o dagli SDK dei partner di mediazione al momento della chiamata a MobileAds.initialize(). Se devi ottenere il consenso dagli utenti nello Spazio economico europeo (SEE), imposta segnalazioni specifiche per le richieste, ad esempio tagForChildDirectedTreatment o tag_for_under_age_of_consent, oppure intervieni in altro modo prima di caricare gli annunci, assicurati di farlo prima di inizializzare l'SDK Google Mobile Ads.

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

Esempio di MainActivity (estratto)

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        MobileAds.initialize(this, new OnInitializationCompleteListener() {
            @Override
            public void onInitializationComplete(InitializationStatus initializationStatus) {
            }
        });
    }
}

Kotlin

import com.google.android.gms.ads.MobileAds

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        MobileAds.initialize(this) {}
    }
}

Se utilizzi la mediazione, attendi che venga chiamato il gestore del completamento prima di caricare gli annunci, in modo da garantire che tutti gli adattatori di mediazione vengano inizializzati.

Seleziona un formato dell'annuncio

L'SDK Google Mobile Ads è stato importato e puoi iniziare a implementare un annuncio. AdMob offre una serie di formati di annunci diversi, così puoi scegliere quello più adatto all'esperienza utente della tua app.

Annunci rettangolari che vengono visualizzati nella parte superiore o inferiore dello schermo del dispositivo. Gli annunci banner rimangono sullo schermo durante l'interazione degli utenti con l'app e possono aggiornarsi automaticamente dopo un determinato periodo di tempo. Se non hai mai utilizzato la pubblicità per il mobile, questo strumento è un ottimo punto di partenza.

Implementare gli annunci banner

Interstitial

Annunci a schermo intero che coprono l'interfaccia di un'app fino alla chiusura dell'utente. Sono ideali per le pause naturali nel flusso di esecuzione di un'app, ad esempio tra i livelli di un gioco o subito dopo il completamento di un'attività.

Implementare gli annunci interstitial

Nativo

Annunci personalizzabili che si adattano all'aspetto e al design della tua app. Sei tu a decidere come e dove posizionarli, in modo che il layout sia più coerente con il design della tua app.

Implementare gli annunci nativi

Con premio

Annunci che premiano gli utenti per la visione di brevi video e l'interazione con annunci demo e sondaggi. Utilizzato per la monetizzazione di app free-to-play.

Implementare gli annunci con premio

Risorse aggiuntive

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