Cómo integrar la API de WebView para anuncios

Las APIs de WebView para anuncios ponen los indicadores de la app a disposición de las etiquetas incluidas en tu WebView, lo que ayuda a mejorar la monetización de los publicadores que proporcionaron el contenido y proteger a los anunciantes del spam. Estos indicadores de la app, como el ID y la versión de la app, ayudan a activar los casos de uso de Informes y Segmentación en el inventario de navegadores integrados en la app, que, de otro modo, solo están disponibles en el tráfico de la app.

Cómo funciona

La comunicación con el SDK de anuncios de Google para dispositivos móviles (beta) solo se produce en respuesta a eventos de anuncios activados por cualquiera de los siguientes elementos:

• Código de AdSense
• Google Publisher Tag
• IMA para HTML5

El SDK agrega controladores de mensajes a la clase WebView registrada para escuchar esos eventos de anuncios. Para comprender mejor cómo funciona, consulta el código fuente de la página de prueba.

Requisitos previos

• SDK de anuncios de Google para dispositivos móviles (beta) versión 0.6.0-alpha01 o posterior

Pasa el ID de aplicación al SDK

Si ya tienes un ID de aplicación de Ad Manager, inicializa el SDK de anuncios de Google para dispositivos móviles (beta) con tu ID de aplicación existente.

Si no tienes un ID de aplicación de Ad Manager, pasa InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID como el ID de aplicación cuando inicialices el SDK de anuncios de Google para dispositivos móviles (beta).

Kotlin

MobileAds.initialize(
    this@MainActivity,
    // Use this application ID to initialize the Google Mobile Ads SDK (beta) if
    // you don't have an Ad Manager application ID.
    InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
        .build(),
  ) {
    // Adapter initialization complete.
  }

Java

MobileAds.initialize(
    this,
    // Use this application ID to initialize the Google Mobile Ads SDK (beta) if
    // you don't have an Ad Manager application ID.
    new InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
        .build(),
        initializationStatus -> {
          // Adapter initialization is complete.
          });

Registra la vista web

Llama a registerWebView() en el subproceso principal para establecer una conexión con los controladores de JavaScript en el código de AdSense o Google Publisher Tag dentro de cada instancia de WebView. Esto se debería hacer lo más pronto posible, como en el método onCreate() de tu MainActivity.

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView
import com.google.android.libraries.ads.mobile.sdk.MobileAds

class MainActivity : AppCompatActivity() {
  lateinit var webView: WebView

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    webView = findViewById(R.id.webview)

    // Let the web view accept third-party cookies.
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)
    // Let the web view use JavaScript.
    webView.settings.javaScriptEnabled = true
    // Let the web view access local storage.
    webView.settings.domStorageEnabled = true
    // Let HTML videos play automatically.
    webView.settings.mediaPlaybackRequiresUserGesture = false

    // Register the web view.
    MobileAds.registerWebView(webView)
  }
}

Java

import android.webkit.CookieManager;
import android.webkit.WebView;
import com.google.android.libraries.ads.mobile.sdk.MobileAds;

public class MainActivity extends AppCompatActivity {
  private WebView webView;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    webView = findViewById(R.id.webview);

    // Let the web view accept third-party cookies.
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true);
    // Let the web view use JavaScript.
    webView.getSettings().setJavaScriptEnabled(true);
    // Let the web view access local storage.
    webView.getSettings().setDomStorageEnabled(true);
    // Let HTML videos play automatically.
    webView.getSettings().setMediaPlaybackRequiresUserGesture(false);

    // Register the web view.
    MobileAds.registerWebView(webView);
  }
}

Cómo probar tu integración

Antes de usar tu propia URL, te recomendamos que cargues la siguiente URL para probar la integración:

https://google.github.io/webview-ads/test/#api-for-ads-tests

La URL de prueba muestra barras de estado verdes para indicar una integración correcta si se cumplen las siguientes condiciones:

• WebView conectado al SDK de anuncios de Google para dispositivos móviles (beta)

Próximos pasos

• Obtén el consentimiento en WebView. Las APIs de WebView para anuncios no propagan a las etiquetas de tus vistas web el consentimiento recopilado en el contexto de la app para dispositivos móviles en función de los marcos de trabajo de cumplimiento (TCF v2.0 de IAB o CCPA de IAB). Si te interesa implementar un flujo de consentimiento único como propietario de WebView y su correspondiente contenido web monetizado, trabaja con tu plataforma de administración de consentimiento para obtener el consentimiento en el contexto de WebView.