Se usó la API de Cloud Translation para traducir esta página.

Implementación nativa de AFS para Android

El SDK de anuncios de Google para dispositivos móviles también admite estilos del anuncio de búsqueda personalizados. Si tu app ya usa el SDK de anuncios de Google para dispositivos móviles, te recomendamos que uses la versión del SDK de AFSMA.

Si estás actualizando a la versión 19.0.0 o a una posterior desde la versión 18.1.0 o una anterior, consulta nuestra guía de migración.

Requisitos previos

En esta guía de implementación, se supone que estás familiarizado con los siguientes elementos:

Anuncios de búsqueda personalizados de AdSense con estilos del anuncio de búsqueda personalizados
Desarrollo de apps para Android

Importa el SDK nativo de AFS

Cómo agregar el SDK

Para agregar el SDK nativo de AFS a tu app, haz lo siguiente:

Abre el archivo build.gradle dentro del directorio del módulo de tu aplicación. Agrega una nueva regla de compilación en dependencies para la versión más reciente del SDK:

dependencies {
  implementation 'com.google.android.gms:play-services-afs-native:19.1.0'
}

Asegúrate de que tu build.gradle de nivel superior contenga una referencia a google(). repo o a maven { url "https://maven.google.com" }.

Sigue estas instrucciones. para incluir el complemento de coincidencia de versiones independientes de Google Play en tu proyecto. La aplicación de este complemento genera un error de compilación de Gradle cuando el SDK nativo de AFS se usa con una versión incompatible de los Servicios de Google Play, en lugar de permitir que se compile la app, lo que podría provocar fallas en el tiempo de ejecución. También puedes aplicar failOnVersionConflict() ResolutionStrategy a tu proyecto para generar un error de compilación cuando se usen versiones incompatibles de los Servicios de Google Play en tu proyecto. Guarda los cambios y haz clic en Sync Project with Gradle Files en la barra de herramientas.

Cómo usar AndroidX en lugar de las bibliotecas de compatibilidad de Android

A partir de la versión 17.0.0 del SDK, tu app debe usar bibliotecas de Jetpack (AndroidX) en lugar de bibliotecas de compatibilidad de Android. Requisitos de compatibilidad:

Establece com.android.tools.build:gradle en la versión 3.2.1 o una posterior.
Establece compileSdkVersion en 28 o una versión posterior.
Actualiza tu app para usar Jetpack (AndroidX). sigue las instrucciones de Cómo migrar a AndroidX.

Clases

Para publicar anuncios nativos de AFS en tu app, implementa las siguientes clases:

SearchAdController

Esta clase se encarga de solicitar anuncios de manera asíncrona, almacenar en caché y la recuperación y la renderización de anuncios.
Cada contexto de anuncio necesita un SearchAdController independiente. Por ejemplo, si tienes una pantalla que muestra anuncios junto con una lista de resultados de la búsqueda y otra que muestra anuncios junto con los detalles de un producto específico, debes crear dos instancias independientes de SearchAdController, una para cada caso.
Se le debe proporcionar al constructor tu código de propiedad web (ID del publicador) style ID para aplicar anuncios mostrados, y SearchAdOptions. El Context proporcionado en el constructor debe ser el Activity que contiene el SearchAdController y donde colocará el anuncio View.
Llama a loadAds para indicar una nueva búsqueda de usuario y, luego, inicia un anuncio asíncrono. para cada solicitud. Los anuncios cargados desde llamadas anteriores a loadAds se borran de la caché de anuncios interna cuando se realiza una llamada nueva.
Crea un View con createAdView para mostrar creatividades de anuncios.
Una vez que se hayan cargado los anuncios, llama a populateAdView con un View generado previamente con createAdView para renderizar un anuncio almacenado en caché en ese View. Además del artículo View, que se debe propagar, proporciona un adKey, una cadena arbitraria a identificar el anuncio de manera inequívoca. Esto asocia la creatividad del anuncio específica que se muestra desde la caché con ese adKey, de modo que, cuando se pase el mismo adKey a una llamada futura a populateAdView, se mostrará el mismo anuncio. Por ejemplo, si se llama a populateAdView por primera vez con adKey="keyA" y se renderiza un anuncio de botas de excursionismo, cada llamada posterior a populateAdView con adKey="keyA" propagará el mismo anuncio de botas de excursionismo. (Si haces una nueva llamada a loadAds borra todos los anuncios almacenados en caché y las claves de anuncio asociadas).

SearchAdOptions

Pasa este objeto al constructor SearchAdController para personalizar la forma en que se muestran los anuncios. se solicitan y muestran los datos. Llama a build() en un SearchAdOptions.Builder para crear un objeto SearchAdOptions.

View

Crea un objeto View para retener anuncios. Para ello, llama a createAdView() en el SearchAdController Muestra, como máximo, un anuncio a la vez, pero sí se puede modificar el mismo View se reciclen para mostrar diferentes anuncios a lo largo del tiempo.

SearchAdRequest

Llama al método loadAds en SearchAdController con un SearchAdRequest para iniciar una solicitud de anuncio asíncrona. Llamar a build() en un SearchAdRequest.Builder para crear un objeto SearchAdRequest.

AdListener

Implementa esta interfaz y pásala al constructor SearchAdController para registrar devoluciones de llamada para varios estados.
Nota: No se realizarán devoluciones de llamada de AdListener en una solicitud cancelada (una llamada a loadAds que se interrumpió por otra llamada a loadAds antes de la primera llamada resuelta).

Ejemplo de implementación

En el siguiente ejemplo, se muestra cómo crear un SearchAdController en un Activity de muestra.

//  MainActivity.java implementation
//  (MainActivity is a subclass of Activity)

SearchAdController adController;
// adContainer where we will place our ads in this example.
ViewGroup adContainer;

protected void onCreate(Bundle bundle){
  super.onCreate(bundle);
  adContainer = (ViewGroup) findViewById(...);
  // Specify ad options (not required).
  SearchAdOptions.Builder adOptionsBuilder = new SearchAdOptions.Builder();
  adOptionsBuilder.setAdType(SearchAdOptions.AD_TYPE_TEXT);
  adOptionsBuilder.setPrefetch(true);
  adOptionsBuilder.setNumAdsRequested(3);
  // Provide a callback to trigger when ads are loaded.
  AdListener adListener = new AdListener() {
    public void onAdLoaded() {
      createAndShowAd();
    }
  };
  // Instantiate the SearchAdController.
  adController = new SearchAdController(this, "your-client-id", "your-style-id",
                                        adOptionsBuilder.build(), adListener);
}

Cuando el usuario inicie una consulta, crea un SearchAdRequest y llama a loadAds. en SearchAdController para iniciar una solicitud de anuncio asíncrona.

// Create the request.
SearchAdRequest.Builder requestBuilder = new SearchAdRequest.Builder();
requestBuilder.setQuery("user query here");
// Load the ads.
adController.loadAds(requestBuilder.build());

Implementa tu devolución de llamada de onAdLoaded para propagar un anuncio cargado en una vista de anuncio.

private void createAndShowAd() {
  // Create a new view that will contain the ad.
  View adView = adController.createAdView();
  // Attach the new view to the view hierarchy.
  adContainer.addView(adView);
  // Display the ad inside the adView. We need to provide an adKey to
  // indicate which ad is to be displayed in the adView. In this example, 
  // since we only have one ad, we can provide any constant string. However, 
  // if you intend to display multiple ads, each ad you wish to display
  // should be given a unique adKey of your choosing.
  adController.populateAdView(adView, "demoAd");
}

Ahora, aparecerá un anuncio relacionado con la búsqueda en adView.

Investiga errores

SearchAdController requiere un objeto AdListener con el método onAdLoaded() para notificarle a tu app que los anuncios están listos para mostrarse. También debes Implementa el método onAdFailedToLoad() para detectar y corregir errores. Por ejemplo, puedes usar el siguiente AdListener para depurar tu implementación:

AdListener adListener = new AdListener() {
    public void onAdLoaded() {
        // Called when an ad is loaded.
        Toast.makeText(MainActivity.this, "Ad Loaded",
                Toast.LENGTH_SHORT).show();
        Log.d(MainActivity.class.getSimpleName(), "Ad Loaded");
    }

    public void onAdLeftApplication() {
        // Called when an ad leaves the application
        // (to go to the browser for example).
        Toast.makeText(MainActivity.this, "Ad Left Application",
                Toast.LENGTH_SHORT).show();
        Log.d(MainActivity.class.getSimpleName(), "Ad Left Application");
    }

    @Override
    public void onAdFailedToLoad(int errorCode) {
        // Called when an ad request failed.
        Toast.makeText(MainActivity.this, "Ad Failed to Load: " + errorCode,
                Toast.LENGTH_SHORT).show();
        Log.e(MainActivity.class.getSimpleName(), "Ad Failed to Load: " +
                errorCode);
    }
};

Las constantes que se usan en el método de devolución de llamada onAdFailedToLoad() se definen en AdListener.