Integra l'API WebView per gli annunci

Le API WebView per gli annunci rendono disponibili gli indicatori di app per i tag nel tuo WebView, contribuendo a migliorare la monetizzazione per il publisher che hanno fornito i contenuti e proteggono gli inserzionisti dallo spam. Questi indicatori dell'app, come l'ID e la versione dell'app, consentono di attivare i report e Targeting dell'inventario del browser in-app per i casi d'uso altrimenti disponibili solo per il traffico delle app.

Come funziona

La comunicazione con l'SDK Google Mobile Ads avviene solo in risposta a un annuncio attivati da uno dei seguenti eventi:

L'SDK aggiunge i gestori di messaggi agli WebView per ascoltare questi eventi annuncio. Per una migliore di come funziona, visualizza il codice sorgente del pagina di test.

Prerequisiti

  • SDK Google Mobile Ads alla versione 20.6.0 o successiva.
  • Livello API Android 21 o superiore.

  • Aggiungi il seguente tag <meta-data> nel file AndroidManifest.xml a ignora la verifica per APPLICATION_ID. Se salti questo passaggio e non fornire il tag <meta-data>, l'SDK Google Mobile Ads genera un IllegalStateException all'avvio dell'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"/>
    

Registra la vista web

Chiama registerWebView() sul thread principale per stabilire una connessione con i gestori JavaScript nel il codice AdSense o il Tag publisher di Google in ogni WebView istanza. Questo devono essere eseguiti il prima possibile, come Metodo onCreate() di 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)
  }
}

Testare l'integrazione

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

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

L'URL del test mostra le barre di stato verdi per l'integrazione riuscita se si applicano le seguenti condizioni:

  • WebView connesso all'SDK Google Mobile Ads

Passaggi successivi

  • Raccogli il consenso in WebView. Le API Web View per Gli annunci non propagano il consenso raccolto nel contesto dell'app mobile utilizzando Versione 2.0 del TCF di IAB oppure CCPA di IAB di conformità ai tag nelle viste web. Se ti interessa implementare un unico flusso di consenso in qualità di proprietario sia WebView e i relativi contenuti web che devono essere monetizzati, utilizza la piattaforma di gestione del consenso per raccogliere il consenso il WebView contesto.