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

اختيار النظام الأساسي: Android iOS Android (الإصدار القديم)

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

آلية العمل

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

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

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

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

  • عدِّل الملف 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(_:) في سلسلة التعليمات الرئيسية لإنشاء اتصال بمعالجات 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

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

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