Integra l'API WebView per gli annunci

Le API Web View per gli annunci rendono disponibili gli indicatori delle app per i tag in WKWebView, contribuendo a migliorare la monetizzazione per i publisher che hanno fornito i contenuti e a proteggere gli inserzionisti dallo spam.

Come funziona

La comunicazione con l'SDK Google Mobile Ads avviene solo in risposta a eventi annuncio attivati da uno dei seguenti elementi:

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

L'SDK aggiunge gestori dei messaggi all'elemento WKWebView registrato per ascoltare questi eventi relativi agli annunci. Per comprendere meglio come funziona, visualizza il codice sorgente della pagina di test.

Avviso: non chiamare removeAllScriptMessageHandlers() dalla tua istanza WKWebView, perché ciò potrebbe causare effetti collaterali indesiderati. Se necessario, chiama il numero removeScriptMessageHandler(forName:) per rimuovere invece i singoli gestori dei messaggi.

Prerequisiti

• Versione dell'SDK Google Mobile Ads 9.6.0 o successiva.

• Aggiorna il file Info.plist con la chiave e il valore stringa seguenti. Ciò ignora un controllo eseguito dall'SDK Google Mobile Ads per un valore GADApplicationIdentifier valido per gli sviluppatori che implementano gli annunci al di fuori di una visualizzazione web. Se salti questo passaggio e non fornisci un GADApplicationIdentifier, l'SDK Google Mobile Ads genera un 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 vista web

Chiama register(_:) sul thread principale per stabilire una connessione con i gestori JavaScript nel codice AdSense o nel Tag publisher di Google all'interno di ogni WKWebView istanza. Questa operazione deve essere eseguita il prima possibile, ad esempio nel metodo viewDidLoad 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.
    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];
}

Testare l'integrazione

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

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

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

• WKWebView collegato all'SDK Google Mobile Ads

Passaggi successivi

• Raccogli il consenso in WKWebView. Le API Web View for Ads non propagano il consenso raccolto nel contesto dell'app mobile utilizzando i framework di conformità della versione 2.0 del TCF di IAB o IAB CCPA ai tag delle viste web. Se vuoi implementare un singolo flusso di consenso in qualità di proprietario sia delWKWebView sia dei contenuti web corrispondenti che vengono monetizzati, collabora con la tua piattaforma di gestione del consenso per raccogliere il consenso nel WKWebView contesto.