Inizia

L'integrazione dell'SDK Google Mobile Ads in un'app è il primo passo per poter mostrare annunci e generare entrate. Una volta 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 descritti nelle sezioni seguenti.

Prerequisiti dell'app

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

    • Versione minima dell'SDK di 23 o successiva
    • Compila la versione dell'SDK di 34 o successiva

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 al file di build a livello di app:

    Kotlin

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

    Trendy

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

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

  4. Aggiungi il tuo ID app Ad Manager, come identificato nell'interfaccia web di Ad Manager, 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'interfaccia web di Ad Manager. Per android:value, inserisci il tuo ID app Ad Manager, 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="
/<network_code>~<application_id>"/>
  </application>
</manifest>

    In un'app reale, sostituisci l'ID app di esempio con l'ID app di Ad Manager effettivo. 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 determina un arresto anomalo con il messaggio:

    Missing application ID.

    (Facoltativo) Dichiara l'autorizzazione AD_ID per consentire il funzionamento delle versioni precedenti con Android 13.

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

    Per le app che utilizzano la versione 20.3.0 o versioni precedenti dell'SDK Google Mobile Ads e che 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 di com.google.android.gms.permission.AD_ID, e su come disattivarla, consulta 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 al termine delle inizializzazioni dell'SDK Google Mobile Ads e dell'adattatore oppure 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 nello Spazio economico europeo (SEE), imposta eventuali flag specifici per la richiesta, ad esempio setTagForChildDirectedTreatment() o setTagForUnderAgeOfConsent(), oppure intervieni 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() su un thread in background 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 degli annunci, 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 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 pagina intera nella tua app. Posizionali in corrispondenza di interruzioni e transizioni naturali 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 quali titoli e inviti all'azione vengono presentati nelle tue app. Personalizzando l'annuncio, puoi creare presentazioni degli annunci naturali e non invadenti che possono contribuire a un'esperienza utente completa.

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

Gli stili nativi sono stati progettati per semplificare l'implementazione degli annunci nativi e rappresentano un'ottima scelta se non hai dimestichezza con questo formato. Il rendering personalizzato è stato progettato per massimizzare la libertà di creazione delle presentazioni.

Implementare gli stili nativi Implementare gli annunci nativi (rendering personalizzato)

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 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 degli annunci 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 che viene visualizzato quando gli utenti aprono l'app o vi ritornano. L'annuncio si sovrappone alla schermata di caricamento.

Implementare gli annunci apertura app

Risorse aggiuntive

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