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

ממשקי ה-API של תצוגת האינטרנט למודעות מאפשרים לסימנים מהאפליקציה להיות זמינים לתגים ב-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(_:)‏בשרשור הראשי כדי ליצור חיבור למטפלי JavaScript בקוד AdSense או ב-Google Publisher Tag בכל WKWebView מכונה. כדאי לעשות זאת מוקדם ככל האפשר, למשל בשיטה viewDidLoad של ה-view controller.

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)
  }
}

@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://webview-api-for-ads-test.glitch.me#api-for-ads-tests

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

• WKWebView מחוברת ל-Google Mobile Ads SDK

השלבים הבאים

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