WebView einrichten

Wenn in deiner Android AppWebView Webinhalte präsentiert werden, solltest du sie so konfigurieren, dass Inhalte optimal mit Anzeigen monetarisiert werden können.

In diesem Leitfaden erfahren Sie, wie Sie Informationen zum Konfigurieren einesWebView -Objekts bereitstellen.

Wichtig :Wenden Sie für eine ordnungsgemäße Einrichtung und Optimierung WebViewalle folgenden Empfehlungen auf jede WebView Instanz Ihrer App an. Um die einzelnen Webansichten leichter identifizieren zu können, aktivieren Sie in den WebView-Entwicklertools das Flag „highlight-all-webviews“, um die Webansichten in Ihrer App mit einer gelben Färbung hervorzuheben.

Drittanbieter-Cookies aktivieren

Aktivieren Sie Drittanbieter-Cookies auf Ihrer WebView-Instanz, um die Nutzerfreundlichkeit von Werbeanzeigen zu verbessern und die Cookie-Richtlinie von Chrome einzuhalten.

Java

CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true);

Kotlin

CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)

Webeinstellungen

Default WebView settings are not optimized for ads. Use the WebSettings APIs to configure your WebView for:

• JavaScript
• Access to local storage

• Automatic video play

Java

import android.webkit.CookieManager;
import android.webkit.WebView;

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

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView

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)

    // Let the web view accept third-party cookies.
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)
    // Let the web view use JavaScript.
    webView.settings.javaScriptEnabled = true
    // Let the web view access local storage.
    webView.settings.domStorageEnabled = true
    // Let HTML videos play automatically.
    webView.settings.mediaPlaybackRequiresUserGesture = false
  }
}

Inhalte aus der Webansicht laden

Cookies und Seiten-URLs sind wichtig für die Leistung von Webaufrufen und funktionieren nur wie erwartet, wenn loadUrl() mit einer netzwerkbasierten URL verwendet wird. Für eine optimale WebView Leistungsollten Sie Webinhalte direkt über netzwerkbasierte URLs laden. Vermeiden Sie die Verwendung von WebViewAssetLoader, das Laden von Assets vom Gerät und das dynamische Generieren von Webinhalten.

Java

import android.webkit.CookieManager;
import android.webkit.WebView;

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

    // Load the URL for optimized web view performance.
    webView.loadUrl("https://webview-api-for-ads-test.glitch.me");
  }
}

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView

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)

    // Let the web view accept third-party cookies.
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)
    // Let the web view use JavaScript.
    webView.settings.javaScriptEnabled = true
    // Let the web view access local storage.
    webView.settings.domStorageEnabled = true
    // Let HTML videos play automatically.
    webView.settings.mediaPlaybackRequiresUserGesture = false

    // Load the URL for optimized web view performance.
    webView.loadUrl("https://webview-api-for-ads-test.glitch.me")
  }
}

Webansicht testen

Wir empfehlen, während der App-Entwicklung diese Test-URL zu laden:

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

überprüfen, ob diese Einstellungen die gewünschte Wirkung auf Anzeigen haben. Die Test-URL hat Erfolgskriterien für eine vollständige Integration, wenn Folgendes beobachtet wird:

Einstellungen für die Webansicht

• Drittanbieter-Cookies funktionieren

• Eigene Cookies funktionieren
• JavaScript aktiviert

• DOM-Speicher aktiviert

Videoanzeige

• Die Videoanzeige wird inline abgespielt und nicht im integrierten Vollbildplayer geöffnet.
• Die Videoanzeige wird automatisch ohne Klicken auf die Wiedergabeschaltfläche wiedergegeben.
• Die Videoanzeige kann wiederholt werden.

Ersetzen Sie nach Abschluss des Tests die Test-URL durch die URL, die die Webansicht laden soll.