廣告專用的 Web View API 會向WebView
中的代碼提供應用程式信號,協助提供內容的發布商提升營利成效,並防止廣告客戶收到垃圾內容。
這些應用程式信號 (例如應用程式 ID 和應用程式版本) 有助於啟用報表和指定應用程式內瀏覽器廣告空間用途,否則只能存取應用程式流量。
運作方式
只有在回應下列任一項目觸發的廣告事件時,系統才會與 Google Mobile Ads SDK 通訊:
SDK 會將訊息處理常式新增至已註冊的WebView
,以監聽這些廣告事件。如要進一步瞭解相關運作方式,請查看測試頁面的原始碼。
必要條件
- Google Mobile Ads SDK 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"/>
註冊 Web 檢視畫面
在主執行緒上呼叫
registerWebView()
,與每個 WebView
執行個體中的 JavaScript 處理常式或 Google 發布商廣告代碼建立連線。請盡早完成,例如在檢視控制器的
MainActivity
的 onCreate()
方法。
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)
}
}
測試整合功能
使用您自己的網址前,建議您先載入下列網址來測試整合作業:
https://webview-api-for-ads-test.glitch.me#api-for-ads-tests
在符合下列條件的情況下,測試網址會顯示成功整合的綠色狀態列:
WebView
已連結到 Google Mobile Ads SDK
後續步驟
- 請在「
WebView
」中收集同意聲明。廣告的 Web View API 不會將使用 IAB 資訊公開和同意聲明架構第 2.0 版或 IAB CCPA 規範架構在行動應用程式環境中收集到的同意聲明,套用到網頁瀏覽次數中的代碼。如果有意以「WebView
」擁有者身分和對應的網路內容營利,導入單一的同意聲明流程,請與您的同意聲明管理平台合作,在WebView
情境中收集同意聲明。