Integra l'API WebView per gli annunci

Seleziona la piattaforma: Android (beta) Android iOS

Le API WebView per gli annunci rendono disponibili gli indicatori delle app ai tag in WebView, contribuendo a migliorare la monetizzazione per i publisher che hanno fornito i contenuti e a proteggere gli inserzionisti dallo spam. Questi indicatori delle app, come l'ID e la versione dell'app, aiutano ad attivare i casi d'uso di inventario del browser in-app di Reporting e Target , altrimenti disponibili solo sul traffico delle app.

Come funziona

La comunicazione con il Google Mobile Ads SDK avviene solo in risposta agli eventi pubblicitari attivati da uno dei seguenti:

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

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

• Google Mobile Ads SDK versione 20.6.0 o successive.

• Livello API Android 21 o versioni successive.

• Aggiungi il seguente <meta-data> tag nel file AndroidManifest.xml per ignorare il controllo di APPLICATION_ID. Se salti questo passaggio e non fornisci il tag <meta-data>, il Google Mobile Ads SDK 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 visualizzazione web

Chiama registerWebView() nel 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.

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)

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

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

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 sono soddisfatte le seguenti condizioni:

• WebView connesso a Google Mobile Ads SDK

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à 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.