Inizia

Integrare l'SDK Google Mobile Ads (beta) in un'app è il primo passo per mostrare gli 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 descritti nelle sezioni seguenti.

Prerequisiti per le app

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

    • Versione minima dell'SDK 24 o versioni successive
    • Compila la versione dell'SDK 35 o successive
  • Per le app Kotlin, utilizza la versione minima di Kotlin 1.9.

Configura l'app nel tuo account AdMob

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

  1. Accedi o registrati per un account AdMob.

  2. Registra la tua app con AdMob. Questo passaggio crea un'app AdMob con un ID app AdMob univoco 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")

    Trendy

    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 l'SDK Google Mobile Ads (beta) al file di build a livello di app:

    Kotlin

    dependencies {
  implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01")
}

    Trendy

    dependencies {
  implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01'
}

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

Inizializzare l'SDK Google Mobile Ads (beta)

Chiama MobileAds.initialize() per inizializzare l'SDK Google Mobile Ads (beta). Questo metodo deve essere chiamato su un thread in background. In caso contrario, potrebbe verificarsi un errore "L'applicazione non risponde" (ANR).

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

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

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize Google Mobile Ads SDK (beta) on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // Other methods on MobileAds can now be called.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

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

    new Thread(
            () -> {
              // Initialize Google Mobile Ads SDK (beta) on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}

Questo metodo inizializza l'SDK e chiama un listener di completamento una volta completate le inizializzazioni dell'SDK Google Mobile Ads (beta) e dell'adattatore oppure dopo un timeout di 30 secondi. Questa operazione deve essere eseguita una sola volta, idealmente all'avvio dell'app.

Gli annunci possono essere precaricati dall'SDK Google Mobile Ads (beta) o dagli SDK dei partner di mediazione al momento dell'inizializzazione. Se devi ottenere il consenso degli utenti nello Spazio Economico Europeo (SEE), imposta eventuali flag specifici della richiesta, ad esempio RequestConfiguration.TagForChildDirectedTreatment o RequestConfiguration.TagForUnderAgeOfConsent, o <x0A>altrimenti intraprendi un'azione prima di caricare gli annunci, assicurati di farlo prima di inizializzare <x0A>l'SDK Google Mobile Ads (beta).

Seleziona un formato dell'annuncio

L'SDK Google Mobile Ads (beta) è ora 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 vedono 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 schermo intero nell'app. Posiziona gli annunci in un punto in cui nell'interfaccia dell'app si verifica una pausa naturale o una transizione, ad esempio dopo il completamento di un livello in un'app di gioco.

Implementare gli annunci interstitial

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 le varie unità pubblicitarie, specificare quelli che riceveranno gli utenti e il relativo valore.

Implementare gli annunci con premio

Interstitial con premio

L'interstitial con premio è un nuovo tipo di formato dell'annuncio con incentivi che ti 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 di un annuncio 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 visualizzato quando gli utenti aprono la tua app o vi tornano. L'annuncio si sovrappone alla schermata di caricamento.

Implementa gli annunci apertura app