Gli annunci nativi sono asset annuncio presentati agli utenti tramite componenti dell'interfaccia utente che sono native della piattaforma. Vengono mostrati utilizzando gli stessi tipi di visualizzazioni con che stai già creando nei tuoi layout e che possono essere formattati in modo da il design visivo dell'app.
Quando viene caricato un annuncio nativo, l'app riceve un oggetto annuncio che contiene i suoi asset. e l'app, invece dell'SDK Google Mobile Ads, viene responsabile della loro visualizzazione.
In generale, l'implementazione efficace degli annunci nativi si compone di due parti: Caricare un annuncio utilizzando l'SDK e poi mostrare il contenuto dell'annuncio nell'app.
Questa pagina mostra come utilizzare l'SDK per caricare annunci nativi.
Prerequisiti
- Completa la Guida introduttiva.
Effettua sempre test con annunci di prova
Durante la creazione e il test delle tue app, assicurati di utilizzare annunci di prova anziché annunci di produzione attivi.
Il modo più semplice per caricare annunci di prova è utilizzare il nostro ID unità pubblicitaria di prova dedicato per gli annunci nativi su Android:
/21775744923/example/native
È stato appositamente configurato per restituire annunci di prova per ogni richiesta usalo nelle tue app durante la programmazione, i test e il debug. Assicurati solo di sostituirlo con il tuo ID unità pubblicitaria prima di pubblicare l'app.
Per ulteriori informazioni su come funzionano gli annunci di prova dell'SDK Google Mobile Ads, consulta Annunci di prova.
Carica annunci
Gli annunci nativi vengono caricati
AdLoader
,
che ha il suo
Builder
per personalizzarlo durante la creazione. Aggiungendo listener a AdLoader
durante la sua creazione, un'app specifica per quali tipi di annunci nativi
ricevere. AdLoader
richiede quindi solo questi tipi.
Crea un AdLoader
Il seguente codice mostra come creare un'AdLoader
in grado di caricare annunci nativi
annunci:
Java
AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
.forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
@Override
public void onNativeAdLoaded(NativeAd nativeAd) {
// Show the ad.
}
})
.withAdListener(new AdListener() {
@Override
public void onAdFailedToLoad(LoadAdError adError) {
// Handle the failure by logging, altering the UI, and so on.
}
})
.withNativeAdOptions(new NativeAdOptions.Builder()
// Methods in the NativeAdOptions.Builder class can be
// used here to specify individual options settings.
.build())
.build();
Kotlin
val adLoader = AdLoader.Builder(this, "/21775744923/example/native}")
.forNativeAd { ad : NativeAd ->
// Show the ad.
}
.withAdListener(object : AdListener() {
override fun onAdFailedToLoad(adError: LoadAdError) {
// Handle the failure.
}
})
.withNativeAdOptions(NativeAdOptions.Builder()
// Methods in the NativeAdOptions.Builder class can be
// used here to specify individual options settings.
.build())
.build()
La
forNativeAd()
responsabile della preparazione di AdLoader
per il formato NativeAd
.
Dopo che un annuncio è stato caricato correttamente, l'elemento onNativeAdLoaded()
dell'oggetto listener
.
Impostare un AdListener con AdLoader (facoltativo)
Quando crei l'AdLoader
,
withAdListener
imposta una funzione
AdListener
per
caricatore di emergenza. Il metodo prende un AdListener
come parametro unico, che riceve
callback da AdLoader
quando si verificano eventi del ciclo di vita dell'annuncio:
Java
.withAdListener(new AdListener() {
// AdListener callbacks can be overridden here.
})
Kotlin
.withAdListener(object : AdListener() {
// AdListener callbacks can be overridden here.
})
Richiedi annunci
Dopo aver completato la creazione di un AdLoader
, è il momento di utilizzarlo per richiedere annunci.
Utilizza il metodo loadAd()
, che prende un
AdManagerAdRequest
come primo parametro. È lo stesso
Classe AdManagerAdRequest
utilizzata da banner e interstitial,
e puoi usare i metodi della classe AdManagerAdRequest
aggiungere informazioni sul targeting, proprio come
che faresti con gli altri formati di annunci.
loadAd()
Questo metodo invia una richiesta per un singolo annuncio.
Java
adLoader.loadAd(new AdManagerAdRequest.Builder().build());
Kotlin
adLoader.loadAd(AdManagerAdRequest.Builder().build())
Callback
Dopo una chiamata al numero loadAd()
, viene eseguito un singolo callback all'elemento definito in precedenza
metodi di ascolto per pubblicare l'oggetto annuncio nativo o segnalare un errore.
Svincola risorse
Assicurati di utilizzare il metodo destroy()
per gli annunci nativi caricati. Questa release
utilizzate le risorse e previene le fughe di memoria.
Assicurati che tutti i riferimenti NativeAd
vengano eliminati nel file
Metodo onDestroy()
.
Nel callback onNativeAdLoaded
, assicurati di eliminare tutti
gli annunci nativi che verranno
dereferenziati.
Un altro controllo della chiave è se l'attività viene eliminata e, in questo caso, chiama destroy()
su
l'annuncio restituito e lo restituisce immediatamente:
Java
final AdLoader adLoader = new AdLoader.Builder(this, "/21775744923/example/native")
.forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
@Override
public void onNativeAdLoaded(NativeAd nativeAd) {
// If this callback occurs after the activity is destroyed, you
// must call destroy and return or you may get a memory leak.
// Note `isDestroyed()` is a method on Activity.
if (isDestroyed()) {
nativeAd.destroy();
return;
}
...
}
}).build();
Kotlin
lateinit var adLoader: AdLoader
...
adLoader = AdLoader.Builder(this, "/21775744923/example/native")
.forNativeAd { nativeAd ->
// If this callback occurs after the activity is destroyed, you
// must call destroy and return or you may get a memory leak.
// Note `isDestroyed` is a method on Activity.
if (isDestroyed) {
nativeAd.destroy()
return@forNativeAd
}
...
}.build()
Best practice
Segui queste regole durante il caricamento degli annunci.
Le app che utilizzano annunci nativi in un elenco dovrebbero prememorizzare nella cache l'elenco di annunci.
Quando esegui la pre-memorizzazione degli annunci nella cache, svuota la cache e ricarica la pagina dopo un'ora.
Non chiamare
loadAd()
suAdLoader
fino al primo viene completato il caricamento della richiesta.
Accelerazione hardware per annunci video
Affinché gli annunci video vengano mostrati correttamente nelle visualizzazioni degli annunci nativi, hardware di accelerazione devono essere abilitati.
L'accelerazione hardware è attiva per impostazione predefinita, ma alcune app potrebbero scegliere di farlo disabilitarlo. In questo caso, ti consigliamo di attivare l'hardware accelerazione per le classi attività che utilizzano gli annunci.
Attivazione dell'accelerazione hardware
Se l'app non funziona correttamente con l'accelerazione hardware attivata
a livello globale, puoi controllarlo anche
per le singole attività. Per attivare o
disattiva l'accelerazione hardware, usa l'attributo android:hardwareAccelerated
per
<application>
e
<activity>
in AndroidManifest.xml
. L'esempio seguente abilita l'hardware
l'accelerazione per l'intera app, ma la disattiva per un'attività:
<application android:hardwareAccelerated="true">
<!-- For activities that use ads, hardwareAcceleration should be true. -->
<activity android:hardwareAccelerated="true" />
<!-- For activities that don't use ads, hardwareAcceleration can be false. -->
<activity android:hardwareAccelerated="false" />
</application>
Visualizza l'accelerazione HW per Ulteriori informazioni sulle opzioni per il controllo dell'accelerazione hardware. Nota impossibile abilitare le visualizzazioni di singoli annunci per l'accelerazione hardware se L'attività è disattivata, pertanto l'attività stessa deve avere un'accelerazione hardware in un bucket in cui è abilitato il controllo delle versioni.
Mostra il tuo annuncio
Una volta caricato un annuncio, è sufficiente mostrarlo agli utenti. Vai al nostro corso native Advanced per scoprire come.