تخطَّ إلى المحتوى

الإعلانات والشبكات المدعومة — 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.
  • العروض داخل مربعات الحوار والنوافذ المنبثقة، لأنها ليست في نافذة نشاط، فلا تُكتشف تلقائياً. سجّلها بنفسك.
  • أي عرض آخر، ما لم تسجّله.

يحصل كل عرض إعلان على معرّف مكان العرض (placement id)، ويظهر في لوحة المتابعة باسم مكان العرض:

  • <Activity>/<viewIdName> إن كان للعرض معرّف، مثل MainActivity/banner_top؛
  • وإلا فـ <Activity>/adunit:<adUnitId> لإعلانات البانر؛
  • وإلا فـ <Activity>/anon:<n>.

إن كان عرضان في نشاط واحد سيحصلان على المعرّف نفسه، يُضاف إليهما #2 ثم #3 وهكذا. لذلك أعطِ عروض إعلاناتك معرّفات، لتبقى أماكن العرض ثابتة وسهلة القراءة.

في وساطة 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)
  • ما الكائنات المقبولة: 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.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") {
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)

حقول Ad80AdMetadata بالترتيب: mediationPlatform (مطلوب، مثل "admob")، ثم adapterClassName، وadSourceName، وadSourceId، وadSourceInstanceName، وadSourceInstanceId، وmediationAdapterClassName، وresponseId. كل الحقول ما عدا الأول يمكن أن تكون null.

  • في عرض BaseAdView مسجَّل (أي بانر)، تتقدّم بيانات ResponseInfo الخاصة بالعرض على ما يعطيه المزوّد الذي كتبته.
  • معرّف مكان العرض الفارغ يُتجاهَل.
  • لا يُقبل تسجيل عرض يملأ النافذة كلها: فالدالة Ad80.register لا ترفع صورة بملء الشاشة أبداً. وللإعلانات بملء الشاشة استخدم Ad80.trackFullScreenAd (انظر أعلاه).
  • البيانات الوصفية القادمة من مزوّد تُرسَل بمصدر المنشأ EXPLICIT_REGISTRATION.