Integra l'API WebView per gli annunci

L'API WebView for Ads consente la monetizzazione degli annunci in-app utilizzando WebViewController Se visualizzi contenuti web che implementano annunci con Codice AdSense o Tag publisher di Google nella tua app fino al giorno WebViewController, devi utilizzare questa API per attivare gli annunci la monetizzazione. Per saperne di più, consulta AdSense e Ad Manager.

  1. Monetizzare effettuando richieste di annunci con l'SDK Google Mobile Ads.

    Puoi monetizzare la tua app inviando richieste di annunci a Ad Manager con SDK Google Mobile Ads implementando formati di annunci per dispositivi mobili app.

    Ulteriori informazioni.

  2. Monetizzare con l'API WebView for Ads

    Se la tua app utilizza WebViewController per visualizzare contenuti web che pubblicano annunci da Ad Manager o AdSense, utilizza l'API WebView per Google Ads per registrarti WebViewController di oggetti con l'SDK Google Mobile Ads. La JavaScript nel codice AdSense o Tag publisher di Google crea e invia richieste di annunci, così non devi effettuare richieste di annunci l'SDK. Ricorda che solo il web mobile e il web desktop formati dell'inventario disponibili utilizzando questa API.

    Se non possiedi i contenuti web di un WebViewController, sei comunque ti invitiamo a utilizzare questa API per proteggere gli inserzionisti dallo spam e migliorare la monetizzazione per i publisher web che hanno fornito i contenuti.

Tieni presente che puoi utilizzare una delle due opzioni (o entrambe le opzioni) nella stessa app.

Questa guida ha lo scopo di aiutarti a integrare l'API WebView for Ads nei tuoi app per iOS.

Prima di iniziare

Prima di iniziare a utilizzare l'API WebView for Ads, assicurati di svolgere le seguenti operazioni:

Bypassa il controllo dell'identificatore dell'applicazione

Android

Aggiungi il seguente tag <meta-data> nel file AndroidManifest.xml a ignora la verifica per APPLICATION_ID. Se salti questo passaggio, l'app Google L'SDK Mobile Ads potrebbe generare un IllegalStateException all'avvio dell'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

Aggiorna il file Runner/Info.plist con la chiave e il valore della stringa seguenti in ignora un controllo per GADApplicationIdentifier. Se salti questo passaggio, l'SDK Google Mobile Ads potrebbe generare un GADInvalidInitializationException all'avvio dell'app.

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

Registra WebViewController

Per migliorare la monetizzazione degli annunci in-app all'interno di un WebViewController che utilizza AdSense di Google Cloud o Google Publisher Tag: segui i passaggi elencate di seguito:

  1. Attiva JavaScript nel WebViewController. In caso contrario, potrebbero verificarsi gli annunci non si caricano.

  2. Per migliorare l'esperienza utente esperienza pubblicitaria e di essere coerente con norme sui cookie, attiva di terze parti nella tua istanza AndroidWebViewController.

  3. Registra l'istanza WebViewController chiamando il metodo registerWebView() fornito dall'SDK Google Mobile Ads.

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);
  }
}

Carica l'URL

Ora puoi caricare un URL e visualizzare i tuoi contenuti web tramite WebViewController. Ti consigliamo di caricare il seguente URL di test: https://webview-api-for-ads-test.glitch.me/ per testare l'integrazione prima del giorno utilizzando il tuo URL. La pagina web mostrerà un errore se JavaScript non è in un bucket con il controllo delle versioni attivo.

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://webview-api-for-ads-test.glitch.me/'));
  }

L'URL del test mostra le barre di stato verdi per l'integrazione riuscita se si applicano le seguenti condizioni:

  • WebView collegato all'SDK Google Mobile Ads
  • JavaScript attivato
  • I cookie di terze parti funzionano (non previsto sui dispositivi iOS)
  • I cookie proprietari funzionano

Visualizza il codice sorgente del nostro URL di test. Potrai quindi sostituire l'URL del test con il tuo URL. Puoi anche utilizza uno strumento proxy come Charles per acquisire i tuoi il traffico HTTPS dell'app e controlla le richieste di annunci per un parametro &scar=.