WebView API for Ads 可讓應用程式信號提供給WebView
中的代碼,協助提供內容的發布商改善營利,並保護廣告客戶免受垃圾內容干擾。
運作方式
與 Google Mobile Ads SDK 的通訊僅會在下列任一事件觸發時發生:
SDK 會將訊息處理常式新增至已註冊的WebView
,以便監聽這些廣告事件。如要進一步瞭解這項功能的運作方式,請查看測試頁面的原始碼。
必要條件
- Google Mobile Ads SDK 7.67.0 以上版本 20.6.0 。
Android API 級別 21 以上版本。
請在
AndroidManifest.xml
檔案中新增下列<meta-data>
標記,以便略過APPLICATION_ID
的檢查。如果您略過這個步驟,且未提供<meta-data>
代碼,Google Mobile Ads SDK 就會在應用程式啟動時擲回IllegalStateException
。<!-- Bypass APPLICATION_ID check for web view APIs for ads --> <meta-data android:name="com.google.android.gms.ads.INTEGRATION_MANAGER" android:value="webview"/>
註冊網頁檢視畫面
在主執行緒上呼叫
registerWebView()
,以便與 AdSense 程式碼中的 JavaScript 處理常式或各個 WebView
例項中的 Google 發布者代碼建立連線。這項操作應盡早完成,例如在 View Controller 的
onCreate()
方法。
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)
// 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.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);
}
}
測試整合功能
在使用自訂網址之前,建議您先載入下列網址來測試整合:
https://webview-api-for-ads-test.glitch.me#api-for-ads-tests
如果符合下列條件,測試網址會顯示成功整合的綠色狀態列:
WebView
已連結至 Google Mobile Ads SDK
後續步驟
- 在
WebView
中收集同意聲明。廣告的網路檢視畫面 API 不會將使用 IAB 資訊公開和同意聲明架構第 2.0 版或 IAB 消費者隱私權和安全法案 法規遵循架構,在行動應用程式情境中收集到的同意聲明,傳播至網路檢視畫面中的代碼。如果您想在實施單一同意聲明流程時,同時擁有WebView
和對應的網站內容,並且要將這些內容營利,請與同意聲明管理平台合作,在WebView
情境中收集同意聲明。