Configurar o WebView

Caso seu Android app use WebView para mostrar conteúdo da Web, é recomendável configurá-lo para que ele possa ser monetizado da melhor forma com anúncios.

Neste guia, mostramos como fornecer informações sobre como configurar um objetoWebView .

Importante: para configurar e otimizar corretamente WebView, aplique todas as recomendações abaixo a cada instância WebView no app. Para ajudar a identificar cada visualização da Web, alterne a flag "highlight-all-webviews" no WebView DevTools para destacar as visualizações da Web no app com uma tonalidade amarela.

Ativar cookies de terceiros

Para melhorar a experiência de publicidade do usuário e ser consistente com a política de cookies do Chrome, ative cookies de terceiros na sua instância do WebView.

Java

CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true);

Kotlin

CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)

Configurações da Web

Default WebView settings are not optimized for ads. Use the WebSettings APIs to configure your WebView for:

• JavaScript
• Access to local storage

• Automatic video play

Java

import android.webkit.CookieManager;
import android.webkit.WebView;

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);
  }
}

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView

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
  }
}

Carregar o conteúdo da visualização da Web

Os cookies e os URLs de páginas são importantes para o desempenho da visualização da Web e só funcionam conforme o esperado quando loadUrl() é usado com um URL baseado em rede. Para uma performance WebView otimizada, carregue conteúdo da Web diretamente de URLs baseados em rede. Evite usar WebViewAssetLoader, carregar recursos do dispositivo ou gerar conteúdo da Web de forma dinâmica.

Java

import android.webkit.CookieManager;
import android.webkit.WebView;

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);

    // Load the URL for optimized web view performance.
    webView.loadUrl("https://webview-api-for-ads-test.glitch.me");
  }
}

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView

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

    // Load the URL for optimized web view performance.
    webView.loadUrl("https://webview-api-for-ads-test.glitch.me")
  }
}

Testar a visualização da Web

Durante o desenvolvimento do aplicativo, recomendamos que você carregue este URL de teste:

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

para verificar se essas configurações têm o efeito desejado nos anúncios. O URL de teste tem critérios de sucesso para uma integração completa se o seguinte for observado:

Configurações da vista da Web

• Cookies de terceiros funcionam

• Os cookies primários funcionam
• JavaScript ativado

• Armazenamento DOM ativado

Anúncio em vídeo

• O anúncio em vídeo é reproduzido inline e não abre no player integrado de tela cheia.
• O anúncio em vídeo é reproduzido automaticamente sem clicar no botão de reprodução.
• O anúncio em vídeo pode ser reproduzido de novo

Após a conclusão do teste, substitua o URL de teste pelo URL que a visualização da Web pretende carregar.