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

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

آلية العمل

لا يتم التواصل مع حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" إلا استجابةً لأحداث الإعلانات التي يتم تشغيلها من خلال أيّ مما يلي:

• رمز AdSense
• علامة الناشر من Google
• إعلانات الوسائط التفاعلية بتنسيق HTML5

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

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

• الإصدار 9.6.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة

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

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

• جمع الموافقات في WKWebView لا تنقل واجهات برمجة التطبيقات الخاصة بعرض الإعلانات على الويب الموافقة التي تم جمعها في سياق التطبيق المتوافق مع الأجهزة الجوّالة باستخدام إطارَي التوافق الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB أو قانون خصوصية المستهلك في كاليفورنيا الصادر عن مكتب IAB إلى العلامات في عروض الويب. إذا كنت مهتمًا بتنفيذ مسار موافقة واحد بصفتك مالكًا لكلّ من WKWebView ومحتوى الويب المرتبط به والذي يتم تحقيق الربح منه، عليك العمل مع منصّة إدارة الموافقة لجمع الموافقة في سياق WKWebView.