WebView API for Ads を統合する

広告用のウェブビュー API を使用すると、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 をスローします。

    <!-- 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 コードまたは Google パブリッシャー タグ内の JavaScript ハンドラとの接続を確立します。 WebView これは、ビュー コントローラの 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)
  }
}

インテグレーションをテストする

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

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

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

  • WebView を Google Mobile Ads SDK に接続しました

次のステップ

  • WebViewで同意を取得します。広告用のウェブビュー API は、IAB TCF v2.0 または IAB CCPA のコンプライアンス フレームワークを使用して、モバイルアプリのコンテキストで収集された同意をウェブビューのタグに反映しません。収益化対象のWebView とそれに対応するウェブ コンテンツの両方の所有者として 1 つの同意フローを実装する場合は、同意管理プラットフォームと連携して、 WebView のコンテキストで同意を取得してください。
前へ
WebView を設定する
次へ
クリック動作を最適化する