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

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

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

آلية العمل

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

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

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

  • Google Mobile Ads SDK الإصدار 20.6.0 أو أحدث.

  • المستوى 21 أو أحدث من واجهة برمجة تطبيقات Android

  • أضِف علامة <meta-data> التالية في ملف AndroidManifest.xml لتخطّي التحقّق من APPLICATION_ID. إذا لم تنفّذ هذه الخطوة ولم تقدّم علامة <meta-data>، ستعرض Google Mobile Ads SDK الخطأ IllegalStateException عند بدء تشغيل التطبيق.

    <!-- Bypass APPLICATION_ID check for web view APIs for ads -->
 <meta-data
     android:name="com.google.android.gms.ads.INTEGRATION_MANAGER"
     android:value="webview"/>

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

استخدِم الدالة registerWebView() في سلسلة التعليمات الرئيسية لإنشاء اتصال بمعالِجات JavaScript في رمز AdSense أو "علامة ناشر Google" ضمن كل مثيل من WebView. يجب تنفيذ هذه الخطوة في أقرب وقت ممكن، مثلاً في طريقة onCreate() في MainActivity.

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView
import com.google.android.gms.ads.MobileAds

class MainActivity : AppCompatActivity() {
  lateinit var webView: WebView

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    webView = findViewById(R.id.webview)

    // Let the web view accept third-party cookies.
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)
    // Let the web view use JavaScript.
    webView.settings.javaScriptEnabled = true
    // Let the web view access local storage.
    webView.settings.domStorageEnabled = true
    // Let HTML videos play automatically.
    webView.settings.mediaPlaybackRequiresUserGesture = false

    // Register the web view.
    MobileAds.registerWebView(webView)
  }
}

جافا

import android.webkit.CookieManager;
import android.webkit.WebView;
import com.google.android.gms.ads.MobileAds;

public class MainActivity extends AppCompatActivity {
  private WebView webView;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    webView = findViewById(R.id.webview);

    // Let the web view accept third-party cookies.
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true);
    // Let the web view use JavaScript.
    webView.getSettings().setJavaScriptEnabled(true);
    // Let the web view access local storage.
    webView.getSettings().setDomStorageEnabled(true);
    // Let HTML videos play automatically.
    webView.getSettings().setMediaPlaybackRequiresUserGesture(false);

    // Register the web view.
    MobileAds.registerWebView(webView);
  }
}

اختبار عملية التكامل

ننصحك بتحميل عنوان URL التالي لاختبار عملية التكامل قبل استخدام عنوان URL الخاص بك:

https://google.github.io/webview-ads/test/#api-for-ads-tests

يعرِض عنوان URL التجريبي أشرطة حالة خضراء لعملية تكامل ناجحة إذا استوفيت الشروط التالية:

  • تم ربط WebView بـ Google Mobile Ads SDK

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

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