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

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

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

آلية العمل

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

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

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

الإصدار 20.6.0 أو الإصدارات الأحدث من حزمة SDK لإعلانات Google على الأجهزة الجوّالة
المستوى 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

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