WebView API für Anzeigen integrieren

Mit den Web View APIs für Anzeigen werden App-Signale für die Tags in Ihrem WebView, wodurch die Monetarisierung für Publisher, die den Content bereitgestellt haben und Werbetreibende vor Spam schützen. Mit diesen App-Signalen wie App-ID und App-Version lassen sich Berichte aktivieren. und Targeting auf In-App-Browserinventar Anwendungsfälle, die ansonsten nur für App-Traffic verfügbar sind.

Funktionsweise

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

Das SDK fügt Nachrichten-Handler zu den registrierten WebView um auf diese Anzeigenereignisse zu warten. Für eine bessere wie das funktioniert, können Sie sich den Quellcode der Seite auf der Testseite.

Vorbereitung

  • Google Mobile Ads SDK Version 20.6.0 oder höher.
  • Android API-Level 21 oder höher

  • Fügen Sie das folgende <meta-data>-Tag in die Datei AndroidManifest.xml ein: die Prüfung auf APPLICATION_ID umgehen. Wenn Sie diesen Schritt verpassen und <meta-data>-Tag angeben, löst das Google Mobile Ads SDK eine IllegalStateException beim Start der App.

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

WebView registrieren

Anruf registerWebView() im Hauptthread, um eine Verbindung mit den JavaScript-Handlern im AdSense-Code oder Google Publisher-Tag in jeder WebView Instanz. Dieses sollte so früh wie möglich erfolgen, zum Beispiel in der Methode onCreate() von 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, empfehlen wir, die folgende URL zum Testen zu laden der Integration:

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 das gelten die folgenden Bedingungen:

  • WebView die mit dem Google Mobile Ads SDK verbunden sind

Nächste Schritte

  • Holen Sie die Einwilligung in WebViewein. Die Web View APIs für Die im Kontext mobiler Apps mithilfe von IAB TCF 2.0 oder IAB-CCPA Compliance-Frameworks zu den Tags in Ihren Webansichten hinzufügen. Wenn Sie sich für Implementierung eines einzigen Einwilligungsvorgangs als Inhaber der WebView und die zugehörigen Webinhalte holen Sie über Ihre Plattform zur Einwilligungsverwaltung die Einwilligungen den WebView Kontext.