Per iniziare

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Integrare l'SDK Google Mobile Ads in un'app è il primo passo per pubblicare annunci e generare entrate. Una volta 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 indicati nelle sezioni che seguono.

Prerequisiti dell'app

  • Utilizzare Android Studio 3.2 o versioni successive
  • Assicurati che il file build della tua app utilizzi i seguenti valori:

    • A minSdkVersion di 19 o superiore
    • A compileSdkVersion di 28 o superiore

Configura l'app nell'account AdMob

Registra la tua app come app AdMob completando i seguenti passaggi:

  1. Accedi o registrati a un account AdMob.

  2. Registra la tua app con AdMob. Questo passaggio crea un'app AdMob con un ID app AdMob univoco che sarà necessario più avanti nella guida.

Configura l'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 dell'SDK Google Mobile Ads al file Gradle a livello di app del tuo modulo, in genere app/build.gradle:

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:21.5.0'
    }
    
  3. Aggiungi il tuo AdMob ID app (identificato nell'interfaccia utente 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 il tuo ID app nell' AdMob interfaccia utente. 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 stai solo cercando di sperimentare l'SDK in un'app Hello World, puoi utilizzare l'ID app di esempio mostrato sopra.

    Tieni presente, inoltre, che l'impossibilità di aggiungere il 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 il funzionamento delle versioni precedenti con Android 13.

    Se la tua app utilizza l'SDK Google Mobile Ads versione 20.4.0 o superiore, puoi saltare questo passaggio perché l'SDK dichiara automaticamente com.google.android.gms.permission.AD_ID l'autorizzazione e può accedere all'ID pubblicità quando è disponibile.

    Per le app che utilizzano la versione 20.3.0 o le versioni precedenti dell'SDK Google Mobile Ads che hanno come target Android 13, devi aggiungere l'autorizzazione com.google.android.gms.permission.AD_ID nel file AndroidManifest.xml per consentire all'SDK Google Mobile Ads di 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 dichiarazione delle autorizzazioni com.google.android.gms.permission.AD_ID, incluso come disattivarla, consulta questo articolo di Play Console.

Inizializzare l'SDK Google Mobile Ads

Prima di caricare gli annunci, chiedi alla tua app di inizializzare l'SDK Google Mobile Ads chiamando MobileAds.initialize() l'inizializzazione dell'SDK e di richiamare 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 dagli SDK Google Mobile Ads o dagli SDK dei partner di mediazione al momento della chiamata al numero MobileAds.initialize(). Se devi ottenere il consenso degli utenti nello Spazio economico europeo (SEE), impostare flag specifici per le richieste (ad esempio tagForChildDirectedTreatment o tag_for_under_age_of_consent) o intraprendere altre azioni 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 attività principale (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 il gestore del completamento venga chiamato prima di caricare gli annunci, in modo da garantire che tutti gli adattatori di mediazione siano inizializzati.

Seleziona un formato dell'annuncio

L'SDK Google Mobile Ads ora è importato e ora puoi implementare un annuncio. AdMob Offre una serie di formati dell'annuncio diversi, per consentirti di scegliere quello più adatto all'esperienza utente della tua app.

Annunci rettangolari visualizzati nella parte superiore o inferiore dello schermo del dispositivo. Gli annunci banner rimangono sullo schermo mentre gli utenti interagiscono con l'app e possono essere aggiornati automaticamente dopo un determinato periodo di tempo. Se non hai mai utilizzato la pubblicità per il mobile, sono un ottimo punto di partenza.

Implementare gli annunci banner

Interstitial

Annunci a schermo intero che coprono l'interfaccia di un'app fino alla chiusura dall'utente. Vengono usati al meglio nelle pause naturali del 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 rispecchiano l'aspetto e l'aspetto della tua app. Decidi come e dove devono essere posizionati, in modo che il layout sia più in linea 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 e sondaggi demo. Categoria relativa alla monetizzazione delle app free-to-play.

Implementare gli annunci con premio

Risorse aggiuntive

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