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

تعمل واجهات برمجة التطبيقات WebView للإعلانات على توفير إشارات التطبيق للعلامات في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>

تسجيل عرض الويب

طلب 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 على الأجهزة الجوّالة"

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

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