Integracja interfejsu WebView API for Ads

Interfejsy API do wyświetlania reklam w trybie przeglądarki udostępniają sygnały aplikacji tagom w Twojej aplikacji WKWebView, co pomaga zwiększyć przychody wydawców, którzy udostępnili treści, oraz 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łane przez:

• Kod AdSense
• Tag wydawcy Google
• IMA dla HTML5

Pakiet SDK dodaje do zarejestrowanego obiektu WKWebView moduły obsługi wiadomości, aby nasłuchiwać tych zdarzeń reklamowych. Aby lepiej zrozumieć, jak to działa, zapoznaj się z kodem źródłowym strony testowej.

Wymagania wstępne

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

• Zaktualizuj plik Info.plist, podając ten klucz i wartość ciągu znaków. Umożliwia to pominięcie kontroli, którą pakiet SDK do reklam mobilnych Google przeprowadza w przypadku wartości GADApplicationIdentifier, która dotyczy deweloperów implementujących reklamy poza widokiem internetowym. Jeśli pominiesz ten krok i nie podasz wartości parametru GADApplicationIdentifier, pakiet SDK do reklam mobilnych Google wygeneruje błądGADInvalidInitializationException po 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 funkcję register(_:) w głównym wątku, aby nawiązać połączenie z obsługami JavaScript w kodzie AdSense lub tagu Google Publisher Tag w każdym wystąpieniu WKWebView. Należy to zrobić jak najszybciej, na przykład 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.
    GADMobileAds.sharedInstance().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 użyjesz własnego adresu URL, zalecamy załadowanie tego adresu URL, aby przetestować integrację:

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

W przypadku pomyślnej integracji adres URL testowy wyświetla zielone paski stanu, jeśli są spełnione te warunki:

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

Dalsze kroki

• Uzyskiwanie zgody użytkowników w WKWebView. Interfejsy API do wyświetlania reklam w przeglądarce nie przekazują zgody uzyskanej w kontekście aplikacji mobilnej za pomocą Zasad IAB TCF w wersji 2.0 lub Zasad IAB CCPA do tagów w widokach internetowych. Jeśli chcesz wdrożyć jeden proces uzyskiwania zgody jako właściciel WKWebView i odpowiednich treści internetowych, na których zarabiasz, współpracuj z platformą do zarządzania zgodą użytkowników, aby uzyskać zgodę w kontekście WKWebView.