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

اختيار النظام الأساسي: Android‏

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

آلية العمل

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

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

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

Google Mobile Ads SDK الإصدار 9.6.0 أو إصدار أحدث.
عدِّل ملف Info.plist باستخدام المفتاح وقيمة السلسلة التاليَين. يؤدي ذلك إلى تجاوز عملية التحقّق التي تجريها Google Mobile Ads SDK من قيمة GADApplicationIdentifier التي تنطبق على المطوّرين الذين يعرضون الإعلانات خارج طريقة عرض الويب. إذا لم تنفِّذ هذه الخطوة ولم تقدّم GADApplicationIdentifier، ستعرض Google Mobile Ads SDK الخطأ GADInvalidInitializationException عند بدء تشغيل التطبيق.
```

<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

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

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

إعداد عرض الويب

تحسين سلوك النقر