Интегрируйте API WebView для рекламы

Выберите платформу: Android (бета-версия) Android iOS

The web view APIs for ads makes app signals available to the tags in your WebView , helping to improve monetization for the publishers that provided the content and protect advertisers from spam. These app signals, such as app ID and app version, help activate Reporting and Target in-app browser inventory use cases that are otherwise only available on app traffic.

Как это работает

Взаимодействие с Google Mobile Ads SDK происходит только в ответ на рекламные события, инициированные любым из следующих факторов:

• Код AdSense
• Тег издателя Google
• IMA для HTML5

SDK добавляет обработчики сообщений к зарегистрированному WebView для отслеживания этих рекламных событий. Для лучшего понимания принципа работы ознакомьтесь с исходным кодом тестовой страницы.

Предварительные требования

• Версия Google Mobile Ads SDK 20.6.0 или выше.

• Android API уровня 21 или выше.

• Add the following <meta-data> tag in your AndroidManifest.xml file to bypass the check for the APPLICATION_ID . If you miss this step and don't provide the <meta-data> tag, the Google Mobile Ads SDK throws an IllegalStateException on app start.

  <!-- Bypass APPLICATION_ID check for web view APIs for ads -->
   <meta-data
       android:name="com.google.android.gms.ads.INTEGRATION_MANAGER"
       android:value="webview"/>
  

Зарегистрируйте веб-представление

Call registerWebView() on the main thread to establish a connection with the JavaScript handlers in the AdSense code or Google Publisher Tag within each WebView instance. This should be done as early as possible, such as in the onCreate() method of your MainActivity .

Котлин

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://google.github.io/webview-ads/test/#api-for-ads-tests

При соблюдении следующих условий тестовая ссылка отображает зеленые индикаторы состояния, что означает успешную интеграцию:

• WebView подключенный к Google Mobile Ads SDK

Следующие шаги

• Сбор согласия в WebView . API веб-просмотров для рекламы не передает согласие, собранное в контексте мобильного приложения с использованием фреймворков соответствия IAB TCF v2.0 или IAB CCPA, на теги в ваших веб-просмотрах. Если вы заинтересованы в реализации единого потока согласия как владелец как WebView , так и соответствующего монетизируемого веб-контента, используйте свою платформу управления согласием для сбора согласия в контексте WebView .