Cómo integrar la API de WebView para anuncios

Las APIs de vista web para anuncios permiten que los indicadores de la app estén disponibles para las etiquetas de tu WKWebView, esto ayuda a mejorar la monetización del publicadores que proporcionaron el contenido y protegen a los anunciantes contra el spam.

Cómo funciona

La comunicación con el SDK de anuncios de Google para dispositivos móviles solo se produce en respuesta a un anuncio. eventos activados por cualquiera de los siguientes elementos:

• Código de AdSense
• Google Publisher Tag
• IMA para HTML5

El SDK agrega controladores de mensajes al archivo WKWebView para escuchar estos eventos de anuncios. Para mejorar para comprender cómo funciona, consulta el código fuente de la página de prueba.

Advertencia: No llames a removeAllScriptMessageHandlers(). de tu instancia de WKWebView, ya que tiene efectos secundarios no deseados. Si es necesario, llamar removeScriptMessageHandler(forName:) para quitar controladores de mensajes individuales.

Requisitos previos

• SDK de anuncios de Google para dispositivos móviles versión 9.6.0 o una posterior.

• Actualiza el archivo Info.plist con la siguiente clave y valor de cadena. Esta omite una comprobación que hace el SDK de anuncios de Google para dispositivos móviles para un Valor GADApplicationIdentifier que se aplica a los desarrolladores que implementan anuncios fuera de una vista web. Si omites este paso y no proporcionas una GADApplicationIdentifier, el SDK de anuncios de Google para dispositivos móviles arroja un GADInvalidInitializationException al iniciar la 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

Llamada register(_:) en el subproceso principal para establecer una conexión con los controladores JavaScript en la el código de AdSense o Google Publisher Tag dentro de cada WKWebView instancia. Esta debe hacerse lo antes posible, como en el viewDidLoad del controlador de vista.

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

Cómo probar tu integración

Antes de usar tu propia URL, te recomendamos que cargues la siguiente para probarla la integración:

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

La URL de prueba muestra barras de estado verdes para una integración correcta si la se aplican las siguientes condiciones:

• WKWebView conectado al SDK de anuncios de Google para dispositivos móviles

Próximos pasos

• Obtén el consentimiento en WKWebView. Las APIs de WebView para Los anuncios no propagan el consentimiento recopilado en el contexto de la aplicación para dispositivos móviles con MTC v2.0 de IAB o CCPA de IAB de cumplimiento a las etiquetas de tus vistas web. Si te interesa un único flujo de consentimiento como propietario del WKWebView y su contenido web correspondiente monetizado, trabaja con su plataforma de administración de consentimiento para obtener el consentimiento el WKWebView contexto.