Integrar a API WebView para anúncios

As APIs de visualização da Web para anúncios disponibilizam indicadores de apps para as tags na sua classe WebView. Isso melhora a monetização dos publishers que forneceram o conteúdo e protege os anunciantes contra spam. Esses indicadores do app, como ID e versão do app, ajudam a ativar os casos de uso de relatórios e segmentação do inventário do navegador no app, que, de outra forma, só estão disponíveis no tráfego do app.

Como funciona

A comunicação com o SDK dos anúncios para dispositivos móveis do Google (Beta) só acontece em resposta a eventos de anúncio acionados por alguma das opções a seguir:

O SDK adiciona manipuladores de mensagens à WebView registrada para detectar esses eventos de anúncio. Para entender melhor como isso funciona, consulte o código-fonte da página de teste.

Pré-requisitos

Transmitir o ID do aplicativo para o SDK

Se você já tiver um ID de aplicativo do Ad Manager, inicialize o SDK dos anúncios para dispositivos móveis do Google (Beta) com o ID do aplicativo atual.

Caso contrário, transmita InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID como o ID do aplicativo ao inicializar o SDK dos anúncios para dispositivos móveis do Google (beta).

Kotlin

MobileAds.initialize(
    this@MainActivity,
    // Use this application ID to initialize the Google Mobile Ads SDK (beta) if
    // you don't have an Ad Manager application ID.
    InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
        .build(),
  ) {
    // Adapter initialization complete.
  }

Java

MobileAds.initialize(
    this,
    // Use this application ID to initialize the Google Mobile Ads SDK (beta) if
    // you don't have an Ad Manager application ID.
    new InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
        .build(),
        initializationStatus -> {
          // Adapter initialization is complete.
          });

Registrar a visualização da Web

Chame registerWebView() na linha de execução principal para estabelecer uma conexão com os manipuladores de JavaScript no Código do AdSense ou na Tag de Publisher do Google em cada instância de WebView. Isso deve ser feito o quanto antes, como no método onCreate() da sua classe MainActivity.

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView
import com.google.android.libraries.ads.mobile.sdk.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.libraries.ads.mobile.sdk.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);
  }
}

Testar sua integração

Antes de usar seu próprio URL, recomendamos que você carregue o seguinte URL para testar a integração:

https://google.github.io/webview-ads/test/#api-for-ads-tests

O URL de teste mostra barras de status verdes para uma integração bem-sucedida, contanto que a seguinte condição seja atendida:

  • WebView conectado ao SDK dos anúncios para dispositivos móveis do Google (Beta)

Próximas etapas

  • Obtenha consentimento na WebView. As APIs de visualização da Web para anúncios não propagam o consentimento coletado no contexto do app para dispositivos móveis usando as estruturas de conformidade da TCF v2.0 do IAB ou da CCPA do IAB para as tags nas suas visualizações da Web. Se você quiser implementar um único fluxo de consentimento como proprietário da WebView e do conteúdo da Web correspondente que está sendo monetizado, trabalhe com sua plataforma de gestão de consentimento para coletar o consentimento no contexto da WebView.
Anterior
Configurar o WebView
Avançar
Otimizar o comportamento de clique