إعداد WebView

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

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

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

ملاحظة مهمة: لإعداد WebView وتحسينه بشكلٍ صحيح، عليك تطبيق جميع التوصيات التالية على كل مثيل WebView في تطبيقك. للمساعدة في تحديد كل عرض ويب، فعِّل العلامة "highlight-all-webviews" في "أدوات مطوّري البرامج في WebView" لتمييز عروض الويب في تطبيقك بلون أصفر فاتح.

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

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

جافا

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

Kotlin

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

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

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

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

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

جافا

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 أو تحميل مواد العرض من الجهاز أو إنشاء محتوى الويب ديناميكيًا.

جافا

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://google.github.io/webview-ads/test/");
  }
}

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://google.github.io/webview-ads/test/")
  }
}

ملاحظة: إذا كنت بحاجة إلى تحميل محتوى عرض الويب من وسائل أخرى، مثل HTML، يمكنك الحدّ من التأثير السلبي على تحقيق الربح من خلال إرسال المعرّف الذي يقدّمه الناشر (PPID) وعنوان URL ذي الصلة بالصفحة (GPT | AdSense) مع طلب عرض الويب. تحدّ هذه التغييرات من خسارة تحقيق الربح مقارنةً بتحميل محتوى الويب من عنوان URL مستند إلى الشبكة.

اختبار عرض الويب

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

https://google.github.io/webview-ads/test/

للتحقّق من أنّ هذه الإعدادات لها التأثير المقصود على الإعلانات. يحتوي عنوان URL التجريبي على معايير نجاح لعملية دمج كاملة إذا تمّت ملاحظة ما يلي:

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

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

• تعمل ملفات تعريف الارتباط الخاصة بالطرف الأول
• تم تفعيل JavaScript

• تم تفعيل مساحة التخزين في DOM

إعلان فيديو

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

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