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
- Versione SDK minima di
Configura l'app nel tuo account AdMob
Per registrare la tua app come app AdMob:
Accedi a o registrati per un account AdMob.
Registra la tua app in AdMob. Questo passaggio crea un'app AdMob con un'app AdMob univoca ID necessario in un secondo momento guida.
Configura la tua app
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'
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' }
Aggiungi il tuo AdMob ID app, come identificato nel AdMob all'interfaccia web, nell'interfaccia
AndroidManifest.xml
. Per farlo, aggiungi un tag<meta-data>
conandroid:name="com.google.android.gms.ads.APPLICATION_ID"
. Puoi visualizzare il tuo ID app nell' AdMob interfaccia web. Perandroid:value
, inserisci il tuo AdMob ID dell'app, racchiuso tra virgolette.<manifest> <application> <!-- Sample AdMob 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 AdMob 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
inAndroidManifest.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 chiamandoMobileAds.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. AdMob offre diversi formati di annunci, per cui puoi scegliere quello più adatto all'esperienza utente della tua app.
Banner
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. Impostando lo stile dell'annuncio autonomamente, puoi creare presentazioni di annunci naturali e discrete che possano arricchire la presentazione un'esperienza senza intervento manuale.
Implementare gli annunci nativi
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.