Reklamlar için WebView API'yi entegre etme

Reklamlar için web görünümü API'leri, uygulama sinyallerini WKWebView'nizdeki etiketler için kullanılabilir hâle getirerek içeriği sağlayan yayıncıların para kazanma oranını artırmaya ve reklamverenleri spam'den korumaya yardımcı olur. Uygulama kimliği ve uygulama sürümü gibi bu uygulama sinyalleri, aksi takdirde yalnızca uygulama trafiğinde kullanılabilen raporlama ve uygulama içi tarayıcı envanterini hedefleme kullanım alanlarının etkinleştirilmesine yardımcı olur.

İşleyiş şekli

Google Mobile Ads SDK'sı ile iletişim yalnızca aşağıdakilerden herhangi biri tarafından tetiklenen reklam etkinliklerine yanıt olarak gerçekleşir:

• AdSense kodu
• Google Yayıncı Etiketi
• HTML5 için IMA

SDK, bu reklam etkinliklerini dinlemek için kayıtlı WKWebView öğesine ileti işleyiciler ekler. Bu özelliğin nasıl çalıştığını daha iyi anlamak için test sayfasının kaynak kodunu inceleyin.

Ön koşullar

• Google Mobile Ads SDK'sı 9.6.0 veya daha sonraki bir sürüm.

• Info.plist dosyasını aşağıdaki anahtar ve dize değeriyle güncelleyin. Bu, Google Mobile Ads SDK'sının bir web görünümü dışında reklam uygulayan geliştiriciler için geçerli olan bir GADApplicationIdentifier değeri için yaptığı kontrolü atlar. Bu adımı atlarsanız ve bir GADApplicationIdentifier sağlamazsanız Google Mobile Ads SDK uygulama başlatıldığında bir GADInvalidInitializationException oluşturur.

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

Web görünümünü kaydetme

Her WKWebView örneğinde AdSense kodundaki veya Google yayıncı etiketindeki JavaScript işleyicileriyle bağlantı kurmak için ana iş parçacığında register(_:) çağrısı yapın. Bu işlem, mümkün olduğunca erken yapılmalıdır. Örneğin, görünüm denetleyicinizin viewDidLoad yönteminde yapılabilir.

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

Entegrasyonunuzu test etme

Kendi URL'nizi kullanmadan önce entegrasyonu test etmek için aşağıdaki URL'yi yüklemenizi öneririz:

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

Aşağıdaki koşullar geçerliyse test URL'si, başarılı bir entegrasyon için yeşil durum çubukları gösterir:

• WKWebView Google Mobile Ads SDK'sına bağlı

Sonraki adımlar

• WKWebView'da izin alın. Reklamlar için Web Görünümü API'leri, mobil uygulama bağlamında IAB TCF 2.0 veya IAB CCPA uygunluk çerçeveleri kullanılarak toplanan kullanıcı rızasını web görünümlerinizdeki etiketlere yaymaz. Hem WKWebView hem de para kazanılan ilgili web içeriğinin sahibi olarak tek bir izin akışı uygulamak istiyorsanız WKWebView bağlamında izin almak için Kullanıcı Rızası Yönetim Platformunuzla birlikte çalışın.