الإعلانات والشبكات المدعومة — Android
عروض الإعلانات التي يجدها SDK تلقائياً
Section titled “عروض الإعلانات التي يجدها SDK تلقائياً”يبحث SDK في نوافذ الأنشطة النشطة (resumed) في تطبيقك، ويجد ما يلي:
| العرض | ملاحظات |
|---|---|
إعلانات البانر من AdMob: AdView (أي BaseAdView) | البانر الثابت والبانر المتكيّف. وتأتي الشبكة ومعرّف استجابة AdMob من ResponseInfo العام للعرض. |
إعلانات البانر من Ad Manager: AdManagerAdView | هو أيضاً BaseAdView، ويُعامَل مثل بانر AdMob. |
الإعلانات المدمجة: NativeAdView | يُلتقط بعد ربط الإعلان المدمج بالعرض (أي حين يكون محتوى الوسائط موجوداً والعنوان غير فارغ). لا يستطيع SDK الوصول إلى NativeAd من خلال العرض، لذا تظهر الشبكة unknown ما لم تسجّل العرض مع بياناته الوصفية (انظر بالأسفل). |
ويُلتقط أيضاً محتوى الإعلان المرسوم داخل WebView أو SurfaceView أو TextureView ضمن هذه العروض.
ما لا يُلتقط:
- الإعلانات بملء الشاشة (البينية، وإعلانات المكافأة، وإعلانات فتح التطبيق) لا يجدها SDK وحده. لا تُلتقط إلا حين يشترك تطبيقك في كل عرض منها، انظر الإعلانات بملء الشاشة (باشتراك من تطبيقك).
- الإعلانات في نافذة عليها
FLAG_SECURE: يُبلغ SDK عنها بـUNSUPPORTED_SECURE_WINDOWولا يلتقطها أبداً. - الأجهزة على API 24 و25: تُبلغ عنها بـ
UNSUPPORTED_API_LEVEL. - العروض داخل مربعات الحوار والنوافذ المنبثقة، لأنها ليست في نافذة نشاط، فلا تُكتشف تلقائياً. سجّلها بنفسك.
- أي عرض آخر، ما لم تسجّله.
معرّفات أماكن العرض
Section titled “معرّفات أماكن العرض”يحصل كل عرض إعلان على معرّف مكان العرض (placement id)، ويظهر في لوحة المتابعة باسم مكان العرض:
<Activity>/<viewIdName>إن كان للعرض معرّف، مثلMainActivity/banner_top؛- وإلا فـ
<Activity>/adunit:<adUnitId>لإعلانات البانر؛ - وإلا فـ
<Activity>/anon:<n>.
إن كان عرضان في نشاط واحد سيحصلان على المعرّف نفسه، يُضاف إليهما #2 ثم #3 وهكذا. لذلك أعطِ عروض
إعلاناتك معرّفات، لتبقى أماكن العرض ثابتة وسهلة القراءة.
الشبكات
Section titled “الشبكات”في وساطة AdMob، يقرأ SDK المحوّل (adapter) الذي عرض الإعلان فعلاً
(ResponseInfo.getLoadedAdapterResponseInfo())، ويحوّله إلى معرّف شبكة. هذه هي المعرّفات المعروفة:
google, meta, applovin, unity, ironsource, liftoff, inmobi, mintegral, pangle, chartboost,
dt_exchange, moloco, line, maio, mytarget, imobile, bigo, bidmachine, pubmatic, snap, verve.
والإعلانات القادمة من مصادر AdMob نفسها تُفصَّل حسب مصدر الإعلان: google لشبكة AdMob (المزايدة والتسلسل
الهرمي)، وadmob_reservation لحملات الحجز، وadmob_house للإعلانات الذاتية عبر الوساطة.
أما المحوّل غير الموجود في القائمة فيظهر بالصيغة adapter:<class name>، والإعلان الذي لا يُعرف مصدره أصلاً
يظهر unknown. والقيم الخام (صنف المحوّل، واسم مصدر الإعلان ومعرّفه، واسم النسخة ومعرّفها) تُرسَل كما هي،
دون أي تخمين.
الإعلانات بملء الشاشة (باشتراك من تطبيقك)
Section titled “الإعلانات بملء الشاشة (باشتراك من تطبيقك)”الإعلانات البينية، وإعلانات المكافأة، والبينية بمكافأة، وإعلانات فتح التطبيق من Google Mobile Ads تُفتح في نافذة
Google الخاصة بالإعلان، لا في عرض من تصميم شاشتك، ولذلك لا يجدها SDK وحده. ومنذ الإصدار 0.3.0 من SDK على Android
يلتقط واحداً منها فقط إن اشترك تطبيقك: استدعِ Ad80.trackFullScreenAd قبل show مباشرة، واستدعِ
Ad80.untrackFullScreenAd إن فشل العرض.
import dev.ad80.sdk.Ad80
// Right before the show. The second argument (a placement id) is optional.Ad80.trackFullScreenAd(interstitialAd, "Level/interstitial")interstitialAd.show(activity)
// If the ad fails to show (for example in onAdFailedToShowFullScreenContent):Ad80.untrackFullScreenAd(interstitialAd)import dev.ad80.sdk.Ad80;
// Right before the show. The second argument (a placement id) is optional.Ad80.trackFullScreenAd(interstitialAd, "Level/interstitial");interstitialAd.show(activity);
// If the ad fails to show (for example in onAdFailedToShowFullScreenContent):Ad80.untrackFullScreenAd(interstitialAd);- ما الكائنات المقبولة:
InterstitialAd(ومنهاAdManagerInterstitialAd)، وRewardedAd، وRewardedInterstitialAd، وAppOpenAd. وأي كائن آخر يُتجاهَل. وإن لم تعطِ معرّف مكان عرض فمكان العرض هو<Activity>/fullscreen:<adUnitId>. - ما الذي تقرّره باستدعائها: أنت تؤكد أن نشاط الإعلان التالي من Google (
com.google.android.gms.ads.AdActivity) يعرض هذا الإعلان، وأن تطبيقك ومكتباته لا يرسمون شيئاً داخل هذا النشاط. وصلاحية الاستدعاء 5 ثوانٍ؛ بعدها، أو بعدuntrackFullScreenAd، يعود الإعلان غير مُتتبَّع. - ما الذي يُلتقط: نافذة الإعلان من Google وحدها، ولا يُلتقط أي نشاط من تطبيقك ولا مربع حوار ولا نافذة أخرى ولا الشاشة. صورة واحدة لكل عرض، تُؤخذ بعد أن يستقر تحريك الفتح. ويلزم API 26 أو أعلى.
- الإعلان بملء الشاشة غير المُتتبَّع يترك تشخيصاً ولا يترك صورة. يُبلغ SDK عنه بـ
SKIPPED_FULLSCREEN_NOT_TRACKEDولا يرفع شيئاً. أماAd80.registerفلا ترفع صورة بملء الشاشة أبداً. - المفتاح: يلزم أيضاً أن يكون مفتاح التقاط الإعلانات بملء الشاشة مفعّلاً للتطبيق (انظر
الإعدادات عن بُعد). وإن كان مغلقاً يُبلغ SDK عن
SKIPPED_FULLSCREEN_DISABLED.
وإن لم يُلتقط إعلان بملء الشاشة، فالأسباب في حل المشكلات.
تسجيل العروض التي لا يجدها SDK
Section titled “تسجيل العروض التي لا يجدها SDK”استخدم Ad80.register لإعلانات البانر داخل مربعات الحوار أو النوافذ المنبثقة، أو للإعلانات المدمجة التي تعرف
شبكتها، أو لعروض إعلانات من صنعك. يُلتقط العرض المسجَّل مثل العرض المكتشَف تماماً، تحت معرّف مكان العرض الذي
تحدّده. وألغِ تسجيله حين يختفي.
import dev.ad80.sdk.Ad80import dev.ad80.sdk.Ad80AdMetadata
// A banner in a dialog: its ResponseInfo is read automatically.Ad80.register(dialogBanner, "Checkout/dialog_banner")
// A native ad: pass what you know about it. The provider is called off the main thread.Ad80.register(nativeAdView, "Feed/native_1") { val info = nativeAd?.responseInfo ?: return@register null // null while not known yet val loaded = info.loadedAdapterResponseInfo Ad80AdMetadata( mediationPlatform = "admob", adapterClassName = loaded?.adapterClassName, adSourceName = loaded?.adSourceName, adSourceId = loaded?.adSourceId, adSourceInstanceName = loaded?.adSourceInstanceName, adSourceInstanceId = loaded?.adSourceInstanceId, mediationAdapterClassName = info.mediationAdapterClassName, responseId = info.responseId, )}
// When the view goes away:Ad80.unregister(nativeAdView)import com.google.android.gms.ads.AdapterResponseInfo;import com.google.android.gms.ads.ResponseInfo;import com.google.android.gms.ads.nativead.NativeAd;import dev.ad80.sdk.Ad80;import dev.ad80.sdk.Ad80AdMetadata;
// A banner in a dialog: its ResponseInfo is read automatically.Ad80.register(dialogBanner, "Checkout/dialog_banner");
// A native ad: pass what you know about it. The provider is called off the main thread.Ad80.register(nativeAdView, "Feed/native_1", () -> { NativeAd ad = currentNativeAd; // your field if (ad == null || ad.getResponseInfo() == null) return null; // null while not known yet ResponseInfo info = ad.getResponseInfo(); AdapterResponseInfo loaded = info.getLoadedAdapterResponseInfo(); return new Ad80AdMetadata( "admob", loaded != null ? loaded.getAdapterClassName() : null, loaded != null ? loaded.getAdSourceName() : null, loaded != null ? loaded.getAdSourceId() : null, loaded != null ? loaded.getAdSourceInstanceName() : null, loaded != null ? loaded.getAdSourceInstanceId() : null, info.getMediationAdapterClassName(), info.getResponseId());});
// When the view goes away:Ad80.unregister(nativeAdView);حقول Ad80AdMetadata بالترتيب: mediationPlatform (مطلوب، مثل "admob")، ثم adapterClassName،
وadSourceName، وadSourceId، وadSourceInstanceName، وadSourceInstanceId، وmediationAdapterClassName،
وresponseId. كل الحقول ما عدا الأول يمكن أن تكون null.
- في عرض
BaseAdViewمسجَّل (أي بانر)، تتقدّم بياناتResponseInfoالخاصة بالعرض على ما يعطيه المزوّد الذي كتبته. - معرّف مكان العرض الفارغ يُتجاهَل.
- لا يُقبل تسجيل عرض يملأ النافذة كلها: فالدالة
Ad80.registerلا ترفع صورة بملء الشاشة أبداً. وللإعلانات بملء الشاشة استخدمAd80.trackFullScreenAd(انظر أعلاه). - البيانات الوصفية القادمة من مزوّد تُرسَل بمصدر المنشأ
EXPLICIT_REGISTRATION.