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

בחירת פלטפורמה: Android (בטא) חדש Android iOS

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

איך זה עובד

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

ה-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 של בקר התצוגה.

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.
    MobileAds.shared.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];
}

בדיקת השילוב

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

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

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

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

השלבים הבאים

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