Inizia

Integrare l'SDK Google Mobile Ads in un'app è il primo passo per visualizzare 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:

    • Versione minima dell'SDK 19 o successiva
    • Compila la versione dell'SDK 33 o successiva

Configura l'app nell'account AdMob

Registra la tua app come app AdMob procedendo nel seguente modo:

  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 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 Maven centrale in entrambe le 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:23.0.0'
}

  3. Aggiungi il tuo AdMob ID app, come identificato nell'interfaccia webAdMob, al file AndroidManifest.xml della tua 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 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, sostituisci l'ID app di esempio con l'ID app effettivo AdMob . Puoi utilizzare l'ID esempio se stai solo sperimentando con l'SDK in un'app Hello World.

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

    Missing application ID.

    (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 successiva, puoi saltare questo passaggio poiché l'SDK dichiara automaticamente l'autorizzazione com.google.android.gms.permission.AD_ID e può accedere all'ID pubblicità quando è 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 e su come disattivarla, leggi questo articolo di Play Console.

Inizializzare l'SDK Google Mobile Ads

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

Questo metodo inizializza l'SDK e chiama un listener di completamento una volta completate le inizializzazioni dell'SDK e dell'adattatore Google Mobile Ads 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 del partner di mediazione al momento dell'inizializzazione. Se devi ottenere il consenso degli utenti nello Spazio economico europeo (SEE), imposta segnalazioni specifiche per la richiesta, ad esempio setTagForChildDirectedTreatment() oppure setTagForUnderAgeOfConsent() 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à:

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) {}
  }
}

Seleziona un formato dell'annuncio

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

Le unità pubblicitarie banner mostrano annunci rettangolari che occupano una parte del layout dell'app. Possono aggiornarsi automaticamente dopo un determinato periodo di tempo. Ciò significa che gli utenti visualizzano un nuovo annuncio a intervalli regolari, anche se rimangono nella stessa schermata dell'app. Sono inoltre il formato dell'annuncio più semplice da implementare.

Implementare gli annunci banner

Interstitial

Le unità pubblicitarie interstitial mostrano annunci a pagina intera nella tua app. Posizionali in corrispondenza di interruzioni e transizioni naturali nell'interfaccia dell'app, ad esempio dopo il completamento di un livello in un'app di gioco.

Implementare gli annunci interstitial

Nativo

Gli annunci nativi sono annunci in cui puoi personalizzare il modo in cui asset, come titoli e inviti all'azione, vengono presentati nelle tue app. Applicando lo stile all'annuncio, puoi creare presentazioni dell'annuncio naturali e discrete per 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 diversi per unità pubblicitarie diverse e specificare i valori e gli articoli ricevuti dall'utente.

Implementare gli annunci con premio

Interstitial con premio

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

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

Invece della richiesta di attivazione negli annunci con premio, gli interstitial con premio richiedono una schermata introduttiva che annuncia il premio e offre agli utenti la possibilità di disattivare questa opzione.

Implementare gli annunci interstitial con premio

Apertura app

L'apertura dell'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

Altre risorse

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