WebView API für Anzeigen verwenden

Die WebView API für Anzeigen ermöglicht die Monetarisierung von In-App-Anzeigen mit WebViewController. Wenn Sie Webinhalte mit Anzeigen, die mit AdSense-Code oder Google Publisher-Tags implementiert wurden, in Ihrer App über WebViewController anzeigen, sollten Sie diese API verwenden, um die Monetarisierung von Anzeigen zu ermöglichen. Weitere Informationen finden Sie in den Richtlinien für AdSense und Ad Manager.

  1. Monetarisierung durch Anzeigenanfragen mit Google Mobile Ads Flutter Plugin

    Sie können Ihre App monetarisieren, indem Sie Anzeigenanfragen mit Google Mobile Ads Flutter Plugin an Ad Manager senden und Anzeigenformate für mobile Apps implementieren.

    Weitere Informationen

  2. Monetarisierung mit der WebView API für Anzeigen

    Wenn in Ihrer App WebViewController verwendet wird, um Webinhalte mit Anzeigen aus Ad Manager oder AdSense zu präsentieren, verwenden Sie die WebView API für Anzeigen, um WebViewController-Objekte bei Google Mobile Ads Flutter Plugin zu registrieren. Das JavaScript im AdSense-Code oder Google Publisher-Tag erstellt und sendet Anzeigenanfragen, sodass Sie keine Anzeigenanfragen mit dem SDK stellen müssen. Beachten Sie, dass über diese API nur die Inventarformate für das mobile Web und die Website für Computer verfügbar sind.

    Wenn Sie nicht der Inhaber des Webinhalts in einem WebViewController sind, sollten Sie diese API trotzdem verwenden, um Werbetreibende vor Spam zu schützen und die Monetarisierung für die Web-Publisher zu verbessern, die den Inhalt bereitgestellt haben.

Sie können beide Optionen in derselben App verwenden.

In diesem Leitfaden wird beschrieben, wie Sie die WebView API für Anzeigen in Ihre iOS-App einbinden.

Hinweis

Bevor Sie die WebView API für Anzeigen verwenden, müssen Sie Folgendes tun:

Prüfung der Anwendungskennung umgehen

Android

Fügen Sie in der Datei AndroidManifest.xml das folgende <meta-data>-Tag hinzu, um die Prüfung für APPLICATION_ID zu umgehen. Wenn Sie diesen Schritt überspringen, gibt Google Mobile Ads Flutter Plugin beim Start der App möglicherweise einen IllegalStateException aus.

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

iOS

Aktualisieren Sie die Datei Runner/Info.plist mit dem Schlüssel und dem Stringwert unten, um eine Prüfung auf GADApplicationIdentifier zu umgehen. Wenn Sie diesen Schritt überspringen, wird von Google Mobile Ads Flutter Plugin möglicherweise beim App-Start ein GADInvalidInitializationException ausgegeben.

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

WebViewController registrieren

Wenn Sie die Monetarisierung von In-App-Anzeigen in einer WebViewController verbessern möchten, die AdSense-Code oder Google Publisher-Tags verwendet, gehen Sie so vor:

  1. Aktivieren Sie JavaScript in der WebViewController. Andernfalls werden Anzeigen möglicherweise nicht geladen.

  2. Wenn Sie die Nutzerfreundlichkeit von Werbeanzeigen verbessern und die Cookie-Richtlinie von Chrome einhalten möchten, aktivieren Sie Drittanbieter-Cookies in Ihrer AndroidWebViewController-Instanz.

  3. Registrieren Sie die WebViewController-Instanz, indem Sie die von Google Mobile Ads Flutter Plugin bereitgestellte Methode registerWebView() aufrufen.

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

URL laden

Sie können jetzt eine URL laden und Ihre Webinhalte über WebViewController anzeigen lassen. Wir empfehlen, diese Test-URL zu laden: https://google.github.io/webview-ads/test/, um die Integration zu testen, bevor Sie Ihre eigene URL verwenden. Wenn JavaScript nicht aktiviert ist, wird auf der Webseite ein Fehler angezeigt.

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

In der Test-URL werden grüne Statusleisten für eine erfolgreiche Integration angezeigt, wenn die folgenden Bedingungen erfüllt sind:

  • WebView mit Google Mobile Ads Flutter Plugin verbunden
  • JavaScript aktiviert
  • Drittanbieter-Cookies funktionieren (nicht auf iOS-Geräten)
  • Eigene Cookies funktionieren

Sehen Sie sich den Quellcode unserer Test-URL an. Anschließend können Sie die Test-URL durch Ihre URL ersetzen. Sie können auch ein Proxytool wie Charles verwenden, um den HTTPS-Traffic Ihrer App zu erfassen und die Anzeigenanfragen auf einen &scar=-Parameter zu prüfen.