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

اختيار النظام الأساسي: Android iOS Android (الإصدار القديم)

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

آلية العمل

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

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

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

تمرير معرّف التطبيق إلى حزمة تطوير البرامج (SDK)

إذا كان لديك معرّف تطبيق في "مدير إعلانات Google"، عليك إعداد GMA Next-Gen SDK باستخدام معرّف التطبيق الحالي.

إذا لم يكن لديك معرّف تطبيق في "مدير إعلانات Google"، مرِّر 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 Ad Manager 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 Ad Manager 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
التالي
تحسين سلوك النقر