SDK لنظام iOS
يعمل AD80 SDK داخل تطبيق iOS. يجد الإعلانات الظاهرة على الشاشة، ويرفع صورة لكل إعلان رآه مستخدموك، ومعها شبكة الإعلانات التي عرضته. لا تحتاج أن تستدعيه لعرض الإعلانات أو تتبّعها، فهو يراقب عروض الإعلانات الموجودة أصلاً في تطبيقك.
ما يفعله SDK وحده
Section titled “ما يفعله SDK وحده”- يبدأ حين تستدعيه. لا يوجد بدء تلقائي: يستدعي تطبيقك
Ad80.start(integrations:)مرة واحدة منapplication(_:didFinishLaunchingWithOptions:)قبل ظهور أول عرض إعلان. - ينتظر الموافقة. لا يلتقط شيئاً ولا يرسل شيئاً حتى يستدعي تطبيقك
Ad80.setConsent(true). - يجد عروض الإعلانات في المشاهد (scenes) التي في المقدمة: إعلانات البانر من Google Mobile Ads (
BannerView، ومنها بانر Ad Manager) وعروض الإعلانات المدمجة (NativeAdView). راجع الإعلانات والشبكات المدعومة. - لا يلتقط الإعلان إلا وهو ظاهر بالكامل: غير مغطّى، وغير محوَّل، وفي مشهد نشط. وينسخ بكسلات عرض الإعلان نفسه فقط، ولا ينسخ الشاشة كلها أبداً.
- يقرأ الشبكة التي عرضت الإعلان من
responseInfoالعام للإعلان (وساطة AdMob)، ومعها معرّف استجابة AdMob. - يرفع كل صورة إعلان مختلفة مرة واحدة لكل شبكة كل 24 ساعة. أما مرات الظهور اللاحقة فتصل كسجلات بيانات وصفية صغيرة.
- يحفظ ما لم يُرسَل في طابور ويعيد المحاولة حين تنقطع الشبكة، ضمن طابور صغير محدود الحجم على الجهاز.
- يلتزم بالإعدادات القادمة من AD80، فيستطيع AD80 إيقاف الالتقاط أو الرفع في تطبيقك مؤقتاً دون تحديث التطبيق.
- لا يلتقط الإعلانات بملء الشاشة إلا إذا اشتركت أنت في ذلك، باستدعاء واحد قبل عرض الإعلان مباشرة
(
Ad80.trackFullScreenAd). راجع الإعلانات بملء الشاشة.
ولا يحمّل SDK إعلانات، ولا يسجّل مرات الظهور، ولا يستبدل مفوّضات (delegates) الإعلانات عندك ولا يغلّفها، ولا يغيّر عرض الإعلان. ويستخدم ربط Google Mobile Ads واجهة Google العامة المكتوبة بأنواعها فقط. والفحص الوحيد الذي يعتمد على الاسم هو اسم الفئة (class) الخاصة بـ view controller للإعلان بملء الشاشة عند Google (راجع الإعلانات بملء الشاشة).
المتطلبات
Section titled “المتطلبات”| المتطلب | القيمة |
|---|---|
| iOS | الإصدار 17 أو أحدث. جرّبناه على محاكيات iOS 18.2 وiOS 26.x وعلى iPhone بنظام iOS 26.2، ولم نجرّب iOS 17.x. |
| Xcode | الإصدار 27.2 أو أحدث للحزمة المترجمة الحالية. راجع README المرفق لمعرفة أقل إصدار تدعمه حزمتك. ابنِ التطبيق وشغّله على Mac. |
| طريقة التسليم | حزمة SDK المترجمة التي يرسلها لك AD80: ملفات XCFramework وحزمة Swift محلية. راجع ثبّت SDK. |
| Google Mobile Ads SDK | الإصدار 13.11.0 بالضبط، يُضاف عبر Swift Package Manager. وبدونه استخدم Ad80.start(): يُبلغ SDK عن adMobUnavailable ولا يراقب إلا العروض التي تسجّلها أنت بنفسك. |
| Info.plist | المفتاحان AD80PublisherKey وAD80Endpoint. |
| خطة AD80 | Starter أو Enterprise. على الخطة المجانية يُرفض الرفع ويبقى SDK خاملاً. |