SDK لنظام Android
يعمل AD80 SDK داخل تطبيق Android. يجد الإعلانات الظاهرة على الشاشة، ويرفع صورة لكل إعلان رآه مستخدموك، ومعها شبكة الإعلانات التي عرضته. لا تحتاج أن تستدعيه لعرض الإعلانات أو تتبّعها، فهو يراقب عروض الإعلانات الموجودة أصلاً في تطبيقك.
ما يفعله SDK وحده
Section titled “ما يفعله SDK وحده”- يبدأ تلقائياً عبر AndroidX App Startup عند تشغيل تطبيقك، ويجري أعمال البدء خارج الخيط الرئيسي.
- ينتظر الموافقة. لا يلتقط شيئاً ولا يرسل شيئاً حتى يستدعي تطبيقك
Ad80.setConsent(true). - يجد عروض الإعلانات في أنشطة تطبيقك: إعلانات البانر من AdMob وAd Manager (
AdViewوAdManagerAdView) وعروض الإعلانات المدمجة (NativeAdView). راجع الإعلانات والشبكات المدعومة. - لا يلتقط الإعلان إلا وهو ظاهر بالكامل: غير مغطّى، وغير محوَّل، وفي نافذة عليها التركيز. وينسخ بكسلات عرض الإعلان نفسه فقط، ولا ينسخ الشاشة كلها أبداً.
- يقرأ الشبكة التي عرضت الإعلان من
ResponseInfoالعام للإعلان (وساطة AdMob)، ومعها معرّف استجابة AdMob. - يرفع كل صورة إعلان مختلفة مرة واحدة لكل شبكة كل 24 ساعة. أما مرات الظهور اللاحقة فتصل كسجلات بيانات وصفية صغيرة.
- يحفظ ما لم يُرسَل في طابور ويعيد المحاولة حين تنقطع الشبكة، ضمن طابور صغير محدود الحجم على الجهاز.
- يلتزم بالإعدادات القادمة من AD80، فيستطيع AD80 إيقاف الالتقاط أو الرفع في تطبيقك مؤقتاً دون تحديث التطبيق.
ولا يستبدل SDK أبداً مستمع الإعلانات عندك، ولا مستمع أحداث الدفع، ولا مستمع شجرة العروض. ولا يغيّر طلب الإعلان ولا عرض الإعلان، ولا يستخدم الانعكاس (reflection) للوصول إلى داخل Google Mobile Ads.
المتطلبات
Section titled “المتطلبات”| المتطلب | القيمة |
|---|---|
Android minSdk | 24. الالتقاط يحتاج API 26 أو أعلى. على API 24 و25 يعمل SDK لكنه لا يلتقط شيئاً، ويُبلغ عن UNSUPPORTED_API_LEVEL. |
compileSdk | 24 أو أعلى. |
| Kotlin | الإصدار 2.1 أو أحدث إن كان تطبيقك يستخدم Kotlin. ويعمل SDK من Java أيضاً. |
| Google Mobile Ads SDK | اختياري. جرّبنا SDK مع com.google.android.gms:play-services-ads بالإصدار 25.5.0. وبدونه يبدأ SDK، ويُبلغ عن AdMobUnavailable، ولا يراقب إلا العروض التي تسجّلها أنت بنفسك. |
| الأذونات | INTERNET، ويُضاف تلقائياً من ملف manifest الخاص بـ SDK. |
| خطة AD80 | Starter أو Enterprise. على الخطة المجانية يُرفض الرفع ويبقى SDK خاملاً. |