من خلال واجهات برمجة التطبيقات لعرض الويب للإعلانات، تصبح إشارات التطبيقات متاحة للعلامات في
WebView، ما يساعد في تحسين تحقيق الربح للناشرين الذين قدّموا المحتوى، وحماية المعلنين من المحتوى غير المرغوب فيه.
آلية العمل
لا يتم التواصل مع GMA Next-Gen SDK إلا استجابةً لأحداث الإعلانات التي يتم تشغيلها من خلال أي مما يلي:
تضيف حزمة تطوير البرامج (SDK) معالِجات الرسائل إلى WebView المسجَّل للاستماع إلى
أحداث الإعلانات هذه. للحصول على فكرة أفضل عن آلية عمل ذلك، يمكنك الاطّلاع على الرمز المصدر لصفحة الاختبار.
المتطلبات الأساسية
- الإصدار
1.0.0من GMA Next-Gen SDK أو إصدار أحدث
تمرير معرّف التطبيق إلى حزمة تطوير البرامج (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. لا تنشر واجهات برمجة التطبيقات Web view APIs for Ads الموافقة التي تم جمعها في سياق التطبيق المتوافق مع الأجهزة الجوّالة باستخدام أُطر عمل الامتثال للإصدار 2.3 من إطار الشفافية والموافقة الصادر عن مكتب IAB أو قانون خصوصية المستهلك في كاليفورنيا (CCPA) الصادر عن مكتب IAB إلى العلامات في طرق عرض الويب. إذا كنت مهتمًا بتنفيذ مسار موافقة واحد بصفتك مالكWebViewوالمحتوى المقابل على الويب الذي يتم تحقيق الربح منه، يمكنك العمل مع منصة إدارة الموافقة لجمع الموافقة في سياقWebView.