تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

آلية العمل

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

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

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

حزمة SDK لإعلانات Google على الأجهزة الجوّالة الإصدار 20.6.0 أو إصدار أحدث
المستوى 21 من واجهة برمجة التطبيقات لنظام التشغيل Android أو إصدار أحدث
أضِف علامة <meta-data> التالية في ملف AndroidManifest.xml لتخطّي عملية التحقّق من APPLICATION_ID. إذا فاتتك هذه الخطوة ولم يتم تقديم علامة <meta-data>، ستُرسِل حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" IllegalStateException عند بدء التطبيق.
```

 <meta-data
     android:name="com.google.android.gms.ads.INTEGRATION_MANAGER"
     android:value="webview"/>
```

تسجيل 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)
  }
}

Java

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://webview-api-for-ads-test.glitch.me#api-for-ads-tests

يعرِض عنوان URL التجريبي أشرطة حالة خضراء للدلالة على عملية دمج ناجحة في حال انطباق الشروط التالية:

WebView متّصل بحزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

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

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

إعداد WebView

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