تعمل واجهات برمجة التطبيقات WebView للإعلانات على توفير إشارات التطبيق للعلامات فيWebView
، ما يساعد في زيادة إمكانية تحقيق الربح للناشرين الذين قدّموا المحتوى وحماية المعلنين من المحتوى غير المرغوب فيه.
آلية العمل
لا يحدث الاتصال بحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة إلا استجابةً لأحداث الإعلانات التي يتم تشغيلها بواسطة أيٍّ مما يلي:
تُضيف حزمة تطوير البرامج (SDK) معالِجات الرسائل إلىWebView
مسجّلة لرصد أحداث الإعلانات هذه. للحصول على فكرة أفضل عن آلية عمل ذلك، اطّلِع على رمز المصدر الخاص بالصفحة التجريبية.
المتطلبات الأساسية
- حزمة SDK الخاصة بإعلانات Google على الأجهزة الجوّالة أو إصدار أحدث 20.6.0
المستوى 21 من واجهة برمجة تطبيقات Android أو أعلى
أضِف علامة
<meta-data>
التالية في ملفAndroidManifest.xml
لتجاوز عملية التحقّق منAPPLICATION_ID
. إذا فاتتك هذه الخطوة ولم تقدِّم العلامة<meta-data>
، ستطرح حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" علامة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
.
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);
}
}
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)
// Enable third-party cookies.
CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)
// Enable JavaScript in the WebView.
webView.settings.javaScriptEnabled = true
// Enable DOM storage in the WebView.
webView.settings.domStorageEnabled = true
// Enable videos to play automatically.
webView.settings.mediaPlaybackRequiresUserGesture = 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 أو قانون خصوصية المستهلك في كاليفورنيا (CCPA) الصادر عن مكتب الإعلانات التفاعلية (IAB) إلى العلامات في ملفاتك الشخصية للويب. إذا كنت مهتمًا بتنفيذ عملية موافقة واحدة بصفتك مالكWebView
ومحتوى الويب المقابل له الذي يتم تحقيق الربح منه، يمكنك التعاون مع منصة إدارة الموافقة التي تتعامل معها من أجل جمع الموافقات فيWebView
السياق.