Integra l'API WebView per gli annunci

Seleziona la piattaforma: Android New-selected Android iOS

L'API WebView per gli annunci rende disponibili gli indicatori delle app per i tag nella tua WebView, contribuendo a migliorare la monetizzazione per i publisher che hanno fornito i contenuti e a proteggere gli inserzionisti dallo spam.

Come funziona

La comunicazione con GMA Next-Gen SDK avviene solo in risposta agli eventi pubblicitari attivati da uno dei seguenti elementi:

L'SDK aggiunge gestori di messaggi alla WebView registrata per ascoltare questi eventi pubblicitari. Per capire meglio come funziona, visualizza il codice sorgente della pagina di test.

Prerequisiti

Trasmetti l'ID applicazione all'SDK

Se hai già un ID applicazione AdMob, inizializza GMA Next-Gen SDK con l'ID applicazione esistente.

Se non hai un ID applicazione AdMob, trasmetti InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID come ID applicazione quando inizializzi GMA Next-Gen SDK.

Kotlin

MobileAds.initialize(
    this@MainActivity,
    // Use this application ID to initialize the GMA Next-Gen SDK if
    // you don't have an AdMob application ID.
    InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
        .build(),
  ) {
    // Adapter initialization complete.
  }

Java

MobileAds.initialize(
    this,
    // Use this application ID to initialize the GMA Next-Gen SDK if
    // you don't have an AdMob application ID.
    new InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
        .build(),
        initializationStatus -> {
          // Adapter initialization is complete.
          });

Registra la visualizzazione web

Chiama registerWebView() sul thread principale per stabilire una connessione con i gestori JavaScript nel codice AdSense o nel tag publisher di Google all'interno di ogni WebView istanza. Questa operazione deve essere eseguita il prima possibile, ad esempio nel onCreate() metodo di MainActivity.

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView
import com.google.android.libraries.ads.mobile.sdk.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)

    // 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

    // Register the web view.
    MobileAds.registerWebView(webView)
  }
}

Java

import android.webkit.CookieManager;
import android.webkit.WebView;
import com.google.android.libraries.ads.mobile.sdk.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);
  }
}

Verifica la tua integrazione

Prima di utilizzare il tuo URL, ti consigliamo di caricare il seguente URL per testare l'integrazione:

https://google.github.io/webview-ads/test/#api-for-ads-tests

L'URL di test mostra barre di stato verdi per un'integrazione riuscita se si verificano le seguenti condizioni:

  • WebView connesso a GMA Next-Gen SDK

Passaggi successivi

  • Raccogli il consenso in WebView. L'API WebView per gli annunci non propaga i consensi raccolti nel contesto dell'app mobile utilizzando i framework di conformità IAB TCF v2.0 o IAB CCPA ai tag nelle visualizzazioni web. Se ti interessa implementare un singolo flusso di consenso come proprietario sia di WebView sia dei contenuti web corrispondenti monetizzati, collabora con la tua piattaforma di gestione del consenso per raccogliere il consenso nel contesto WebView.
Indietro
Configura WebView
Avanti
Ottimizza il comportamento dei clic