Per iniziare

L'integrazione dell'SDK Google Mobile Ads in un'app è il primo passo verso mostrare annunci e generare entrate. Una volta integrato l'SDK, puoi scegli un formato dell'annuncio (ad esempio video nativo o con premio) e segui i passaggi per implementarla.

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 SDK minima di 21 o successiva
    • Compila la versione SDK di 33 o successiva

Configura la tua app

  1. Nel file delle impostazioni di Gradle, includi la classe Repository Maven di Google e 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 alla build a livello di app file:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:23.3.0")
}

    Trendy

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

  3. Aggiungi il tuo Ad Manager ID app, come identificato nel Ad Manager all'interfaccia web, nell'interfaccia AndroidManifest.xml. Per farlo, aggiungi un tag <meta-data> con android:name="com.google.android.gms.ads.APPLICATION_ID". Puoi visualizzare il tuo ID app nell' Ad Manager interfaccia web. Per android:value, inserisci il tuo Ad Manager ID dell'app, racchiuso tra virgolette.

    <manifest>
  <application>
    <!-- Sample Ad Manager 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 il tuo Ad Manager ID app. Puoi utilizzare l'ID di esempio se stai solo sperimentando l'SDK in un'app Hello World.

    Inoltre, tieni presente che la mancata aggiunta del tag <meta-data> esattamente come mostrato nei risultati in caso di arresto anomalo con il messaggio:

    Missing application ID.

    (Facoltativo) Dichiara Autorizzazione AD_ID per il funzionamento delle versioni precedenti con Android 13:

    Se la tua app utilizza la versione 20.4.0 dell'SDK Google Mobile Ads oppure o un'istanza, puoi saltare questo passaggio, poiché l'SDK dichiara automaticamente com.google.android.gms.permission.AD_ID e può per accedere all'ID pubblicità, se disponibile.

    Per le app che utilizzano la versione 20.3.0 dell'SDK Google Mobile Ads o e hanno come target Android 13, devi aggiungere Autorizzazione com.google.android.gms.permission.AD_ID in AndroidManifest.xml per l'SDK Google Mobile Ads per accedi 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ù sulle com.google.android.gms.permission.AD_ID dichiarazione delle autorizzazioni, incluse le modalità di disattivazione, fai riferimento a 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 che sia Le inizializzazioni dell'SDK e dell'adattatore Google Mobile Ads sono state completate 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 dell'inizializzazione. Se devi ottenere il consenso degli utenti in Europa Spazio economico (SEE), imposta flag specifici per le richieste, ad esempio setTagForChildDirectedTreatment() o setTagForUnderAgeOfConsent(), o altrimenti intervenire prima di caricare gli annunci; assicurati di farlo prima dell'inizializzazione l'SDK Google Mobile Ads.

Ecco un esempio di come chiamare il metodo initialize() su uno sfondo thread all'interno di 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);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds
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 the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}

Seleziona un formato dell'annuncio

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

Le unità pubblicitarie banner mostrano annunci rettangolari che occupano una parte della layout. Possono aggiornarsi automaticamente dopo un determinato periodo di tempo. Ciò significa Gli utenti visualizzano un nuovo annuncio a intervalli regolari, anche se rimangono invariati schermata nell'app. Inoltre, sono 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. Posizionale nella posizione naturale interruzioni e transizioni nell'interfaccia dell'app, ad esempio al 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, ad esempio titoli e gli inviti all'azione vengono presentati nelle tue app. Personalizzando l'annuncio, puoi creare presentazioni naturali e non invadenti che possono contribuire a un'esperienza utente completa.

Google Ad Manager offre due modi per implementare gli annunci nativi: gli stili nativi e per gli annunci nativi standard tramite il rendering personalizzato.

Gli stili nativi sono stati progettati per semplificare l'implementazione di annunci nativi, ed è un'ottima scelta se sei alle prime armi con questo formato. Il rendering personalizzato è stato progettato per massimizzare la libertà di creazione delle tue presentazioni.

Implementare gli stili nativi Implementare annunci nativi (rendering personalizzato)

Con premio

Le unità pubblicitarie con premio consentono agli utenti di giocare, partecipare a sondaggi o guardare video guadagnare premi in-app, come monete, vite extra o punti. Puoi impostare premi diversi per unità pubblicitarie diverse e specifica i valori del premio e elementi ricevuti dall'utente.

Implementare gli annunci con premio

Interstitial con premio

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

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

Invece della richiesta di attivazione negli annunci con premio, gli interstitial con premio richiedono un schermata introduttiva che annuncia il premio e offre agli utenti la possibilità di disattivarla se vogliano farlo.

Implementare gli annunci interstitial con premio

Apertura app

Apertura app è un formato dell'annuncio che viene visualizzato quando gli utenti aprono o tornano al tuo dell'app. L'annuncio si sovrappone alla schermata di caricamento.

Implementare gli annunci apertura app

Risorse aggiuntive

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