L'API WebView per gli annunci consente la monetizzazione degli annunci in-app utilizzando
WebViewController
.
Se visualizzi contenuti web che implementano gli annunci con il codice AdSense o il tag publisher di Google nella tua app tramite WebViewController
, devi utilizzare questa API per abilitare la monetizzazione degli annunci. Per ulteriori informazioni, consulta le
Norme di AdSense
e Ad Manager.
- Monetizza effettuando richieste di annunci con l'SDK Google Mobile Ads
Puoi monetizzare la tua app inviando richieste di annunci ad Ad Manager con l'SDK Google Mobile Ads implementando formati degli annunci per app mobile.
- Monetizza utilizzando l'API WebView for Ads
Se la tua app utilizza
WebViewController
per visualizzare contenuti web che pubblicano annunci da Ad Manager o AdSense, utilizza l'API WebView for Ads per registrare oggettiWebViewController
con l'SDK Google Mobile Ads. Il codice JavaScript nel codice AdSense o nel tag publisher di Google crea e invia richieste di annunci in modo da non dover effettuare richieste di annunci con l'SDK. Tieni presente che con questa API sono disponibili solo i formati di inventario per Web mobile e Web desktop.Se non possiedi i contenuti web in
WebViewController
, ti invitiamo comunque a utilizzare questa API per proteggere gli inserzionisti dallo spam e migliorare la monetizzazione per i publisher web che hanno fornito i contenuti.
Tieni presente che nella stessa app puoi scegliere una delle due opzioni o anche entrambe.
Questa guida ha lo scopo di aiutarti a integrare l'API WebView per gli annunci nella tua app per iOS.
Prima di iniziare
Prima di iniziare a utilizzare l'API WebView per gli annunci, assicurati di svolgere le seguenti operazioni:
- Utilizza l'SDK Google Mobile Ads per il plug-in Flutter con versione 3.0.0 o successive nella tua app.
- Aggiungi
webview_flutter
come dipendenza nel filepubspec.yaml
. - Aggiungi
webview_flutter_android
con la versione 3.7.0 o successive nella tua app.
Ignora il controllo dell'identificatore dell'applicazione
Android
Aggiungi il seguente tag <meta-data>
nel file AndroidManifest.xml
per aggirare il controllo di APPLICATION_ID
. Se salti questo passaggio, l'SDK Google Mobile Ads potrebbe generare un
IllegalStateException
all'avvio dell'app.
<!-- Bypass APPLICATION_ID check for WebView API for Ads -->
<meta-data
android:name="com.google.android.gms.ads.INTEGRATION_MANAGER"
android:value="webview"/>
iOS
Aggiorna il file Runner/Info.plist
con la chiave e il valore della stringa riportati di seguito per ignorare un controllo per GADApplicationIdentifier
. Se salti questo passaggio,
l'SDK Google Mobile Ads potrebbe generare un GADInvalidInitializationException
all'avvio dell'app.
<!-- Bypass GADApplicationIdentifier check for WebView API for Ads -->
<key>GADIntegrationManager</key>
<string>webview</string>
Registra WebViewController
Per migliorare la monetizzazione degli annunci in-app all'interno di un elemento WebViewController
che utilizza il codice AdSense o i Tag publisher di Google, procedi nel seguente modo:
Attiva JavaScript in
WebViewController
. In caso contrario, gli annunci non vengono caricati.Per migliorare l'esperienza pubblicitaria dei tuoi utenti e rispettare le norme relative ai cookie di Chrome, abilita i cookie di terze parti nell'istanza
AndroidWebViewController
.Registra l'istanza
WebViewController
chiamando il metodoregisterWebView()
fornito dall'SDK Google Mobile Ads.
import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:webview_flutter/webview_flutter.dart';
import 'package:webview_flutter_android/webview_flutter_android.dart';
@override
class WebViewExampleState extends State<WebViewExample> {
late final WebViewController controller;
@override
void initState() {
super.initState();
createWebView();
}
void createWebView() async {
controller = WebViewController();
// 1. Enable JavaScript in the web view.
await controller.setJavaScriptMode(JavaScriptMode.unrestricted);
// 2. Enable third-party cookies for Android.
if (controller.platform is AndroidWebViewController) {
AndroidWebViewCookieManager cookieManager = AndroidWebViewCookieManager(
const PlatformWebViewCookieManagerCreationParams());
await cookieManager.setAcceptThirdPartyCookies(
controller.platform as AndroidWebViewController, true);
}
// 3. Register the web view.
await MobileAds.instance.registerWebView(controller);
}
}
Carica l'URL
Ora puoi caricare un URL e visualizzare i tuoi contenuti web tramite WebViewController
.
Ti consigliamo di caricare questo URL di test:
https://webview-api-for-ads-test.glitch.me/
per testare l'integrazione prima di
utilizzare il tuo URL. Se JavaScript non è attivato, la pagina web mostrerà un errore.
import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:webview_flutter/webview_flutter.dart';
import 'package:webview_flutter_android/webview_flutter_android.dart';
@override
class WebViewExampleState extends State<WebViewExample> {
late final WebViewController controller;
@override
void initState() {
super.initState();
createWebView();
}
void createWebView() async {
controller = WebViewController();
// 1. Enable JavaScript in the web view.
await controller.setJavaScriptMode(JavaScriptMode.unrestricted);
// 2. Enable third-party cookies for Android.
if (controller.platform is AndroidWebViewController) {
AndroidWebViewCookieManager cookieManager = AndroidWebViewCookieManager(
const PlatformWebViewCookieManagerCreationParams());
await cookieManager.setAcceptThirdPartyCookies(
controller.platform as AndroidWebViewController, true);
}
// 3. Register the web view.
await MobileAds.instance.registerWebView(controller);
// 4. Load the URL.
await controller.loadRequest(Uri.parse('https://webview-api-for-ads-test.glitch.me/'));
}
L'URL del test mostra barre di stato verdi per un'integrazione riuscita se si applicano le seguenti condizioni:
WebView
collegato all'SDK Google Mobile Ads- JavaScript attivato
- I cookie di terze parti funzionano (non previsti sui dispositivi iOS)
- I cookie proprietari funzionano
Visualizza il codice sorgente
del nostro URL di test. Puoi quindi sostituire l'URL del test con il tuo URL. Puoi anche utilizzare uno strumento proxy come Charles per acquisire il traffico HTTPS della tua app e controllare le richieste di annunci per un parametro &scar=
.