Integrate the WebView API for Ads
Stay organized with collections
Save and categorize content based on your preferences.
The WebView API for Ads allows in-app ad monetization using WebViewController
.
If you display web content that implements ads with AdSense code
or Google Publisher Tag
in your app through WebViewController
, you should use this API to enable ads
monetization. To learn more, see the AdMob policies
.
-
- Monetize by making ad requests with Google Mobile Ads SDK
-
You can monetize your app by making ad requests to
AdMob with
Google Mobile Ads SDK by implementing ad formats for mobile
app
.
Learn more
.
-
- Monetize by using the WebView API for Ads
-
If your app uses WebViewController
to display web content that serves ads from Ad Manager
or AdSense
, use the WebView API for Ads to register WebViewController
objects with Google Mobile Ads SDK. The
JavaScript in the AdSense code
or Google Publisher Tag
builds and sends ad requests so you don't need to make any ad requests with
the SDK. Keep in mind that only the mobile web and desktop web inventory formats
are available using this API.
If you don't own the web content in a WebViewController
, you are still
encouraged to use this API to help protect advertisers from spam and
improve monetization for the web publishers that provided the content.
Note that you can do either option, or even both, in the same app.
This guide is intended to help you integrate the WebView API for Ads into your
iOS app.
Before you begin
Before you start using the WebView API for Ads, make sure you do the following:
Bypass the check for application identifier
Android
Add the following <meta-data>
tag in your AndroidManifest.xml
file to
bypass the check for the APPLICATION_ID
. If you miss this step,
Google Mobile Ads SDK might throw an IllegalStateException
on app start.
<!-- Bypass APPLICATION_ID check for WebView API for Ads -->
<meta-data
android:name="com.google.android.gms.ads.INTEGRATION_MANAGER"
android:value="webview"/>
iOS
Update the Runner/Info.plist
file with the key and string value below to
bypass a check for the GADApplicationIdentifier
. If you miss this step,
Google Mobile Ads SDK might throw a GADInvalidInitializationException
on app start.
<!-- Bypass GADApplicationIdentifier check for WebView API for Ads -->
<key>GADIntegrationManager</key>
<string>webview</string>
Register the WebViewController
To improve in-app ad monetization of ads within a WebViewController
that uses AdSense
code
or Google Publisher
Tags
, follow the steps
listed below:
-
Enable JavaScript in the WebViewController
. Failure to do so can cause
ads not to load.
-
To improve your users' ad experience and be consistent with Chrome's cookie policy
, enable
third-party cookies on your AndroidWebViewController
instance.
-
Register the WebViewController
instance by calling the registerWebView()
method provided by Google Mobile Ads SDK.
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
);
}
}
Load the URL
You can now load a URL and display your web content through WebViewController
.
We recommend that you load this test URL: https://google.github.io/webview-ads/test/
to test the integration prior to
using your own URL. The web page will show an error if JavaScript is not
enabled.
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://google.github.io/webview-ads/test/'
));
}
The test URL shows green status bars for a successful integration if the
following conditions apply:
-
WebView
connected to the Google Mobile Ads SDK
- JavaScript enabled
- Third-party cookies work (not expected on iOS devices)
- First-party cookies work
View the source code
of our test URL. You can then replace the test URL with your URL. You can also
use a proxy tool such as Charles
to capture your
app's HTTPS traffic and inspect the ad requests for a &scar=
parameter.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-04 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThe WebView API for Ads enables in-app ad monetization when displaying web content with AdSense or Google Publisher Tag ads through \u003ccode\u003eWebViewController\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTo use this API, register your \u003ccode\u003eWebViewController\u003c/code\u003e objects with the Google Mobile Ads SDK, ensuring JavaScript and third-party cookies (for Android) are enabled.\u003c/p\u003e\n"],["\u003cp\u003eThis API simplifies ad serving by handling ad requests within the web content's JavaScript, eliminating the need for manual ad requests from your app.\u003c/p\u003e\n"],["\u003cp\u003eIt is recommended to use this API even for third-party web content to enhance ad monetization and protect against spam.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, ensure you're using the Google Mobile Ads SDK for Flutter plugin (v3.0.0+), \u003ccode\u003ewebview_flutter\u003c/code\u003e, and \u003ccode\u003ewebview_flutter_android\u003c/code\u003e (v3.7.0+) in your app.\u003c/p\u003e\n"]]],["The WebView API for Ads facilitates in-app ad monetization through `WebViewController`. To use this, register `WebViewController` objects with the Google Mobile Ads SDK. Enable JavaScript and third-party cookies in the `WebViewController` and then call `registerWebView()`. For Android, add a specific `\u003cmeta-data\u003e` tag in `AndroidManifest.xml`, and for iOS, update `Info.plist` to bypass checks. You can load web content that implements ads from AdSense or Google Publisher Tag via this API and use a test URL to verify integration.\n"],null,["The WebView API for Ads allows in-app ad monetization using\n[`WebViewController`](//pub.dev/documentation/webview_flutter/latest/webview_flutter/WebViewController-class.html).\nIf you display web content that implements ads with\n[AdSense code](//support.google.com/adsense/answer/9274634) or\n[Google Publisher Tag](//support.google.com/admanager/answer/181073)\nin your app through `WebViewController`, you should use this API to enable ads\nmonetization. To learn more, see the\n\n[AdMob policies](//support.google.com/admob/answer/48182#trs).\n\n\n1.\n\n Monetize by making ad requests with Google Mobile Ads SDK\n\n : You can monetize your app by making ad requests to\n\n AdMob with\n Google Mobile Ads SDK by implementing [ad formats for mobile\n app](//support.google.com/admob/answer/6128738).\n\n\n [Learn more](/admob/flutter/quick-start).\n2.\n\n Monetize by using the WebView API for Ads\n\n : If your app uses `WebViewController` to display web content that serves ads from\n [Ad Manager](//support.google.com/admanager) or\n [AdSense](//support.google.com/adsense), use the WebView API for Ads to register\n `WebViewController` objects with Google Mobile Ads SDK. The\n JavaScript in the [AdSense code](//support.google.com/adsense/answer/9274634)\n or [Google Publisher Tag](//support.google.com/admanager/answer/181073)\n builds and sends ad requests so you don't need to make any ad requests with\n the SDK. Keep in mind that only the mobile web and desktop web\n [inventory formats](//support.google.com/admanager/answer/9796545)\n are available using this API.\n\n If you don't own the web content in a `WebViewController`, you are still\n encouraged to use this API to help protect advertisers from spam and\n improve monetization for the web publishers that provided the content.\n\nNote that you can do either option, or even both, in the same app.\n\nThis guide is intended to help you integrate the WebView API for Ads into your\niOS app.\n\nBefore you begin\n\nBefore you start using the WebView API for Ads, make sure you do the following:\n\n- Use [Google Mobile Ads SDK for Flutter plugin](/admob/flutter/quick-start#import_the_mobile_ads_sdk) with version 3.0.0 or higher in your app.\n- Add [`webview_flutter`](//pub.dev/packages/webview_flutter) as a dependency in your `pubspec.yaml` file.\n- Add [`webview_flutter_android`](//pub.dev/packages/webview_flutter_android) with version 3.7.0 or higher in your app.\n\nBypass the check for application identifier \n\nAndroid\n\nAdd the following `\u003cmeta-data\u003e` tag in your `AndroidManifest.xml` file to\nbypass the check for the `APPLICATION_ID`. If you miss this step,\nGoogle Mobile Ads SDK might throw an\n[`IllegalStateException`](//developer.android.com/reference/java/lang/IllegalStateException)\non app start. \n\n \u003c!-- Bypass APPLICATION_ID check for WebView API for Ads --\u003e\n \u003cmeta-data\n android:name=\"com.google.android.gms.ads.INTEGRATION_MANAGER\"\n android:value=\"webview\"/\u003e\n\niOS\n\nUpdate the `Runner/Info.plist` file with the key and string value below to\nbypass a check for the `GADApplicationIdentifier`. If you miss this step,\nGoogle Mobile Ads SDK might throw a `GADInvalidInitializationException`\non app start. \n\n \u003c!-- Bypass GADApplicationIdentifier check for WebView API for Ads --\u003e\n \u003ckey\u003eGADIntegrationManager\u003c/key\u003e\n \u003cstring\u003ewebview\u003c/string\u003e\n\nRegister the WebViewController\n\nTo improve in-app ad monetization of ads within a\n`WebViewController` that uses [AdSense\ncode](//support.google.com/adsense/answer/9274634) or [Google Publisher\nTags](//support.google.com/admanager/answer/181073), follow the steps\nlisted below:\n\n1. Enable JavaScript in the `WebViewController`. Failure to do so can cause\n ads not to load.\n\n2. To improve your users' ad experience and be consistent with Chrome's\n [cookie policy](//policies.google.com/technologies/cookies), enable\n third-party cookies on your `AndroidWebViewController` instance.\n\n3. Register the `WebViewController` instance by calling the\n [`registerWebView()`](//pub.dev/documentation/google_mobile_ads/latest/google_mobile_ads/MobileAds/registerWebView.html)\n method provided by Google Mobile Ads SDK.\n\n import 'package:google_mobile_ads/google_mobile_ads.dart';\n import 'package:webview_flutter/webview_flutter.dart';\n import 'package:webview_flutter_android/webview_flutter_android.dart';\n\n @override\n class WebViewExampleState extends State\u003cWebViewExample\u003e {\n late final WebViewController controller;\n\n @override\n void initState() {\n super.initState();\n\n createWebView();\n }\n\n void createWebView() async {\n controller = WebViewController();\n // 1. Enable JavaScript in the web view.\n await controller.setJavaScriptMode(JavaScriptMode.unrestricted);\n // 2. Enable third-party cookies for Android.\n if (controller.platform is AndroidWebViewController) {\n AndroidWebViewCookieManager cookieManager = AndroidWebViewCookieManager(\n const PlatformWebViewCookieManagerCreationParams());\n await cookieManager.setAcceptThirdPartyCookies(\n controller.platform as AndroidWebViewController, true);\n }\n // 3. Register the web view.\n await MobileAds.instance.registerWebView(controller);\n }\n }\n\nLoad the URL\n\nYou can now load a URL and display your web content through `WebViewController`.\nWe recommend that you load this test URL:\n`https://google.github.io/webview-ads/test/` to test the integration prior to\nusing your own URL. The web page will show an error if JavaScript is not\nenabled. \n\n import 'package:google_mobile_ads/google_mobile_ads.dart';\n import 'package:webview_flutter/webview_flutter.dart';\n import 'package:webview_flutter_android/webview_flutter_android.dart';\n\n @override\n class WebViewExampleState extends State\u003cWebViewExample\u003e {\n late final WebViewController controller;\n\n @override\n void initState() {\n super.initState();\n\n createWebView();\n }\n\n void createWebView() async {\n controller = WebViewController();\n // 1. Enable JavaScript in the web view.\n await controller.setJavaScriptMode(JavaScriptMode.unrestricted);\n\n // 2. Enable third-party cookies for Android.\n if (controller.platform is AndroidWebViewController) {\n AndroidWebViewCookieManager cookieManager = AndroidWebViewCookieManager(\n const PlatformWebViewCookieManagerCreationParams());\n await cookieManager.setAcceptThirdPartyCookies(\n controller.platform as AndroidWebViewController, true);\n }\n\n // 3. Register the web view.\n await MobileAds.instance.registerWebView(controller);\n\n // 4. Load the URL.\n await controller.loadRequest(Uri.parse('https://google.github.io/webview-ads/test/'));\n }\n\nThe test URL shows green status bars for a successful integration if the\nfollowing conditions apply:\n\n- `WebView` connected to the Google Mobile Ads SDK\n- JavaScript enabled\n- Third-party cookies work (not expected on iOS devices)\n- First-party cookies work\n\nView the [source code](//github.com/google/webview-ads/blob/main/test/index.html)\nof our test URL. You can then replace the test URL with your URL. You can also\nuse a proxy tool such as [Charles](//www.charlesproxy.com/) to capture your\napp's HTTPS traffic and inspect the ad requests for a `&scar=` parameter."]]
