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

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

آلية العمل

لا يتم التواصل مع Google Mobile Ads SDK (Legacy) إلا استجابةً لأحداث الإعلانات التي يتم تشغيلها من خلال أي مما يلي:

• رمز AdSense
• علامة الناشر من Google
• ‫IMA لتنسيق HTML5

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

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

• Google Mobile Ads SDK (Legacy) الإصدار 20.6.0 أو إصدار أحدث

• المستوى 21 من واجهة برمجة تطبيقات Android أو مستوى أحدث

• أضِف علامة <meta-data> التالية في ملف AndroidManifest.xml لتخطّي التحقّق من APPLICATION_ID. إذا فاتتك هذه الخطوة ولم تقدّم علامة <meta-data>، ستعرض Google Mobile Ads SDK (Legacy) الخطأ IllegalStateException عند بدء تشغيل التطبيق.

  <!-- Bypass APPLICATION_ID check for web view APIs for ads -->
   <meta-data
       android:name="com.google.android.gms.ads.INTEGRATION_MANAGER"
       android:value="webview"/>
  

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

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

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

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://google.github.io/webview-ads/test/#api-for-ads-tests

يعرض عنوان URL للاختبار أشرطة حالة خضراء لعملية تكامل ناجحة إذا استوفيت الشروط التالية:

• WebView متصل بـ Google Mobile Ads SDK (Legacy)

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

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