دمج واجهة برمجة التطبيقات WebView API للإعلانات

من خلال واجهات WebView API للإعلانات، تصبح إشارات التطبيقات متاحة للعلامات في WKWebView، ما يساعد في تحسين تحقيق الربح للناشرين الذين قدّموا المحتوى، وحماية المعلنين من المحتوى غير المرغوب فيه. تساعد إشارات التطبيقات هذه، مثل معرّف التطبيق وإصداره، في تفعيل حالات استخدام إعداد التقارير واستهداف المساحات الإعلانية المتاحة في المتصفّحات داخل التطبيقات التي لا تتوفّر إلا في زيارات التطبيقات.

آلية العمل

لا يتم التواصل مع Google Mobile Ads SDK إلا استجابةً لأحداث الإعلانات التي يتم تشغيلها من خلال أي مما يلي:

تضيف حزمة تطوير البرامج (SDK) معالِجات الرسائل إلى WKWebView المسجَّل للاستماع إلى أحداث الإعلانات هذه. للحصول على فكرة أفضل عن طريقة عمل ذلك، يمكنك الاطّلاع على الرمز المصدر لصفحة الاختبار.

المتطلبات الأساسية

  • Google Mobile Ads SDK الإصدار 9.6.0 أو إصدار أحدث

  • عدِّل ملف Info.plist باستخدام المفتاح وقيمة السلسلة التاليَين. يؤدي ذلك إلى تجاوز عملية التحقّق التي تجريها Google Mobile Ads SDK بحثًا عن قيمة GADApplicationIdentifier تنطبق على المطوّرين الذين يعرضون الإعلانات خارج WebView. إذا تخطّيت هذه الخطوة ولم تقدّم 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>

تسجيل WebView

استدعِ register(_:) في سلسلة التعليمات الرئيسية لإنشاء اتصال بمعالِجات JavaScript في رمز AdSense أو علامة "ناشر Google" ضمن كل مثيل 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"

الخطوات التالية

السابق
إعداد عرض الويب
التالي
تحسين سلوك النقر