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

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

آلية العمل

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

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

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

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

  • عدِّل ملف 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>

تسجيل 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.
    GADMobileAds.sharedInstance().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://webview-api-for-ads-test.glitch.me#api-for-ads-tests

يعرِض عنوان URL التجريبي أشرطة حالة خضراء للدلالة على عملية دمج ناجحة في حال انطباق الشروط التالية:

  • WKWebView متّصل بحزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

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

السابق
البدء
التالي
تحسين سلوك النقر