Configurar o WKWebView

Se o app usar WKWebView para mostrar conteúdo da Web, é recomendável configurá-lo para que o conteúdo possa ser monetizado de maneira ideal com anúncios.

Este guia mostra como fornecer informações sobre a configuração de um objeto WKWebView.

Importante: para configurar e otimizar corretamente o WKWebView, aplique todas as recomendações a seguir a cada instância do WKWebView no seu app.

Conteúdo de mídia

As configurações padrão do WKWebView não são otimizadas para anúncios em vídeo. Use as APIs WKWebViewConfiguration para configurar seu WKWebView para reprodução inline e reprodução automática de vídeo.

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

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

Carregar conteúdo da visualização da Web

Os cookies e os URLs de página são importantes para a monetização da visualização da Web e só funcionam como esperado quando load(_:) é usado com um URL baseado em rede. Para otimizar o desempenho do WKWebView, recomendamos carregar o conteúdo da Web de um URL baseado em rede.

Swift

import WebKit

var webview: WKWebview!

class ViewController: UIViewController {
  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)

    // Load the URL for optimized web view performance.
    guard let url = URL(string: "https://google.github.io/webview-ads/test/") else { return }
    let request = URLRequest(url: url)
    webView.load(request)
  }
}

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

  // Load the URL for optimized web view performance.
  NSURL *url = [NSURL URLWithString:@"https://google.github.io/webview-ads/test/"];
  NSURLRequest *request = [NSURLRequest requestWithURL:url];
  [webView loadRequest:request];
}

Dica: se você precisar carregar conteúdo da visualização da Web de outras maneiras, como HTML, transmita o identificador fornecido pelo editor (PPID) e o URL da página relevante (GPT | AdSense) com sua solicitação de visualização da Web para reduzir o impacto negativo na monetização. Essas mudanças mitigam a perda de monetização em comparação com o carregamento de conteúdo da Web de um URL baseado em rede.

Testar a visualização da Web

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

https://google.github.io/webview-ads/test/

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 visualização da Web

• Como os cookies primários funcionam
• JavaScript 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 que você precise clicar no botão de reprodução.
• O anúncio em vídeo pode ser reproduzido novamente

Depois que o teste for concluído, substitua o URL de teste pelo URL que a visualização da Web pretende carregar.