משלבים את WebView API for Ads

ממשקי ה-API של רכיבי WebView למודעות מאפשרים לתגים ב-WKWebView לגשת לאותות מהאפליקציה. כך הם עוזרים לשפר את המוניטיזציה של בעלי האפליקציות שסיפקו את התוכן, ומגנים על המפרסמים מפני ספאם. אותות האפליקציה האלה, כמו מזהה האפליקציה וגרסת האפליקציה, עוזרים להפעיל תרחישי שימוש של דיווח ושל טירגוט מלאי שטחי פרסום בדפדפן בתוך האפליקציה, שזמינים בדרך כלל רק בתנועה שמגיעה מאפליקציות.

איך זה עובד

התקשורת עם Google Mobile Ads SDK מתרחשת רק בתגובה לאירועים שקשורים למודעות, שמופעלים על ידי כל אחד מהגורמים הבאים:

• קוד AdSense
• Google Publisher Tag
• ‫IMA ל-HTML5

ה-SDK מוסיף מטפלים בהודעות ל-WKWebView הרשום כדי להאזין לאירועי המודעות האלה. כדי להבין טוב יותר איך זה עובד, אפשר לעיין בקוד המקור של דף הבדיקה.

דרישות מוקדמות

• ‫ Google Mobile Ads SDK בגרסה 9.6.0 ואילך.

• מעדכנים את הקובץ Info.plist עם המפתח וערך המחרוזת הבאים. הפעולה הזו מדלגת על בדיקה שמתבצעת על ידי Google Mobile Ads SDK לגבי ערך GADApplicationIdentifier שרלוונטי למפתחים שמטמיעים מודעות מחוץ לתצוגת אינטרנט. אם לא מבצעים את השלב הזה ולא מציינים GADApplicationIdentifier, ‏ Google Mobile Ads SDK יציג GADInvalidInitializationException בהפעלת האפליקציה.

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

רישום תצוגת האינטרנט

צריך להפעיל את הפונקציה register(_:) בשרשור הראשי כדי ליצור חיבור עם רכיבי ה-handler של JavaScript בקוד AdSense או ב-Google Publisher Tag בכל מופע של WKWebView. מומלץ לבצע את הפעולה הזו מוקדם ככל האפשר, למשל בשיטה viewDidLoad של בקר התצוגה.

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

בדיקת השילוב

לפני שמשתמשים בכתובת URL משלכם, מומלץ לטעון את כתובת ה-URL הבאה כדי לבדוק את השילוב:

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

אם מתקיימים התנאים הבאים, כתובת ה-URL של הבדיקה מציגה סרגלי סטטוס ירוקים שמציינים שהשילוב בוצע בהצלחה:

• ‫WKWebView מחובר אל Google Mobile Ads SDK

השלבים הבאים

• קבלת הסכמה ב-WKWebView. ממשקי ה-API של תצוגות האינטרנט לצורך הצגת מודעות לא מעבירים את ההסכמה שנאספה בהקשר של האפליקציה לנייד באמצעות IAB TCF גרסה 2.0 או IAB CCPA, אל התגים בתצוגות האינטרנט. אם אתם רוצים להטמיע תהליך הסכמה יחיד כבעלים של WKWebView ושל תוכן האינטרנט התואם שמניב הכנסות, אתם צריכים לעבוד עם הפלטפורמה לניהול הסכמה כדי לקבל הסכמה בהקשר של WKWebView.