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

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

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

آلية العمل

لا يتم التواصل مع GMA Next-Gen SDK إلا استجابةً لأحداث الإعلانات التي يتم تشغيلها من خلال أي مما يلي:

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

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

تمرير رقم تعريف التطبيق إلى حزمة SDK

إذا كان لديك رقم تعريف تطبيق AdMob، عليك تهيئة GMA Next-Gen SDK باستخدام رقم تعريف التطبيق الحالي.

إذا لم يكن لديك رقم تعريف تطبيق AdMob، عليك تمرير InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID كرقم تعريف التطبيق عندما تهيئة GMA Next-Gen SDK.

Kotlin

MobileAds.initialize(
    this@MainActivity,
    // Use this application ID to initialize the GMA Next-Gen SDK if
    // you don't have an AdMob application ID.
    InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
        .build(),
  ) {
    // Adapter initialization complete.
  }

جافا

MobileAds.initialize(
    this,
    // Use this application ID to initialize the GMA Next-Gen SDK if
    // you don't have an AdMob application ID.
    new InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
        .build(),
        initializationStatus -> {
          // Adapter initialization is complete.
          });

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

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

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView
import com.google.android.libraries.ads.mobile.sdk.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.libraries.ads.mobile.sdk.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 بـ GMA Next-Gen SDK

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

  • جمع الموافقة في WebView لا تنشر واجهات برمجة التطبيقات لعرض الإعلانات في WebView الموافقة التي تم جمعها في سياق تطبيق الأجهزة الجوّالة باستخدام IAB TCF الإصدار 2.3 أو IAB CCPA إطارَي الامتثال إلى العلامات في عروض الويب. إذا كنت مهتمًا بتنفيذ مسار موافقة واحد بصفتك مالك كل من WebView ومحتوى الويب المقابل الذي يتم تحقيق الربح منه، عليك العمل مع منصة إدارة الموافقة لجمع الموافقة في سياق WebView.