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
21
o successiva - Compila la versione dell'SDK
33
o successiva
- Versione minima dell'SDK
Configura la tua app
Nel file
build.gradle
a livello di progetto, includi il repository Maven di Google e il repository Maven centrale in entrambe le sezionibuildscript
eallprojects
:buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
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.1.0' }
Aggiungi il tuo Ad Manager ID app, come identificato nell'interfaccia webAd Manager, al file
AndroidManifest.xml
della tua app. Per farlo, aggiungi un tag<meta-data>
conandroid:name="com.google.android.gms.ads.APPLICATION_ID"
. Puoi trovare il tuo ID app nell' Ad Manager interfaccia web. Perandroid:value
, inserisci il tuo Ad Manager ID 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 l'ID app effettivo Ad Manager . 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 fileAndroidManifest.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 chiamandoMobileAds.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 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 una serie di formati di annunci diversi, per consentirti di scegliere quello più adatto all'esperienza utente della tua app.
Banner
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.
Google Ad Manager offre due modi per implementare gli annunci nativi: stili nativi e annunci nativi standard tramite rendering personalizzato.
Gli stili nativi sono stati progettati per semplificare l'implementazione degli annunci nativi e sono la scelta ideale per chi non ha mai utilizzato il formato. Il rendering personalizzato è stato progettato per massimizzare la libertà che hai nella creazione delle tue presentazioni.
Implementa stili nativi Implementa 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 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
Risorse aggiuntive
Il repository Google Mobile Ads su GitHub mostra come utilizzare i diversi formati degli annunci offerti da questa API.