Skip to main content

​
Overview

Display backfill ads in your WKWebView by registering it with the Adrop SDK. This allows web content within your app to show ads through the Adrop platform.

​
Info.plist Configuration

Add the following key to your Info.plist to enable backfill ads in WebView:
Info.plist
<key>GADIntegrationManager</key>
<string>webview</string>
This configuration is required for backfill ads to work properly in WebView. Without it, backfill ads may not display.

​
Register WebView

import WebKit
import AdropAds

class WebViewController: UIViewController {

    @IBOutlet weak 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)
        // Register WebView for backfill ads support
        // Call as early as possible, before loading content
        Adrop.registerWebView(webView)

        // Load your web content
        if let url = URL(string: "https://your-website.com") {
            webView.load(URLRequest(url: url))
        }
    }
}

@import WebKit;
@import AdropAds;

@interface WebViewController ()
@property (nonatomic, weak) IBOutlet WKWebView *webView;
@end

@implementation WebViewController

- (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 WebView for backfill ads support
    // Call as early as possible, before loading content
    [Adrop registerWebView:self.webView];

    // Load your web content
    NSURL *url = [NSURL URLWithString:@"https://your-website.com"];
    [self.webView loadRequest:[NSURLRequest requestWithURL:url]];
}

@end
registerWebView() must be called on the main thread. Call this method as early as possible (e.g., in viewDidLoad), before loading any web content.
Backfill ads in WebView requires adrop-ads-backfill module. If the module is not installed, registerWebView() is silently ignored.

​
Handling External URLs

If your app opens non-own-domain URLs in an external browser, you must ensure that ad resource requests (e.g., googleads.g.doubleclick.net) are not blocked. Ad resources such as iframes and scripts are loaded automatically by the ad SDK — they are not user-initiated navigations. Only redirect user-initiated main frame navigations to an external browser. 
import UIKit
import WebKit

let allowedHost = "my-domain.com"

func webView(_ webView: WKWebView,
             decidePolicyFor navigationAction: WKNavigationAction,
             decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {

    guard let url = navigationAction.request.url else {
        decisionHandler(.cancel)
        return
    }

    let host = url.host ?? ""

    // Only redirect user-initiated navigations to external browser
    // Ad resources (e.g., googleads.g.doubleclick.net) load via iframes/scripts,
    // not user clicks — do not block them
    if !host.contains(allowedHost),
       navigationAction.navigationType == .linkActivated {
        UIApplication.shared.open(url, options: [:], completionHandler: nil)
        decisionHandler(.cancel)
        return
    }

    decisionHandler(.allow)
}

NSString *allowedHost = @"my-domain.com";

- (void)webView:(WKWebView *)webView
    decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction
    decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler {

    NSURL *url = navigationAction.request.URL;
    if (!url) {
        decisionHandler(WKNavigationActionPolicyCancel);
        return;
    }

    NSString *host = url.host ?: @"";

    // Only redirect user-initiated navigations to external browser
    // Ad resources (e.g., googleads.g.doubleclick.net) load via iframes/scripts,
    // not user clicks — do not block them
    if (![host containsString:allowedHost] &&
        navigationAction.navigationType == WKNavigationTypeLinkActivated) {
        [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:nil];
        decisionHandler(WKNavigationActionPolicyCancel);
        return;
    }

    decisionHandler(WKNavigationActionPolicyAllow);
}
Do not block or redirect all non-own-domain requests. Ad resources like googleads.g.doubleclick.net are loaded automatically during the backfill ad process and must be allowed to load within the WebView.

Banner Ads

Learn how to integrate banner ads

Reference

API reference

Examples

Example repository