WKWebView 설정

앱에서 iOS WKWebView 를 사용하여 웹 콘텐츠를 표시하는 경우 콘텐츠에서 광고 수익 창출이 최적화될 수 있도록 구성하는 것이 좋습니다.

이 가이드에서는WKWebView 객체를 구성하는 방법에 대한 정보를 제공하는 방법을 보여줍니다.

미디어 콘텐츠

기본 WKWebView 설정은 동영상 광고에 최적화되어 있지 않습니다. WKWebViewConfiguration API를 사용하여 인라인 재생 및 자동 동영상 재생을 위한 WKWebView를 구성합니다.

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

웹 보기 콘텐츠 로드

쿠키와 페이지 URL은 웹 뷰 성능에 중요하며 load(_:) 가 네트워크 기반 URL과 함께 사용될 때만 예상대로 작동합니다. 최적화된 WKWebView 성능을 위해 네트워크 기반 URL에서 웹 콘텐츠를 로드하는 것이 좋습니다.

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

웹 뷰 테스트

앱 개발 중에 다음 테스트 URL을 로드하는 것이 좋습니다.

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

해당 설정이 광고에 의도한 효과를 발휘하는지 확인할 수 있습니다. 다음과 같은 경우 테스트 URL에 완전한 통합을 위한 성공 기준이 있습니다.

웹 보기 설정

  • 퍼스트 파티 쿠키의 작동 원리
  • 자바스크립트 사용

동영상 광고

  • 동영상 광고가 인라인으로 재생되고 전체 화면 내장 플레이어에서 열리지 않습니다.
  • 재생 버튼을 클릭하지 않아도 동영상 광고가 자동으로 재생됩니다.
  • 동영상 광고를 다시 재생할 수 있습니다.

테스트가 완료되면 테스트 URL을 웹 뷰에서 로드할 URL로 대체합니다.