このページは Cloud Translation API によって翻訳されました。

WebView API for Ads を統合する

WebView API for Ads を使用すると、WebViewのタグでアプリシグナルを利用できるため、コンテンツを提供したパブリッシャーの収益化を改善し、スパムから広告主を保護できます。

仕組み

Google Mobile Ads SDK との通信は、次のいずれかによってトリガーされた広告イベントにのみ応答して行われます。

SDK は、これらの広告イベントをリッスンするために、登録されたWebView にメッセージハンドラを追加します。この仕組みについて詳しくは、テストページのソースコードをご覧ください。

前提条件

Google Mobile Ads SDK バージョン 20.6.0 以降。
Android API レベル 21 以降。
APPLICATION_ID のチェックをバイパスするために、AndroidManifest.xml ファイルに次の <meta-data> タグを追加します。この手順を行わずに <meta-data> タグを指定しなかった場合、アプリの起動時に Google Mobile Ads SDK により IllegalStateException がスローされます。
```

 <meta-data
     android:name="com.google.android.gms.ads.INTEGRATION_MANAGER"
     android:value="webview"/>
```

ウェブビューを登録する

メインスレッドで registerWebView() を呼び出して、各 WebView インスタンス内の AdSense コードまたは Google パブリッシャータグの JavaScript ハンドラに接続を確立します。これは、ビューコントローラの MainActivity の 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);
  }
}

統合をテストする

独自の URL を使用する前に、次の URL を読み込んで統合をテストすることをおすすめします。

https://webview-api-for-ads-test.glitch.me#api-for-ads-tests

次の条件が適用されると、テスト URL に緑色のステータスバーが表示され、統合が成功したことを示します。

WebView Google Mobile Ads SDK に接続されている

次のステップ

WebViewで同意を取得します。Google 広告の WebView API は、IAB TCF v2.0 または IAB CCPA コンプライアンスフレームワークを使用してモバイルアプリのコンテキストで収集された同意を、ウェブビューのタグに伝播しません。収益化対象のWebView とそれに関連するウェブコンテンツの両方の所有者として、単一の同意フローを導入する場合は、同意管理プラットフォームを使用して WebView コンテキストで同意を取得します。

WebView を設定する

クリック操作を最適化する