Usa la API de WebView para anuncios

La API de WebView para anuncios permite la monetización de anuncios en la app con WebViewController. Si muestras contenido web que implementa anuncios con el código de AdSense o la etiqueta Google Publisher Tag en tu app a través de WebViewController, debes usar esta API para habilitar la monetización de anuncios. Para obtener más información, consulta las políticas de AdSense y Ad Manager.

  1. Monetiza tu app realizando solicitudes de anuncios con Google Mobile Ads Flutter Plugin

    Puedes monetizar tu app realizando solicitudes de anuncios a Ad Manager con Google Mobile Ads Flutter Plugin a través de la implementación de formatos de anuncios para apps para dispositivos móviles.

    Obtén más información.

  2. Monetiza con la API de WebView para anuncios

    Si tu app usa WebViewController para mostrar contenido web que publica anuncios de Ad Manager o AdSense, usa la API de WebView para anuncios para registrar objetos WebViewController con Google Mobile Ads Flutter Plugin. El código de JavaScript en el código de AdSense o la etiqueta de Google Publisher Tag compila y envía solicitudes de anuncios, por lo que no necesitas realizar ninguna solicitud de anuncio con el SDK. Ten en cuenta que solo los formatos de inventario de la Web móvil y la Web para computadoras están disponibles con esta API.

    Si no eres el propietario del contenido web en un WebViewController, te recomendamos que uses esta API para proteger a los anunciantes del spam y mejorar la monetización de los publicadores web que proporcionaron el contenido.

Ten en cuenta que puedes elegir cualquiera de las dos opciones, o incluso ambas, en la misma app.

Esta guía tiene como objetivo ayudarte a integrar la API de WebView para anuncios en tu app para iOS.

Antes de comenzar

Antes de comenzar a usar la API de WebView para anuncios, asegúrate de hacer lo siguiente:

Omitir la verificación del identificador de la aplicación

Android

Agregar la siguiente etiqueta <meta-data> en tu archivo AndroidManifest.xml para omitir la verificación del APPLICATION_ID. Si ignoras este paso, es posible que Google Mobile Ads Flutter Plugin arroje una excepción IllegalStateException durante el inicio de la app.

<!-- Bypass APPLICATION_ID check for WebView API for Ads -->
<meta-data
    android:name="com.google.android.gms.ads.INTEGRATION_MANAGER"
    android:value="webview"/>

iOS

Actualiza el archivo Runner/Info.plist con la clave y el valor de cadena que se indican a continuación para omitir la verificación del GADApplicationIdentifier. Si omites este paso, es posible que Google Mobile Ads Flutter Plugin arroje una excepción GADInvalidInitializationException cuando se inicie la app.

<!-- Bypass GADApplicationIdentifier check for WebView API for Ads -->
<key>GADIntegrationManager</key>
<string>webview</string>

Registra el WebViewController

Para mejorar la monetización de los anuncios en la app dentro de un WebViewController que usa el código de AdSense o las etiquetas de Google Publisher Tag, sigue los pasos que se indican a continuación:

  1. Habilita JavaScript en WebViewController. De lo contrario, es posible que no se carguen los anuncios.

  2. Para mejorar la experiencia de anuncios de tus usuarios y mantener la coherencia con la política de cookies de Chrome, habilita las cookies de terceros en tu instancia de AndroidWebViewController.

  3. Registra la instancia de WebViewController llamando al método registerWebView() que proporciona Google Mobile Ads Flutter Plugin.

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:webview_flutter/webview_flutter.dart';
import 'package:webview_flutter_android/webview_flutter_android.dart';

@override
class WebViewExampleState extends State<WebViewExample> {
  late final WebViewController controller;

  @override
  void initState() {
    super.initState();

    createWebView();
  }

  void createWebView() async {
    controller = WebViewController();
    // 1. Enable JavaScript in the web view.
    await controller.setJavaScriptMode(JavaScriptMode.unrestricted);

    // 2. Enable third-party cookies for Android.
    if (controller.platform is AndroidWebViewController) {
      AndroidWebViewCookieManager cookieManager = AndroidWebViewCookieManager(
        const PlatformWebViewCookieManagerCreationParams());
      await cookieManager.setAcceptThirdPartyCookies(
        controller.platform as AndroidWebViewController, true);
    }

    // 3. Register the web view.
    await MobileAds.instance.registerWebView(controller);
  }
}

Carga la URL

Ahora puedes cargar una URL y mostrar tu contenido web a través de WebViewController. Te recomendamos que cargues esta URL de prueba: https://google.github.io/webview-ads/test/ para probar la integración antes de usar tu propia URL. La página web mostrará un error si JavaScript no está habilitado.

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:webview_flutter/webview_flutter.dart';
import 'package:webview_flutter_android/webview_flutter_android.dart';

@override
class WebViewExampleState extends State<WebViewExample> {
  late final WebViewController controller;

  @override
  void initState() {
    super.initState();

    createWebView();
  }

  void createWebView() async {
    controller = WebViewController();
    // 1. Enable JavaScript in the web view.
    await controller.setJavaScriptMode(JavaScriptMode.unrestricted);

    // 2. Enable third-party cookies for Android.
    if (controller.platform is AndroidWebViewController) {
      AndroidWebViewCookieManager cookieManager = AndroidWebViewCookieManager(
        const PlatformWebViewCookieManagerCreationParams());
      await cookieManager.setAcceptThirdPartyCookies(
        controller.platform as AndroidWebViewController, true);
    }

    // 3. Register the web view.
    await MobileAds.instance.registerWebView(controller);

    // 4. Load the URL.
    await controller.loadRequest(Uri.parse('https://google.github.io/webview-ads/test/'));
  }

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

  • WebView se conectó a Google Mobile Ads Flutter Plugin
  • JavaScript habilitado
  • Las cookies de terceros funcionan (no se espera que lo hagan en dispositivos iOS).
  • Funcionamiento de las cookies propias

Consulta el código fuente de nuestra URL de prueba. Luego, puedes reemplazar la URL de prueba por tu URL. También puedes usar una herramienta de proxy, como Charles, para capturar el tráfico HTTPS de tu app y, luego, inspeccionar las solicitudes de anuncios en busca de un parámetro &scar=.