Inizia

L'integrazione dell'SDK GMA Next Gen in un'app è il primo passo per mostrare 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 GMA Next Gen 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.

Inizializza l'SDK GMA di nuova generazione

Chiama MobileAds.initialize() per inizializzare l'SDK GMA di nuova generazione. 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 GMA Next Gen SDK 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 GMA Next Gen SDK 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 GMA di nuova generazione 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 potrebbero essere precaricati dall'SDK GMA di nuova generazione 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 intervieni in altro modo prima di caricare gli annunci, assicurandoti di farlo prima di inizializzare l'SDK GMA di nuova generazione.

Seleziona un formato dell'annuncio

L'SDK GMA di nuova generazione è stato importato e ora 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