Integrar a API WebView para anúncios

As APIs de visualização da Web para anúncios disponibilizam os indicadores de apps para as tags na sua WebView, ajudando a melhorar a monetização do editores que forneceram o conteúdo e protegem os anunciantes contra spam.

Como funciona

A comunicação com o SDK dos anúncios para dispositivos móveis do Google acontece apenas em resposta ao anúncio eventos acionados por qualquer um dos seguintes:

• Código do AdSense
• Tag do editor do Google
• IMA para HTML5

O SDK adiciona gerenciadores de mensagens ao WebView para detectar esses eventos de anúncio. Para uma melhor como isso funciona, consulte o código-fonte do página de teste.

Pré-requisitos

• SDK dos anúncios para dispositivos móveis do Google versão 20.6.0 ou superior.

• Android API de nível 21 ou mais recente.

• Adicione a seguinte tag <meta-data> no seu arquivo AndroidManifest.xml para ignorar a verificação do APPLICATION_ID. Se você pular esta etapa e não fornecer a tag <meta-data>, o SDK dos anúncios para dispositivos móveis do Google vai gerar uma IllegalStateException na inicialização do app.

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

Registrar a visualização da Web

Ligação registerWebView() na linha de execução principal para estabelecer uma conexão com os gerenciadores JavaScript na código do AdSense ou Tag do editor do Google em cada WebView instância. Isso deve ser feito o mais cedo possível, como nos onCreate() do MainActivity.

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

Testar sua integração

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

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

O URL de teste mostrará barras de status verdes para uma integração bem-sucedida se o as seguintes condições se aplicam:

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

Próximas etapas

• Solicite consentimento em WebView. As APIs de visualização da Web para Os anúncios não propagam o consentimento coletado no contexto do app para dispositivos móveis usando o TCF v2.0 do IAB ou CCPA do IAB estruturas de conformidade às tags nas visualizações da Web. Se você tiver interesse a implementação de um único fluxo de consentimento como proprietário WebView e o conteúdo da Web correspondente monetizados, trabalhe com sua plataforma de gestão de consentimento para obter consentimento em o WebView contexto.