Cómo mostrar un Anuncio
Cuando se carga un anuncio nativo, el SDK de anuncios de Google para dispositivos móviles invoca el objeto de escucha del formato del anuncio correspondiente. Luego, tu app se encarga de mostrar el anuncio, aunque no necesariamente tiene que hacerlo de inmediato. Para facilitar la visualización de formatos de anuncios definidos por el sistema, el SDK ofrece algunos recursos útiles, como se describe a continuación.
Clase NativeAdView
Para el formato NativeAd
, existe la clase NativeAdView
correspondiente. Esta clase es un ViewGroup
que los editores deben usar como raíz para NativeAd
. Un solo NativeAdView
corresponde a un único anuncio nativo.
Cada vista que se usa para mostrar los elementos de ese anuncio (por ejemplo, el elemento ImageView
que muestra el recurso de captura de pantalla) debe ser un elemento secundario del objeto NativeAdView
.
La jerarquía de vistas de un anuncio nativo que usa un LinearLayout
para mostrar sus vistas de elementos podría tener el siguiente aspecto:
<com.google.android.gms.ads.nativead.NativeAdView
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<LinearLayout
android:orientation="vertical"
... >
<LinearLayout
android:orientation="horizontal"
... >
<ImageView
android:id="@+id/ad_app_icon"
... />
<TextView
android:id="@+id/ad_headline"
... />
</LinearLayout>
// Other assets such as image or media view, call to action, etc follow.
...
</LinearLayout>
</com.google.android.gms.ads.nativead.NativeAdView>
A continuación, se muestra un ejemplo que crea un NativeAdView
y lo propaga con un NativeAd
:
Java
AdLoader.Builder builder = new AdLoader.Builder(this, "AD_UNIT_ID")
.forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
@Override
public void onNativeAdLoaded(NativeAd nativeAd) {
// Assumes you have a placeholder FrameLayout in your View layout
// (with id fl_adplaceholder) where the ad is to be placed.
FrameLayout frameLayout =
findViewById(R.id.fl_adplaceholder);
// Assumes that your ad layout is in a file call native_ad_layout.xml
// in the res/layout folder
NativeAdView adView = (NativeAdView) getLayoutInflater()
.inflate(R.layout.native_ad_layout, null);
// This method sets the text, images and the native ad, etc into the ad
// view.
populateNativeAdView(nativeAd, adView);
frameLayout.removeAllViews();
frameLayout.addView(adView);
}
});
Kotlin
val builder = AdLoader.Builder(this, "AD_UNIT_ID")
.forNativeAd { nativeAd ->
// Assumes that your ad layout is in a file call native_ad_layout.xml
// in the res/layout folder
val adView = layoutInflater
.inflate(R.layout.native_ad_layout, null) as NativeAdView
// This method sets the text, images and the native ad, etc into the ad
// view.
populateNativeAdView(nativeAd, adView)
// Assumes you have a placeholder FrameLayout in your View layout
// (with id ad_frame) where the ad is to be placed.
ad_frame.removeAllViews()
ad_frame.addView(adView)
}
Ten en cuenta que todos los elementos de un anuncio nativo determinado deben renderizarse dentro del diseño de NativeAdView
. El SDK de anuncios de Google para dispositivos móviles intenta registrar una advertencia cuando los elementos nativos se renderizan fuera de un diseño de vista de anuncio nativo.
Las clases de vista de anuncios también proporcionan métodos para registrar la vista que se usa con cada recurso individual y una para registrar el objeto NativeAd
en sí.
Registrar las vistas de esta manera permite que el SDK controle automáticamente tareas como las siguientes:
- Registro de clics
- Registro de impresiones cuando el primer píxel está visible en la pantalla
- Se muestra la superposición de AdChoices para las creatividades de reabastecimiento nativo (actualmente limitado a un grupo selecto de publicadores)
Superposición de AdChoices
El SDK agrega una superposición de AdChoices como una vista de anuncio cuando se muestra un anuncio de reabastecimiento. Si tu app usa reabastecimiento de anuncios nativos, deja espacio en la esquina preferida de la vista de anuncios nativos para el logotipo de AdChoices insertado automáticamente. Además, es importante que la superposición de AdChoices se vea fácilmente, por lo que debes elegir los colores de fondo y las imágenes de manera adecuada. Para obtener más información sobre el aspecto y la función de la superposición, consulta los lineamientos de implementación de anuncios nativos programáticos.
Atribución de anuncios programáticos nativos
Cuando muestras anuncios programáticos nativos, debes mostrar una atribución de anuncio para indicar que la vista es un anuncio. Obtén más información en nuestros lineamientos de políticas.
Ejemplo de código
Estos son los pasos para mostrar un anuncio nativo:
- Crea una instancia de la clase
NativeAdView
. - Para cada recurso del anuncio que se muestre, haz lo siguiente:
- Completa la vista de recursos con el recurso del objeto de anuncio.
- Registra la vista de recursos con la clase
ViewGroup
.
- Registra el objeto
MediaView
si el diseño de tu anuncio nativo incluye un recurso multimedia grande. - Registra el objeto de anuncio con la clase
ViewGroup
.
A continuación, se incluye una función de ejemplo que muestra un NativeAd
:
Java
private void displayNativeAd(ViewGroup parent, NativeAd ad) {
// Inflate a layout and add it to the parent ViewGroup.
LayoutInflater inflater = (LayoutInflater) parent.getContext()
.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
NativeAdView adView = (NativeAdView) inflater
.inflate(R.layout.ad_layout_file, parent);
// Locate the view that will hold the headline, set its text, and call the
// NativeAdView's setHeadlineView method to register it.
TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline);
headlineView.setText(ad.getHeadline());
adView.setHeadlineView(headlineView);
...
// Repeat the above process for the other assets in the NativeAd
// using additional view objects (Buttons, ImageViews, etc).
...
// If the app is using a MediaView, it should be
// instantiated and passed to setMediaView. This view is a little different
// in that the asset is populated automatically, so there's one less step.
MediaView mediaView = (MediaView) adView.findViewById(R.id.ad_media);
adView.setMediaView(mediaView);
// Call the NativeAdView's setNativeAd method to register the
// NativeAdObject.
adView.setNativeAd(ad);
// Ensure that the parent view doesn't already contain an ad view.
parent.removeAllViews();
// Place the AdView into the parent.
parent.addView(adView);
}
Kotlin
fun displayNativeAd(parent: ViewGroup, ad: NativeAd) {
// Inflate a layout and add it to the parent ViewGroup.
val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE)
as LayoutInflater
val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView
// Locate the view that will hold the headline, set its text, and use the
// NativeAdView's headlineView property to register it.
val headlineView = adView.findViewById<TextView>(R.id.ad_headline)
headlineView.text = ad.headline
adView.headlineView = headlineView
...
// Repeat the above process for the other assets in the NativeAd using
// additional view objects (Buttons, ImageViews, etc).
...
val mediaView = adView.findViewById<MediaView>(R.id.ad_media)
adView.mediaView = mediaView
// Call the NativeAdView's setNativeAd method to register the
// NativeAdObject.
adView.setNativeAd(ad)
// Ensure that the parent view doesn't already contain an ad view.
parent.removeAllViews()
// Place the AdView into the parent.
parent.addView(adView)
}
Estas son las tareas individuales:
Cómo aumentar el diseño
Java
LayoutInflater inflater = (LayoutInflater) parent.getContext() .getSystemService(Context.LAYOUT_INFLATER_SERVICE); NativeAdView adView = (NativeAdView) inflater .inflate(R.layout.ad_layout_file, parent);
Kotlin
val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE) as LayoutInflater val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView
Con este código, se aumenta un diseño XML que contiene vistas para mostrar un anuncio nativo y, luego, se ubica una referencia al
NativeAdView
. Ten en cuenta que también puedes reutilizar unNativeAdView
existente si hay uno en tu fragmento o actividad, o bien crear una instancia de forma dinámica sin usar un archivo de diseño.Propaga y registra las vistas de recursos
En este código de muestra, se localiza la vista que se usa para mostrar el título, se establece su texto con el recurso de string que proporciona el objeto de anuncio y se registra con el objeto
NativeAdView
:Java
TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline); headlineView.setText(ad.getHeadline()); adView.setHeadlineView(headlineView);
Kotlin
val headlineView = adView.findViewById<TextView>(R.id.ad_headline) headlineView.text = ad.headline adView.headlineView = headlineView
Este proceso de ubicar la vista, configurar su valor y registrarla con la clase de vista de anuncio se debe repetir para cada uno de los recursos que proporciona el objeto de anuncio nativo que mostrará la app.
Cómo controlar los clics
No implementes ningún controlador de clics personalizado en ninguna vista sobre o dentro de la vista de anuncio nativo. Para observar los eventos de clic por tu cuenta, usa el objeto de escucha de anuncios.
El SDK controla los clics en los recursos de vista de anuncio, siempre que propagas y registres las vistas de recursos de forma correcta, como se explica en la sección anterior.
El siguiente ejemplo usa un objeto de escucha de anuncios para observar eventos de clic:
Java
AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/native") ... .withAdListener(new AdListener() { @Override public void onAdFailedToLoad(LoadAdError adError) { // Handle the failure by logging, altering the UI, and so on. } @Override public void onAdClicked() { // Log the click event or other custom behavior. } }) .build();
Kotlin
val adLoader = AdLoader.Builder(this, "/6499/example/native") ... .withAdListener(object : AdListener() { override fun onAdFailedToLoad(adError: LoadAdError) { // Handle the failure by logging, altering the UI, and so on. } }) .build()
Registra MediaView
Si deseas incluir un recurso de imagen principal en el diseño de tu anuncio nativo, debes usar el recurso
MediaView
en lugar del recursoImageView
.MediaView
es unView
especial diseñado para mostrar el elemento multimedia principal, ya sea video o imagen.MediaView
se puede definir en un diseño XML o construirse de forma dinámica. Debe colocarse dentro de la jerarquía de vistas de unNativeAdView
, al igual que cualquier otra vista de elementos. Las apps que usan unMediaView
deben registrarlo conNativeAdView
:Java
MediaView mediaView = adView.findViewById(R.id.ad_media); adView.setMediaView(mediaView);
Kotlin
adView.mediaView = adView.findViewById<MediaView>(R.id.ad_media)
Al igual que con todas las vistas de elementos, se debe propagar el contenido de la vista de medios. Para ello, usa el método
getMediaContent()
a fin de recuperar contenido multimedia que se pueda pasar aMediaView
. A continuación, se muestra un fragmento de código que configura el contenido multimedia para la vista multimedia:Java
mediaView.setMediaContent(nativeAd.getMediaContent());
Kotlin
mediaView.mediaContent = nativeAd.mediaContent
ImageScaleType
La clase
MediaView
tiene una propiedadImageScaleType
cuando se muestran imágenes. Si quieres cambiar el modo en que se escala una imagen enMediaView
, configura elImageView.ScaleType
correspondiente con el métodosetImageScaleType()
deMediaView
:Java
mediaView.setImageScaleType(ImageView.ScaleType.CENTER_CROP);
Kotlin
mediaView.imageScaleType = ImageView.ScaleType.CENTER_CROP
MediaContent
La clase
MediaContent
contiene los datos relacionados con el contenido multimedia del anuncio nativo, que se muestra con la claseMediaView
. Cuando la propiedadMediaView
mediaContent
se establece con una instanciaMediaContent
, ocurre lo siguiente:Si hay un elemento de video disponible, se almacena en búfer y comienza a reproducirse en
MediaView
. Para saber si un recurso de video está disponible, consultahasVideoContent()
.Si el anuncio no contiene un recurso de video, se descarga el recurso
mainImage
y se coloca dentro deMediaView
.
De forma predeterminada,
mainImage
es el primer recurso de imagen descargado. Si se usasetReturnUrlsForImageAssets(true)
,mainImage
esnull
y debes establecer la propiedadmainImage
en la imagen descargada manualmente. Ten en cuenta que esta imagen solo se usará cuando no haya recursos de video disponibles.Registra el objeto de anuncio nativo
En este paso final, se registra el objeto de anuncio nativo con la vista responsable de mostrarlo:
Java
adView.setNativeAd(ad);
Kotlin
adView.setNativeAd(ad)
Destruir anuncio
Cuando termines de mostrar tu anuncio nativo, debes destruirlo para que se recolecte correctamente para que se recolecte correctamente.
Java
nativeAd.destroy();
.inflate(R.layout.ad_layout_file, parent);
Kotlin
nativeAd.destroy()
Cómo probar el código de anuncio nativo
Anuncios de venta directa
Si deseas probar cómo son los anuncios nativos de venta directa, puedes usar este ID de unidad de anuncios de Ad Manager:
/6499/example/native
Está configurada para publicar anuncios de contenido y de instalación de apps de ejemplo, así como un formato de anuncio nativo personalizado con los siguientes elementos:
- Título (texto)
- Imagen principal (imagen)
- Leyenda (texto)
El ID de plantilla para el formato del anuncio nativo personalizado es 10063170
.
Anuncios de reabastecimiento nativos
Actualmente, el reabastecimiento de Ad Exchange se limita a un grupo selecto de publicadores. Para probar el comportamiento de los anuncios de reabastecimiento nativos, usa esta unidad de anuncios de Ad Manager:
/6499/example/native-backfill
Entrega anuncios de contenido y de instalación de apps de ejemplo que incluyen la superposición de AdChoices.
Recuerda actualizar el código para hacer referencia a los IDs de la unidad de anuncios y de la plantilla reales antes de publicarlo.
Ejemplos en GitHub
Ejemplo de implementación completa de anuncios nativos:
Próximos pasos
Explora los siguientes temas: