Integracja interfejsu WebView API for Ads

Interfejsy API widoków internetowych na potrzeby reklam udostępniają sygnały z aplikacji tagom w Twoim elemencieWKWebView, co pomaga zwiększyć przychody wydawców, którzy dostarczyli 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 dla HTML5

SDK dodaje moduły obsługi wiadomości do zarejestrowanych zdarzeńWKWebView , aby nasłuchiwać tych zdarzeń reklamowych. Aby lepiej zrozumieć, jak to działa, wyświetl kod źródłowy strony testowej.

Ostrzeżenie: nie wywołuj removeAllScriptMessageHandlers() z instancji WKWebView, ponieważ może to mieć niezamierzone skutki uboczne. W razie potrzeby wywołaj removeScriptMessageHandler(forName:), aby usunąć poszczególne moduły obsługi wiadomości.

Wymagania wstępne

• pakiet SDK do reklam mobilnych Google w wersji 9.6.0 lub nowszej.

• Zaktualizuj plik Info.plist przy użyciu poniższego klucza i ciągu znaków. Pomija to kontrolę przeprowadzaną przez pakiet SDK do reklam mobilnych Google w przypadku wartości GADApplicationIdentifier, która dotyczy deweloperów wdrażających reklamy poza widokiem strony. Jeśli pominiesz ten krok i nie podasz parametru GADApplicationIdentifier, pakiet SDK do reklam mobilnych Google wygeneruje 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 witryny

Wywołaj metodę register(_:) w wątku głównym, aby nawiązać połączenie z modułami obsługi JavaScript w kodzie AdSense lub w tagu wydawcy Google w każdym WKWebView instancji. Należy to zrobić jak najwcześniej, np. w metodzie viewDidLoad kontrolera widoków danych.

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.
    GADMobileAds.sharedInstance().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

Przed użyciem własnego adresu URL zalecamy wczytanie tego adresu URL w celu przetestowania integracji:

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

Testowy adres URL wyświetla zielone paski stanu, informując o udanej integracji, jeśli spełnione są te warunki:

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

Dalsze kroki

• Zbieraj zgody użytkowników od: WKWebView. Interfejsy Web View API for Ads nie rozpowszechniają do tagów w widokach witryny zgody użytkownika uzyskanej w kontekście aplikacji mobilnej za pomocą Zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2.0 lub IAB CCPA. Jeśli chcesz wdrożyć pojedynczy proces uzyskiwania zgody jako właściciel zarównoWKWebView , jak i powiązanych z nim treści internetowych, na których zarabiasz, skontaktuj się ze swoją platformą do zarządzania zgodą użytkowników, aby uzyskiwać zgodę WKWebView w tym kontekście.