Integra l'API WebView per gli annunci

Le API WebView per gli annunci rendono disponibili gli indicatori delle app per i tag nel tuo 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 l'SDK GMA Next Gen avviene solo in risposta a eventi pubblicitari attivati da uno dei seguenti elementi:

• Codice AdSense
• Tag publisher di Google
• IMA per HTML5

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

Prerequisiti

• SDK GMA di nuova generazione versione 0.6.0-alpha01 o successive.

Trasferire l'ID applicazione all'SDK

Se hai già un ID applicazione AdMob, inizializza l'SDK GMA di nuova generazione 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 l'SDK GMA di nuova generazione.

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() nel thread principale per stabilire una connessione con i gestori JavaScript nel codice AdSense o nel tag editore Google all'interno di ogni istanza WebView. Questa operazione deve essere eseguita il prima possibile, ad esempio nel metodo onCreate() del tuo 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);
  }
}

Testare l'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 all'SDK GMA Next Gen

Passaggi successivi

• Raccogli il consenso in WebView. Le API WebView per gli annunci non propagano il consenso raccolto nel contesto dell'app mobile utilizzando i framework di conformità TCF di IAB v2.0 o IAB CCPA ai tag nelle tue WebView. Se ti interessa implementare un flusso di consenso singolo in qualità di proprietario sia dell'WebView sia dei relativi contenuti web monetizzati, collabora con la tua piattaforma di gestione del consenso per raccogliere il consenso nel contesto dell'WebView.