إعداد WebView

إذا كان تطبيقك يستخدم WebView لعرض محتوى الويب، ننصح بضبطه لكي يتم تحقيق الربح من المحتوى على النحو الأمثل باستخدام الإعلانات.

يوضّح لك هذا الدليل كيفية تقديم معلومات عن كيفية ضبط عنصر WebView.

تفعيل ملفات تعريف الارتباط التابعة لجهات خارجية

لتحسين تجربة المستخدم في عرض الإعلانات والالتزام بسياسة ملفات تعريف الارتباط في Chrome، عليك تفعيل ملفّات تعريف الارتباط التابعة لجهات خارجية على مثيل WebView.

Java

CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true);

Kotlin

CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)

إعدادات الويب

لم يتم تحسين الإعدادات التلقائية لنظام التشغيل WebView لعرض الإعلانات. استخدِم واجهات برمجة التطبيقات WebSettings لضبط WebView من أجل:

  • JavaScript
  • الوصول إلى مساحة التخزين المحلية

  • تشغيل الفيديو تلقائيًا

Java

import android.webkit.CookieManager;
import android.webkit.WebView;

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);
  }
}

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView

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
  }
}

تحميل محتوى العرض على الويب

إنّ ملفات تعريف الارتباط وعناوين URL للصفحات مهمّة لتحقيق الربح من عرض الويب، ولا تعمل إلا على النحو المتوقّع عند استخدام loadUrl() مع عنوان URL مستند إلى الشبكة. للحصول على أداء WebView محسّن، حمِّل محتوى الويب مباشرةً من عناوين URL المستندة إلى الشبكة. وتجنَّب استخدام WebViewAssetLoader أو تحميل مواد العرض من الجهاز أو إنشاء محتوى ويب بشكل ديناميكي.

Java

import android.webkit.CookieManager;
import android.webkit.WebView;

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);

    // Load the URL for optimized web view performance.
    webView.loadUrl("https://webview-api-for-ads-test.glitch.me");
  }
}

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView

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

    // Load the URL for optimized web view performance.
    webView.loadUrl("https://webview-api-for-ads-test.glitch.me")
  }
}

اختبار طريقة عرض الويب

أثناء تطوير التطبيق، ننصحك بتحميل عنوان URL التجريبي هذا:

https://webview-api-for-ads-test.glitch.me#webview-settings-tests

للتأكّد من أنّ هذه الإعدادات لها التأثير المطلوب في الإعلانات. يستوفي عنوان URL الاختباري معايير النجاح للدمج الكامل في حال استيفاء ما يلي:

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

  • طريقة عمل ملفات تعريف الارتباط التابعة لجهات خارجية
  • طريقة عمل ملفات تعريف الارتباط الخاصة بالطرف الأول
  • تم تفعيل JavaScript
  • مساحة تخزين DOM مفعَّلة

إعلان فيديو

  • يتم تشغيل إعلان الفيديو بشكل مضمّن ولا يتم فتحه في المشغّل المضمّن بملء الشاشة
  • يتم تشغيل إعلان الفيديو تلقائيًا بدون النقر على زر التشغيل.
  • يمكن إعادة تشغيل إعلان الفيديو.

بعد اكتمال الاختبار، استبدِل عنوان URL التجريبي بعنوان URL الذي يريد عرض الويب تحميله.

التالي
دمج WebView API للإعلانات