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.

Jak to działa

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

• Kod AdSense
• Tag wydawcy Google
• IMA do HTML5

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 za pomocą tego klucza i wartości ciągu. Omija to sprawdzanie wartości GADApplicationIdentifier, które pakiet SDK do reklam mobilnych Google przeprowadza w przypadku deweloperów wyświetlających reklamy poza widokiem internetowym. Jeśli pominiesz ten krok i nie podasz GADApplicationIdentifier, pakiet SDK do reklam mobilnych Google zgłosi GADInvalidInitializationException przy uruchamianiu 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.

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

@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łączone z pakietem SDK do reklam mobilnych Google;

Dalsze kroki

• Uzyskiwanie zgody użytkowników w WKWebView. Interfejsy Web view API do reklam nie przekazują do tagów w widokach internetowych zgody zebranej w kontekście aplikacji mobilnej za pomocą Zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2.0 ani Zasad IAB dotyczących ochrony prywatności w Stanach Zjednoczonych. Jeśli jesteś właścicielem zarówno WKWebView, jak i odpowiedniej treści internetowej, na której zarabiasz, i chcesz wdrożyć jeden proces uzyskiwania zgody, współpracuj z platformą do zarządzania zgodą użytkowników, aby zbierać zgody w kontekście WKWebView.