Formati di annunci nativi personalizzati
Oltre ai formati nativi definiti dal sistema, i publisher di Ad Manager hanno la possibilità di creare i propri formati di annunci nativi definendo elenchi personalizzati di asset. Questi sono chiamati formati di annunci nativi personalizzati e possono essere utilizzati con gli annunci prenotati. Ciò consente ai publisher di trasmettere dati strutturati arbitrari alle
loro app. Questi annunci sono rappresentati dall'oggetto NativeCustomFormatAd
.
Carica formati di annunci nativi personalizzati
Questa guida spiega come caricare e visualizzare formati di annunci nativi personalizzati.
Crea un AdLoader
Come per gli annunci nativi, i formati di annunci nativi personalizzati vengono caricati utilizzando la classe AdLoader
:
Java
AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/native") .forCustomFormatAd("10063170", new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() { @Override public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) { // Show the custom format and record an impression. } }, new NativeCustomFormatAd.OnCustomClickListener() { @Override public void onCustomClick(NativeCustomFormatAd ad, String s) { // Handle the click action } }) .withAdListener( ... ) .withNativeAdOptions( ... ) .build();
Kotlin
val adLoader = AdLoader.Builder(this, "/6499/example/native") .forCustomFormatAd("10063170", { ad -> // Show the custom format and record an impression. }, { ad, s -> // Handle the click action }) .withAdListener( ... ) .withNativeAdOptions( ... ) .build()
Il metodo forCustomFormatAd
configura AdLoader
in modo che richieda formati di annunci nativi personalizzati. Il metodo include tre parametri:
- L'ID del formato di annuncio nativo personalizzato che l'
AdLoader
deve richiedere. Ogni formato di annuncio nativo personalizzato ha un ID associato. Questo parametro indica il formato che la tua app deve richiedere per l'elementoAdLoader
. - Un elemento
OnCustomFormatAdLoadedListener
da richiamare quando un annuncio è stato caricato correttamente. - Un elemento
OnCustomClickListener
facoltativo da richiamare quando l'utente tocca o fa clic sull'annuncio. Per ulteriori informazioni su questo ascoltatore, consulta la sezione "Gestione di clic e impressioni" riportata di seguito.
Poiché una singola unità pubblicitaria può essere configurata per pubblicare più di un formato
creatività, è possibile chiamare più volte forCustomFormatAd
con ID formato univoci
in modo da preparare il caricatore di annunci per più di un possibile
formato di annunci nativi personalizzato.
ID formato dell'annuncio nativo personalizzato
L'ID formato utilizzato per identificare un formato di annuncio nativo personalizzato è disponibile nell'interfaccia utente di Ad Manager nella sezione Nativi del menu a discesa Pubblicazione:
Ogni ID formato di annuncio nativo personalizzato viene visualizzato accanto al relativo nome. Se fai clic su uno dei nomi, viene visualizzata una schermata dei dettagli con informazioni sui campi del formato:
Da qui è possibile aggiungere, modificare e rimuovere singoli campi. Prendi nota del nome di ogni risorsa. Il nome è la chiave utilizzata per ottenere i dati relativi a ogni asset quando mostri il formato di annuncio nativo personalizzato.
Mostra formati di annunci nativi personalizzati
I formati di annunci nativi personalizzati sono diversi da quelli definiti dal sistema perché i publisher hanno la possibilità di definire il proprio elenco di asset che compongono un annuncio. Pertanto, la procedura di visualizzazione di un formato differisce dai formati definiti dal sistema per i seguenti aspetti:
- Poiché la classe
NativeCustomFormatAd
è pensata per gestire i formati di annunci nativi personalizzati che definisci in Ad Manager, non ha denominati "getter" per gli asset. Offre invece metodi comegetText
egetImage
che prendono il nome del campo come parametro. - Non esiste una classe di visualizzazione degli annunci dedicata come
NativeAdView
da utilizzare conNativeCustomFormatAd
. Puoi usare qualsiasi layout adatto all'esperienza utente. - Poiché non esiste una classe
ViewGroup
dedicata, non è necessario registrare le visualizzazioni che utilizzi per mostrare gli asset dell'annuncio. In questo modo puoi risparmiare alcune righe di codice durante la visualizzazione dell'annuncio, ma devi anche svolgere un ulteriore lavoro per gestire i clic in un secondo momento.
Ecco una funzione di esempio che mostra una NativeCustomFormatAd
:
Java
public void displayCustomFormatAd (ViewGroup parent, NativeCustomFormatAd customFormatAd) { // Inflate a layout and add it to the parent ViewGroup. LayoutInflater inflater = (LayoutInflater) parent.getContext() .getSystemService(Context.LAYOUT_INFLATER_SERVICE); View adView = inflater.inflate(R.layout.custom_format_ad, parent); // Locate the TextView that will hold the value for "Headline" and // set its text. TextView myHeadlineView = (TextView) adView.findViewById(R.id.headline); myHeadlineView.setText(customFormatAd.getText("Headline")); // Locate the ImageView that will hold the value for "MainImage" and // set its drawable. Button myMainImageView = (ImageView) adView.findViewById(R.id.main_image); myMainImageView.setImageDrawable( customFormatAd.getImage("MainImage").getDrawable()); ... // Continue locating views and displaying assets until finished. ... }
Kotlin
public fun displayCustomFormatAd (parent: ViewGroup, customFormatAd: NativeCustomFormatAd) { val adView = layoutInflater .inflate(R.layout.ad_simple_custom_format, null) val myHeadlineView = adView.findViewById<TextView>(R.id.headline) myHeadlineView.setText(customFormatAd.getText("Headline")); // Locate the ImageView that will hold the value for "MainImage" and // set its drawable. val myMainImageView = adView.findViewById(R.id.main_image); myMainImageView.setImageDrawable( customFormatAd.getImage("MainImage").drawable; ... // Continue locating views and displaying assets until finished. ... }
Video nativo per formati di annunci nativi personalizzati
Quando crei un formato personalizzato, puoi renderlo idoneo per i video.
Nell'implementazione dell'app, puoi utilizzare NativeCustomFormatAd.getMediaContent()
per ottenere i contenuti multimediali. Quindi chiama il numero setMediaContent()
per impostare i contenuti multimediali sulla visualizzazione multimediale.
Se l'annuncio non include contenuti video, pensa a piani alternativi per mostrare
l'annuncio senza video.
L'esempio riportato di seguito consente di verificare se l'annuncio include contenuti video e di visualizzare un'immagine al suo posto se il video non è disponibile:
Java
// Called when a custom native ad loads. @Override public void onCustomFormatAdLoaded(final NativeCustomFormatAd ad) { MediaContent mediaContent = ad.getMediaContent(); // Assumes you have a FrameLayout in your view hierarchy with the id media_placeholder. FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder); // Apps can check the MediaContent's hasVideoContent property to determine if the // NativeCustomFormatAd has a video asset. if (mediaContent != null && mediaContent.hasVideoContent()) { MediaView mediaView = new MediaView(mediaPlaceholder.getContext()); mediaView.setMediaContent(mediaContent); mediaPlaceholder.addView(mediaView); // Create a new VideoLifecycleCallbacks object and pass it to the VideoController. The // VideoController will call methods on this object when events occur in the video // lifecycle. VideoController vc = mediaContent.getVideoController(); vc.setVideoLifecycleCallbacks( new VideoController.VideoLifecycleCallbacks() { @Override public void onVideoEnd() { // Publishers should allow native ads to complete video playback before // refreshing or replacing them with another ad in the same UI location. super.onVideoEnd(); } }); } else { ImageView mainImage = new ImageView(this); mainImage.setAdjustViewBounds(true); mainImage.setImageDrawable(ad.getImage("MainImage").getDrawable()); mediaPlaceholder.addView(mainImage); mainImage.setOnClickListener( new View.OnClickListener() { @Override public void onClick(View view) { ad.performClick("MainImage"); } }); } }
Kotlin
// Called when a custom native ad loads. NativeCustomFormatAd.OnCustomFormatAdLoadedListener { ad -> val mediaContent = ad.mediaContent // Apps can check the MediaContent's hasVideoContent property to determine if the // NativeCustomFormatAd has a video asset. if (mediaContent != null && mediaContent.hasVideoContent()) { val mediaView = MediaView(mediaPlaceholder.getContest()) mediaView.mediaContent = mediaContent val videoController = mediaContent.videoController // Create a new VideoLifecycleCallbacks object and pass it to the VideoController. The // VideoController will call methods on this object when events occur in the video // lifecycle. if (videoController != null) { videoController.videoLifecycleCallbacks = object : VideoController.VideoLifecycleCallbacks() { override fun onVideoEnd() { // Publishers should allow native ads to complete video playback before refreshing // or replacing them with another ad in the same UI location. super.onVideoEnd() } } } } else { val mainImage = ImageView(this) mainImage.adjustViewBounds = true mainImage.setImageDrawable(ad.getImage("MainImage")?.drawable) mainImage.setOnClickListener { ad.performClick("MainImage") } customTemplateBinding.simplecustomMediaPlaceholder.addView(mainImage) } }
Per ulteriori informazioni su come personalizzare l'esperienza video di un annuncio nativo personalizzato, consulta MediaContent.
Scarica l'esempio di rendering personalizzato di Ad Manager per un esempio funzionante di video nativo in azione.
Impressioni e clic su formati di annunci nativi personalizzati
Con i formati di annunci nativi personalizzati, la tua app deve registrare le impressioni e generare report sugli eventi di clic nell'SDK Google Mobile Ads.
Registra impressioni
Per registrare un'impressione per un annuncio in formato personalizzato, chiama il metodo recordImpression
sul NativeCustomFormatAd
corrispondente:
myCustomFormatAd.recordImpression();
Se la tua app chiama accidentalmente il metodo due volte per lo stesso annuncio, l'SDK impedisce automaticamente la registrazione di un'impressione duplicata per una singola richiesta.
Clic nei report
Per segnalare all'SDK che si è verificato un clic su una visualizzazione di asset, chiama il metodo performClick
sul NativeCustomFormatAd
corrispondente e trasmetti il nome dell'asset su cui è stato fatto clic. Ad esempio, se avessi un asset nel tuo formato personalizzato denominato "MainImage" e volessi registrare un clic sull'elemento ImageView
corrispondente a quell'asset, il codice sarà simile al seguente:
myCustomFormatAd.performClick("MainImage");
Tieni presente che non è necessario chiamare questo metodo per ogni vista associata al tuo annuncio. Se avessi un altro campo chiamato "Sottotitolo" che doveva essere mostrato, ma che l'utente non ha toccato o selezionato, la tua app non avrebbe bisogno di chiamare performClick
per la visualizzazione di quell'asset.
Rispondere ad azioni di clic personalizzate
Quando viene eseguito un clic su un annuncio in formato personalizzato, l'SDK richiede tre possibili risposte, tentate in questo ordine:
- Richiama
OnCustomClickListener
daAdLoader
, se ne è stata fornita una. - Per ogni URL link diretto dell'annuncio, cerca di individuare un resolver di contenuti e avvia il primo che si risolve.
- Apri un browser e vai all'URL di destinazione tradizionale dell'annuncio.
Il metodo forCustomFormatAd
accetta un OnCustomClickListener
. Se passi all'interno di un oggetto listener, l'SDK richiama il proprio metodo onCustomClick
e non esegue ulteriori azioni. Se passi un valore null come listener, tuttavia, l'SDK utilizza il link diretto e/o gli URL di destinazione registrati con l'annuncio.
I listener di clic personalizzati consentono alla tua app di decidere l'azione migliore da intraprendere in risposta a un clic, che si tratti di aggiornare l'interfaccia utente, avviare una nuova attività o semplicemente registrare il clic. Ecco un esempio che registra semplicemente un clic:
Java
AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/native") .forCustomFormatAd("10063170", new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() { // Display the ad. }, new NativeCustomFormatAd.OnCustomClickListener() { @Override public void onCustomClick(NativeCustomFormatAd ad, String assetName) { Log.i("MyApp", "A custom click just happened for " + assetName + "!"); } }).build();
Kotlin
val adLoader = AdLoader.Builder(this, "/6499/example/native") .forCustomFormatAd("10063170", { ad -> // Display the ad. }, { ad, assetName -> Log.i("MyApp", "A custom click just happened for $assetName!") }).build()
All'inizio potrebbe sembrare strano che esistano listener di clic personalizzati. Dopotutto, la tua app ha appena comunicato all'SDK che si è verificato un clic, perché l'SDK dovrebbe girare e segnalare il problema all'app?
Questo flusso di informazioni è utile per diversi motivi, ma soprattutto consente all'SDK di mantenere il controllo della risposta al clic. Ad esempio, può eseguire il ping automatico degli URL di monitoraggio di terze parti impostati per la creatività e gestire altre attività in background, senza alcun codice aggiuntivo.