Cómo integrar la API de WebView para anuncios

Las APIs de vista web para anuncios permiten que los indicadores de la app estén disponibles para las etiquetas de tu WebView, esto ayuda a mejorar la monetización del publicadores que proporcionaron el contenido y protegen a los anunciantes contra el spam. Estos indicadores de la aplicación, como el ID y la versión de la aplicación, ayudan a activar los informes. y Cómo segmentar anuncios para el inventario de navegadores integrados en la aplicación para los casos de uso que, de otro modo, solo estarían disponibles en el tráfico de apps.

Cómo funciona

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

El SDK agrega controladores de mensajes al archivo WebView para escuchar estos eventos de anuncios. Para mejorar para comprender 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 versión 20.6.0 o una posterior.
  • Nivel de API 21 o superior de Android.

  • Agrega la siguiente etiqueta <meta-data> en el archivo AndroidManifest.xml al omitir la verificación de APPLICATION_ID. Si omites este paso y no proporciona la etiqueta <meta-data>, el SDK de anuncios de Google para dispositivos móviles arroja un IllegalStateException al iniciar la aplicación.

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

Registra la vista web

Llamada registerWebView() en el subproceso principal para establecer una conexión con los controladores JavaScript en la el código de AdSense o Google Publisher Tag dentro de cada WebView instancia. Esta debe hacerse lo antes posible, como en el onCreate() de tu MainActivity.

Java

import android.webkit.CookieManager;
import android.webkit.WebView;
import com.google.android.gms.ads.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);
  }
}

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView
import com.google.android.gms.ads.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)

    // Enable third-party cookies.
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)
    // Enable JavaScript in the WebView.
    webView.settings.javaScriptEnabled = true
    // Enable DOM storage in the WebView.
    webView.settings.domStorageEnabled = true
    // Enable videos to play automatically.
    webView.settings.mediaPlaybackRequiresUserGesture = 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 para probarla la integración:

https://webview-api-for-ads-test.glitch.me#api-for-ads-tests

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

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

Próximos pasos

  • Obtén el consentimiento en WebView. Las APIs de WebView para Los anuncios no propagan el consentimiento recopilado en el contexto de la aplicación para dispositivos móviles con MTC v2.0 de IAB o CCPA de IAB de cumplimiento a las etiquetas de tus vistas web. Si te interesa un único flujo de consentimiento como propietario del WebView y su contenido web correspondiente monetizado, trabaja con su plataforma de administración de consentimiento para obtener el consentimiento el WebView contexto.