WebView API für Anzeigen integrieren

Mit den Web View APIs für Anzeigen werden App-Signale für die Tags inWebViewverfügbar gemacht. So können wir die Monetarisierung für Publisher, die die Inhalte bereitgestellt haben, verbessern und Werbetreibende vor Spam schützen.

Funktionsweise

Die Kommunikation mit dem Google Mobile Ads SDK erfolgt nur als Reaktion auf Anzeigenereignisse, die durch eines der folgenden Ereignisse ausgelöst werden:

• AdSense-Code
• Google Publisher-Tag
• IMA für HTML5

Das SDK fügt dem registriertenWebView Nachrichten-Handler hinzu, um auf diese Anzeigenereignisse zu warten. Um einen besseren Einblick in die Funktionsweise zu erhalten, sehen Sie sich den Quellcode der Testseite an.

Voraussetzungen

• Google Mobile Ads SDK Version 20.6.0 oder höher.

• Android API-Level 21 oder höher.

• Fügen Sie der Datei AndroidManifest.xml das folgende <meta-data>-Tag hinzu, um die Prüfung auf APPLICATION_ID zu umgehen. Wenn Sie diesen Schritt verpassen und das Tag <meta-data> nicht angeben, gibt das Google Mobile Ads SDK beim Start der App ein IllegalStateException aus.

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

Webansicht registrieren

Rufen Sie registerWebView() im Hauptthread auf, um eine Verbindung mit den JavaScript-Handlern im AdSense-Code oder im Google Publisher-Tag in jeder WebView Instanz herzustellen. Dies sollte so früh wie möglich erfolgen, z. B. in der onCreate() Ihrer 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)
  }
}

Integration testen

Bevor Sie Ihre eigene URL verwenden, sollten Sie die folgende URL laden, um die Integration zu testen:

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

Die Test-URL zeigt grüne Statusleisten für eine erfolgreiche Integration an, wenn die folgenden Bedingungen erfüllt sind:

• WebView die mit dem Google Mobile Ads SDK verbunden sind

Nächste Schritte

• Holen Sie die Einwilligung in WebViewein. Über die Web View APIs für Anzeigen wird keine Einwilligung, die im Kontext von mobilen Apps mit dem IAB TCF 2.0 oder dem IAB CCPA-Framework erfasst wurde, an die Tags in Ihren Webansichten weitergegeben. Wenn Sie als Inhaber derWebView und der zugehörigen Webinhalte, die monetarisiert werden sollen, einen einzigen Einwilligungsvorgang implementieren möchten, sollten Sie mit Ihrer Plattform zur Einwilligungsverwaltung die Einwilligung im entsprechenden Kontext einholen. WebView