الإعلانات والشبكات المدعومة — iOS
عروض الإعلانات التي يجدها SDK تلقائياً
Section titled “عروض الإعلانات التي يجدها SDK تلقائياً”في كل دورة فحص، يبحث SDK في النوافذ الظاهرة من المستوى العادي للنوافذ في كل مشهد (scene) نشط، ويجد عبر وحدة
Ad80GoogleMobileAds ما يلي:
| العرض | ملاحظات |
|---|---|
إعلانات البانر من Google Mobile Ads: BannerView (ومنها بانر Ad Manager) | البانر الثابت والبانر المتكيّف. وتأتي الشبكة ومعرّف استجابة AdMob من responseInfo العام للعرض. |
الإعلانات المدمجة: NativeAdView | تأتي الشبكة ومعرّف استجابة AdMob من responseInfo الخاص بـ nativeAd في العرض. |
لا ينظر SDK داخل عروض Google ولا يغيّرها أبداً؛ بل يلتقط عرض الإعلان كله كما هو مرسوم.
ما لا يُلتقط:
- الإعلانات بملء الشاشة (البينية، وإعلانات المكافأة، والبينية بمكافأة، وإعلانات فتح التطبيق) لا يجدها SDK وحده. لا تُلتقط إلا حين يشترك تطبيقك في كل عرض منها، انظر الإعلانات بملء الشاشة (باشتراك من تطبيقك).
- العروض في نوافذ أعلى من المستوى العادي، والعروض التي ليست من عروض Google Mobile Ads: سجّلها بـ
Ad80.register. - الإعلانات المغطّاة بعرض أو نافذة أخرى، أو الخارجة جزئياً عن الشاشة، أو المحوَّلة أو المتحركة، أو في مشهد غير نشط: يُبلغ SDK عنها بـ
SKIPPED_OCCLUDEDأوSKIPPED_PARTIALLY_VISIBLEأوSKIPPED_VISIBILITY_UNVERIFIEDأوSKIPPED_NO_WINDOW_FOCUSولا يلتقطها أبداً. - مساحات الفيديو: على الجهاز الحقيقي لا تستطيع طريقة الالتقاط قراءة طبقات الفيديو المعالَجة بالعتاد. وحين تترك طبقة كهذه بكسلات شفافة في إعلان بانر أو إعلان مدمج، يُبلغ SDK عن
UNSUPPORTED_LAYER_CONTENTولا يرفع له صورة.
معرّفات أماكن العرض
Section titled “معرّفات أماكن العرض”<ViewController>/<accessibilityIdentifier>إن كان للعرض معرّف وصول (accessibility identifier)، مثلFeedViewController/banner_top؛- وإلا فـ
<ViewController>/adunit:<adUnitId>إن كان معرّف وحدة الإعلان معروفاً؛ - وإلا فـ
<ViewController>/anon:<n>.
<ViewController> هو اسم نوع أقرب view controller للعرض (وتكون القيمة app إن لم يوجد). وإن كان عرضان سيحصلان على
المعرّف نفسه، يُضاف إليهما #2 ثم #3 وهكذا. لذلك اضبط accessibilityIdentifier في عروض إعلاناتك، لتبقى أماكن العرض
ثابتة وسهلة القراءة.
الشبكات
Section titled “الشبكات”في وساطة AdMob، يقرأ SDK المحوّل (adapter) الذي عرض الإعلان فعلاً
(responseInfo.loadedAdNetworkResponseInfo)، ويحوّل اسم صنف المحوّل إلى معرّف شبكة. هذه هي المعرّفات المعروفة:
google, meta, applovin, unity, ironsource, liftoff, inmobi, mintegral, pangle, chartboost,
dt_exchange, moloco, line, maio, mytarget, imobile, bigo, bidmachine, pubmatic, verve.
والإعلانات القادمة من مصادر AdMob نفسها تُفصَّل حسب مصدر الإعلان: google لشبكة AdMob (المزايدة والتسلسل
الهرمي)، وadmob_reservation لحملات الحجز، وadmob_house للإعلانات الذاتية عبر الوساطة.
أما المحوّل غير الموجود في القائمة فيظهر بالصيغة adapter:<class name>، والإعلان الذي لا يُعرف مصدره أصلاً
يظهر unknown. والقيم الخام تُرسَل كما هي، دون أي تخمين.
الإعلانات بملء الشاشة (باشتراك من تطبيقك)
Section titled “الإعلانات بملء الشاشة (باشتراك من تطبيقك)”الإعلانات البينية، وإعلانات المكافأة، والبينية بمكافأة، وإعلانات فتح التطبيق من Google Mobile Ads تُعرض في view controller
تابع لـ Google، لا في عرض من تصميم شاشتك، ولذلك لا يجدها SDK وحده. ولا يلتقط واحداً منها إلا إن اشترك تطبيقك:
استدعِ Ad80.trackFullScreenAd قبل عرض الإعلان المحمَّل مباشرة، واستدعِ Ad80.untrackFullScreenAd إن قررت ألّا تعرضه.
import Ad80
// Right before presenting the loaded ad. placementId is optional.Ad80.trackFullScreenAd(interstitial, placementId: "Level/interstitial")interstitial.present(from: viewController)
// If you decide not to present after all:Ad80.untrackFullScreenAd(interstitial)[AD80 trackFullScreenAd:ad placementId:nil];[ad presentFromRootViewController:self];- الكائنات المقبولة:
InterstitialAd(ومنهAdManagerInterstitialAd) وRewardedAdوRewardedInterstitialAdوAppOpenAd. وأي كائن آخر يُتجاهَل. وإن لم تعطِ معرّف مكان عرض فمعرّف المكان هو<ViewController>/fullscreen:<adUnitId>. - ما تُقرّ به: باستدعائها تُقرّ بأن هذا الإعلان هو الذي سيُعرض تالياً، وبأن تطبيقك ومكتباته لا تضيف شيئاً إلى
عرض الإعلان. والاستدعاء صالح 5 ثوانٍ؛ وبعدها، أو بعد
untrackFullScreenAd، يصبح الإعلان غير مُتتبَّع. - ما يُلتقط: العرض الجذري (root view) في view controller الخاص بإعلان Google بملء الشاشة، كاملاً، ولا يُلتقط أبداً أي view controller من تطبيقك ولا بقية الشاشة. صورة واحدة لكل عرض، تُؤخذ بعد أن ينتهي انتقال الفتح.
- الإعلان بملء الشاشة غير المُتتبَّع يترك تشخيصاً ولا يترك صورة. يُبلغ SDK عنه بـ
SKIPPED_FULLSCREEN_NOT_TRACKEDولا يرفع شيئاً. أماAd80.registerفهي للعروض الموجودة في شاشتك، لا للإعلانات بملء الشاشة. - لا يعرض SDK الإعلانات ولا يُغلقها أبداً، ولا يضبط
fullScreenContentDelegate. - المفتاح: يلزم أيضاً أن يكون مفتاح التقاط الإعلانات بملء الشاشة مفعّلاً للتطبيق (انظر
الإعدادات عن بُعد). وإن كان مغلقاً يُبلغ SDK عن
SKIPPED_FULLSCREEN_DISABLED.
وإن لم يُلتقط إعلان بملء الشاشة، فالأسباب في حل المشكلات.
تسجيل العروض التي لا يجدها SDK
Section titled “تسجيل العروض التي لا يجدها SDK”استخدم Ad80.register لعروض الإعلانات التي لا يجدها SDK وحده: العروض في نوافذ أعلى من المستوى العادي، أو عروض إعلانات
من صنعك. يُلتقط العرض المسجَّل مثل العرض المكتشَف تماماً، تحت معرّف مكان العرض الذي تحدّده. وألغِ تسجيله حين يختفي.
وكلا الاستدعاءين يجريان على الخيط الرئيسي.
import Ad80
Ad80.register(adView, placementId: "Checkout/sheet_banner", metadata: provider)Ad80.unregister(adView)
// The provider is called off the main thread: make it thread-safe and never let it trap.final class Provider: Ad80MetadataProvider { func currentMetadata() -> Ad80AdMetadata? { // nil while not known yet Ad80AdMetadata(mediationPlatform: "admob", adapterClassName: "...", responseId: "...") }}[AD80 register:view placementId:@"Checkout/sheet_banner" metadata:nil];[AD80 unregister:view];حقول Ad80AdMetadata بالترتيب: mediationPlatform (مطلوب، مثل "admob")، ثم adapterClassName،
وadSourceName، وadSourceId، وadSourceInstanceName، وadSourceInstanceId، وmediationAdapterClassName،
وresponseId. كل الحقول ما عدا الأول يمكن أن تكون nil.
- أنت تُقرّ بأن العرض كله محتوى إعلاني. والتسجيل لا يتجاوز أي فحص: تبقى الموافقة والظهور وبقية الفحوص سارية.
- يجوز تمرير
nilبدل البيانات الوصفية. - يحتفظ SDK بالعرض بمرجع ضعيف (weak).
- لا يُعزل المزوّد إن فشل: يجب ألّا ينهار ولا يرمي استثناء Objective-C.
- البيانات الوصفية القادمة من مزوّد تُرسَل بمصدر المنشأ
EXPLICIT_REGISTRATION.