Integracja interfejsu WebView API for Ads

Wybierz platformę: Android Android iOS

Dzięki interfejsom API komponentu WebView dla reklam tagi w komponencie WKWebView mogą korzystać z sygnałów z aplikacji. Pomaga to zwiększać zarobki wydawców, którzy udostępniają treści, i chronić reklamodawców przed spamem. Te sygnały z aplikacji, takie jak identyfikator aplikacji i jej wersja, pomagają aktywować raportowanie i kierowanie na zasoby reklamowe w przeglądarce w aplikacji przypadki użycia, które są dostępne tylko w przypadku ruchu z aplikacji.

Jak to działa

Komunikacja z Google Mobile Ads SDK odbywa się tylko w odpowiedzi na zdarzenia reklamowe wywoływane przez dowolne z tych elementów:

• kod AdSense,
• tag wydawcy Google,
• IMA dla HTML5.

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

Wymagania wstępne

• Google Mobile Ads SDK w wersji 9.6.0 lub nowszej.

• Zaktualizuj plik Info.plist, dodając ten klucz i wartość ciągu. Pozwala to pominąć sprawdzanie przez Google Mobile Ads SDK wartości GADApplicationIdentifier, które dotyczy deweloperów wdrażających reklamy poza komponentem WebView. Jeśli pominiesz ten krok i nie podasz wartości GADApplicationIdentifier, pakiet Google Mobile Ads SDK zgłosi wyjątek GADInvalidInitializationException podczas uruchamiania aplikacji.

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

Zarejestruj komponent WebView

Wywołaj funkcję register(_:) w wątku głównym, aby nawiązać połączenie z modułami obsługi JavaScript w kodzie AdSense lub tagu wydawcy Google w każdej instancji WKWebView. Należy to zrobić jak najszybciej, np. w viewDidLoad metodzie 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 spełnione są te warunki, testowy adres URL wyświetla zielone paski stanu, co oznacza, że integracja się powiodła:

• WKWebView połączony z Google Mobile Ads SDK

Dalsze kroki

• Uzyskaj zgodę w komponencie WKWebView. Interfejsy API komponentu WebView dla reklam nie propagują zgody uzyskanej w kontekście aplikacji mobilnej za pomocą platform IAB TCF w wersji 2.3 lub IAB CCPA do tagów w komponentach WebView. Jeśli jako właściciel komponentu WKWebView i odpowiadającej mu treści internetowej, na której zarabiasz, chcesz wdrożyć jeden proces uzyskiwania zgody, współpracuj z platformą do zarządzania zgodą użytkowników, aby uzyskać zgodę w kontekście WKWebView.