Configurer WKWebView

Si votre application utilise WKWebView pour afficher du contenu Web, nous vous recommandons de la configurer afin que le contenu puisse être monétisé de manière optimale avec des annonces.

Ce guide explique comment configurer un objet WKWebView.

Important :Pour configurer et optimiser correctement WKWebView, appliquez toutes les recommandations suivantes à chaque instance WKWebView de votre application.

Contenu multimédia

Les paramètres par défaut de WKWebView ne sont pas optimisés pour les annonces vidéo. Utilisez les API WKWebViewConfiguration pour configurer votre WKWebView pour la lecture intégrée et la lecture vidéo automatique.

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

Charger le contenu de la vue Web

Les cookies et les URL de page sont importants pour la monétisation des vues Web et ne fonctionnent comme prévu que lorsque load(_:) est utilisé avec une URL basée sur un réseau. Pour des performances WKWebView optimisées, nous vous recommandons vivement de charger le contenu Web à partir d'une URL basée sur un réseau.

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://webview-api-for-ads-test.glitch.me") 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://webview-api-for-ads-test.glitch.me"];
  NSURLRequest *request = [NSURLRequest requestWithURL:url];
  [webView loadRequest:request];
}

Conseil :Si vous devez charger du contenu de vue Web à partir d'autres moyens, tels que le code HTML, vous pouvez atténuer l'impact négatif sur la monétisation en transmettant l'identifiant fourni par l'éditeur (PPID) et l'URL de la page concernée (GPT | AdSense) avec votre requête de vue Web. Ces modifications atténuent la perte de monétisation par rapport au chargement de contenu Web à partir d'une URL basée sur un réseau.

Tester la vue Web

Pendant le développement de l'application, nous vous recommandons de charger cette URL de test:

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

pour vérifier que ces paramètres ont l'effet souhaité sur les annonces. L'URL de test présente des critères de réussite pour une intégration complète si les éléments suivants sont observés:

Paramètres de la vue Web

• Les cookies propriétaires fonctionnent
• JavaScript activé

Annonce vidéo

• L'annonce vidéo est lue en ligne et ne s'ouvre pas dans le lecteur intégré plein écran
• L'annonce vidéo est lue automatiquement sans que l'utilisateur ait à cliquer sur le bouton de lecture.
• L'annonce vidéo peut être rejouée

Une fois les tests terminés, remplacez l'URL de test par l'URL que la vue Web doit charger.