Integra l'API WebView per gli annunci

Seleziona la piattaforma: Android (beta) Android iOS

Le API WebView per gli annunci rendono disponibili gli indicatori delle app ai tag in WKWebView, contribuendo a migliorare la monetizzazione per i publisher che hanno fornito i contenuti e a proteggere gli inserzionisti dallo spam. Questi indicatori delle app, come l'ID app e la versione dell'app, aiutano ad attivare Reporting e Target browser in-app inventory casi d'uso che sono altrimenti disponibili solo sul traffico delle app.

Come funziona

La comunicazione con Google Mobile Ads SDK avviene solo in risposta agli eventi pubblicitari attivati da uno dei seguenti elementi:

• Codice AdSense
• Tag publisher di Google
• IMA per HTML5

L'SDK aggiunge gestori di messaggi al WKWebView registrato per ascoltare questi eventi pubblicitari. Per capire meglio come funziona, visualizza il codice sorgente della pagina di test.

Avviso: non chiamare removeAllScriptMessageHandlers() dall'istanza WKWebView, in quanto ciò ha effetti collaterali imprevisti. Se necessario, chiama removeScriptMessageHandler(forName:) per rimuovere i singoli gestori di messaggi.

Prerequisiti

• Google Mobile Ads SDK versione 9.6.0 o successive.

• Aggiorna il file Info.plist con la seguente chiave e il seguente valore stringa. In questo modo viene ignorato un controllo eseguito dall'Google Mobile Ads SDK per un GADApplicationIdentifier valore che si applica agli sviluppatori che implementano gli annunci al di fuori di una visualizzazione web. Se salti questo passaggio e non fornisci un GADApplicationIdentifier, il Google Mobile Ads SDK genera un'eccezione GADInvalidInitializationException all'avvio dell'app.

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

Registra la visualizzazione web

Chiama register(_:) nel thread principale per stabilire una connessione con i gestori JavaScript nel codice AdSense o nel tag publisher di Google all'interno di ogni istanza WKWebView. Questa oper101}azione deve essere eseguita il prima possibile, ad esempio nel viewDidLoad metodo del controller di visualizzazione.

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];
}

Verifica la tua integrazione

Prima di utilizzare il tuo URL, ti consigliamo di caricare il seguente URL per testare l'integrazione:

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

L'URL di test mostra barre di stato verdi per un'integrazione riuscita se sono soddisfatte le seguenti condizioni:

• WKWebView connesso a Google Mobile Ads SDK

Passaggi successivi

• Raccogli il consenso in WKWebView. Le API WebView per gli annunci non propagano i consensi raccolti nel contesto dell'app mobile utilizzando i framework di conformità IAB TCF v2.0 o IAB CCPA ai tag nelle visualizzazioni web. Se ti interessa implementare un singolo flusso di consenso come proprietario sia di WKWebView sia dei contenuti web corrispondenti monetizzati, collabora con la tua piattaforma di gestione del consenso per raccogliere il consenso nel contesto WKWebView.