Integracja interfejsu WebView API for Ads

Interfejsy WebView API for Ads udostępniają sygnały z aplikacji tagom w WKWebView, co pomaga zwiększyć przychody wydawców, którzy udostępnili treści, i chronić reklamodawców przed spamem. Te sygnały z aplikacji, takie jak identyfikator i wersja aplikacji, pomagają aktywować przypadki użycia RaportowaniaKierowania na zasoby reklamowe przeglądarki w aplikacji, które w inny sposób są dostępne tylko w przypadku ruchu w aplikacji.

Jak to działa

Komunikacja z  pakietem SDK do reklam mobilnych Google odbywa się tylko w odpowiedzi na zdarzenia reklamowe wywoływane przez dowolne z tych elementów:

Pakiet SDK dodaje do zarejestrowanego obiektu WKWebView moduły obsługi wiadomości, które nasłuchują tych zdarzeń związanych z reklamami. Aby lepiej zrozumieć, jak to działa, wyświetl kod źródłowy strony testowej.

Wymagania wstępne

  • Pakiet SDK do reklam mobilnych Google w wersji 9.6.0 lub nowszej.
  • Zaktualizuj plik Info.plist, dodając ten klucz i wartość ciągu. Omija to sprawdzanie wartościGADApplicationIdentifier, które pakiet SDK do reklam mobilnych Google przeprowadza w przypadku deweloperów wdrażających reklamy poza widokiem internetowym. Jeśli pominiesz ten krok i nie podasz GADApplicationIdentifier, pakiet SDK do reklam mobilnych Google GADInvalidInitializationException zgłosi błąd przy uruchomieniu aplikacji.

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

Rejestrowanie widoku internetowego

Wywołaj register(_:) w głównym wątku, aby nawiązać połączenie z procedurami obsługi JavaScriptu w kodzie AdSense lub tagu wydawcy Google w każdym wystąpieniu WKWebView. Należy to zrobić jak najwcześniej, np. w metodzie viewDidLoad kontrolera widoku.

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.
    MobileAds.shared.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];
}

Testowanie integracji

Zanim zaczniesz używać własnego adresu URL, zalecamy wczytanie tego adresu URL, aby przetestować integrację:

https://google.github.io/webview-ads/test/#api-for-ads-tests

Jeśli integracja przebiegła pomyślnie, przy adresie URL testu pojawią się zielone paski stanu, pod warunkiem że:

  • WKWebView połączony z pakietem SDK do reklam mobilnych Google.

Dalsze kroki