As APIs de visualização da Web para anúncios disponibilizam os indicadores do app para as tags na sua
WKWebView
, ajudando a melhorar a monetização para os
editores que forneceram o conteúdo e proteger os anunciantes contra spam.
Esses indicadores, como o ID e a versão, ajudam a ativar os casos de uso de Relatórios
e Segmentar inventário do navegador no app
que só estão disponíveis no tráfego do app.
Como funciona
A comunicação com o SDK dos anúncios para dispositivos móveis do Google só acontece em resposta a eventos de anúncios acionados por uma das seguintes opções:
O SDK adiciona gerenciadores de mensagens aoWKWebView
registrado para detectar esses eventos de anúncios. Para uma ideia melhor de como isso funciona, consulte o código-fonte da página de teste.
Pré-requisitos
- SDK dos anúncios para dispositivos móveis do Google versão 9.6.0 ou mais recente.
Atualize o arquivo
Info.plist
com o seguinte valor de chave e string. Isso ignora uma verificação que o SDK dos anúncios para dispositivos móveis do Google faz para um valorGADApplicationIdentifier
que se aplica a desenvolvedores que implementam anúncios fora de uma visualização da Web. Se você perder essa etapa e não fornecer umGADApplicationIdentifier
, o SDK dos anúncios para dispositivos móveis do Google vai gerar umaGADInvalidInitializationException
na inicialização do app.<!-- Indicate Google Mobile Ads SDK usage is only for web view APIs for ads --> <key>GADIntegrationManager</key> <string>webview</string>
Registrar a visualização da Web
Chame
register(_:)
na linha de execução principal para estabelecer uma conexão com os gerenciadores JavaScript no
código do AdSense ou na Tag do editor do Google em cada WKWebView
instância. Isso
precisa ser feito o quanto antes, por exemplo, no método
viewDidLoad
do seu controlador de visualização.
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];
}
Testar sua integração
Antes de usar seu próprio URL, recomendamos que você carregue o seguinte URL para testar a integração:
https://webview-api-for-ads-test.glitch.me#api-for-ads-tests
O URL de teste mostra barras de status verdes para uma integração bem-sucedida se as seguintes condições se aplicarem:
WKWebView
conectado ao SDK dos anúncios para dispositivos móveis do Google
Próximas etapas
- Peça consentimento no
WKWebView
. As APIs de visualização da Web para anúncios não propagam o consentimento coletado no contexto do app para dispositivos móveis usando as estruturas de conformidade com o IAB TCF v2.0 ou a CCPA do IAB para as tags nas visualizações da Web. Se você quiser implementar um único fluxo de consentimento como proprietário deWKWebView
e do conteúdo da Web correspondente que está sendo monetizado, trabalhe com sua plataforma de gestão de consentimento para coletar consentimento no contextoWKWebView
.