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 WKWebView, ajudando a melhorar a monetização do editores que forneceram o conteúdo e protegem os anunciantes contra spam. Esses indicadores do app, como o ID e a versão, ajudam a ativar os relatórios. e Segmentar inventário do navegador no app casos de uso que só estariam disponíveis no tráfego de apps.

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:

O SDK adiciona gerenciadores de mensagens ao WKWebView 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 9.6.0 ou superior.
  • Atualize o arquivo Info.plist com a seguinte chave e valor de string. Isso ignora uma verificação feita pelo SDK dos anúncios para dispositivos móveis do Google em um Valor de GADApplicationIdentifier que se aplica aos desenvolvedores que implementam anúncios fora de uma visualização da Web. Se você perder esta etapa e não fornecer uma GADApplicationIdentifier, o SDK dos anúncios para dispositivos móveis do Google gera uma GADInvalidInitializationException na inicialização do app.

    <!-- Indicate Google Mobile Ads SDK usage is only for web view APIs for ads -->
    <key>GADIntegrationManager</key>
    <string>webview</string>
    

Registrar a visualização da Web

Ligação register(_:) 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 WKWebView instância. Isso deve ser feito o mais cedo possível, como nos viewDidLoad do seu controlador de visualizações.

Swift

import WebKit

class ViewController: UIViewController {

  var webView: WKWebView!

  override func viewDidLoad() {
    super.viewDidLoad()

    // Initialize a WKWebViewConfiguration object.
    let webViewConfiguration = WKWebViewConfiguration()
    // Let HTML videos with a "playsinline" attribute play inline.
    webViewConfiguration.allowsInlineMediaPlayback = true
    // Let HTML videos with an "autoplay" attribute play automatically.
    webViewConfiguration.mediaTypesRequiringUserActionForPlayback = []

    // Initialize the WKWebView with your WKWebViewConfiguration object.
    webView = WKWebView(frame: view.frame, configuration: webViewConfiguration)
    view.addSubview(webView)

    // Register the web view.
    GADMobileAds.sharedInstance().register(webView)
  }
}

Objective-C

@import WebKit;

#import "ViewController.h"

@interface ViewController ()

@property(nonatomic, strong) WKWebView *webView;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  // Initialize a WKWebViewConfiguration object.
  WKWebViewConfiguration *webViewConfiguration = [[WKWebViewConfiguration alloc] init];
  // Let HTML videos with a "playsinline" attribute play inline.
  webViewConfiguration.allowsInlineMediaPlayback = YES;
  // Let HTML videos with an "autoplay" attribute play automatically.
  webViewConfiguration.mediaTypesRequiringUserActionForPlayback = WKAudiovisualMediaTypeNone;

  // Initialize the WKWebView with your WKWebViewConfiguration object.
  self.webView = [[WKWebView alloc] initWithFrame:self.view.frame configuration:webViewConfiguration];
  [self.view addSubview:self.webView];

  // Register the web view.
  [GADMobileAds.sharedInstance registerWebView:self.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:

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

Próximas etapas

  • Solicite consentimento em WKWebView. 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 WKWebView e o conteúdo da Web correspondente monetizados, trabalhe com sua plataforma de gestão de consentimento para obter consentimento em o WKWebView contexto.