اختبر الربط — iOS
فحص الاتصال في لوحة المتابعة
Section titled “فحص الاتصال في لوحة المتابعة”- افتح التطبيقات وSDK واختر تطبيقك. بمجرد أن يصبح للتطبيق مفتاح رفع، يعرض قسم فحص الاتصال الحالة ننتظر أول رفع.
- ابنِ تطبيقك مع SDK وشغّله على جهاز أو محاكي (بإصدار iOS 17 أو أعلى).
- تأكّد أن الكود يستدعي
Ad80.setConsent(true)(بعد مسار الموافقة عندك). - افتح شاشة فيها إعلان، واترك الإعلان ظاهراً بالكامل لبضع ثوانٍ.
- تتحقّق الصفحة كل بضع ثوانٍ. وحين يصل أول رفع تعرض تصلنا الإعلانات وآخر رفع … وبعد قليل يظهر الإعلان في الإعلانات.
وحدات الإعلانات التجريبية من Google تعمل أيضاً: يلتقط SDK الإعلانات التجريبية مثل أي إعلان آخر.
سجلات التصحيح
Section titled “سجلات التصحيح”لا يحدّد SDK على iOS وسماً (tag) ولا نظاماً فرعياً (subsystem) للسجلات، فلا يوجد ما تصفّيه في وحدة تحكم Xcode. استخدم مستمع التشخيص بالأسفل، فهو يبلغك بكل ما يفعله SDK.
يمكنك الاختبار على المحاكي وعلى الجهاز الحقيقي. وعلى الجهاز الحقيقي قد تتعذّر قراءة مساحات الفيديو داخل الإعلانات،
انظر UNSUPPORTED_LAYER_CONTENT بالأسفل.
مستمع التشخيص
Section titled “مستمع التشخيص”يُبلغك Ad80.addDiagnosticsListener بما يفعله SDK: التهيئة، واكتشاف العروض، ونتائج الالتقاط، والإضافة إلى
الطابور، ونتائج الرفع. تصل الأحداث على خيط خلفي تابع لـ SDK، فاجعل معالجتك سريعة. والتشخيص للمعلومة فقط، وليس
دليلاً على أن الإعلان حُفظ.
import Ad80import Ad80Core
final class Ad80Log: Ad80DiagnosticsListener { // Called serially on an SDK queue, never on the main thread. Return quickly. func onEvent(_ event: Ad80Event) { switch event { case .configInvalid(let reason): print("AD80 config invalid: \(reason)") case .disabled(let reason): print("AD80 disabled: \(reason)") case .capture(let placementId, let outcome): print("AD80 capture \(placementId): \(outcome.rawValue)") case .uploadResult(_, _, let httpStatus, let willRetry): print("AD80 upload HTTP \(httpStatus.map(String.init) ?? "none"), retry=\(willRetry)") default: print("AD80 \(event)") } }}
let ad80Log = Ad80Log()Ad80.addDiagnosticsListener(ad80Log) // the SDK holds the listener strongly until you remove it// Later, for example when a debug screen goes away:Ad80.removeDiagnosticsListener(ad80Log)الأحداث
Section titled “الأحداث”| الحدث | المعنى |
|---|---|
initialized | بدأ SDK العمل. |
configInvalid(reason:) | إدخالات Info.plist ناقصة أو خاطئة (missing publisher key، missing endpoint، malformed endpoint، cleartext endpoint must be loopback، unsupported endpoint scheme). ويبقى SDK خاملاً. |
adMobUnavailable | استُدعيت Ad80.start بلا ربط Google Mobile Ads، فلا تُراقب إلا العروض المسجّلة. ويُبلَّغ عنه مرة واحدة لكل عملية. |
disabled(reason:) | LOCAL (عبر setEnabled(false))، أو REMOTE (الإعدادات عن بُعد)، أو INFO_PLIST (المفتاح AD80Enabled يساوي false)، أو CONSENT_REVOKED. |
discovered(placementId:source:) | وُجد عرض إعلان، أو سُجّل، أو تُتُبِّع كإعلان بملء الشاشة (قيمة source هي ADMOB_DISCOVERED أو EXPLICIT أو FULLSCREEN_TRACKED). |
discoveryTruncated(nodesVisited:) | شجرة عروض كبيرة جداً لم يُبحث فيها إلا جزئياً. |
placementRemoved(placementId:) | اختفى عرض إعلان. |
capture(placementId:outcome:) | نتيجة محاولة التقاط واحدة (انظر بالأسفل). |
observationQueued(...) | أُضيفت ملاحظة إلى الطابور، ومعها مكان العرض، وبصمة المحتوى، ومعرّف الشبكة، وسبب الإرسال، وهل تحمل الصورة. |
uploadResult(batchId:attempt:httpStatus:willRetry:) | نتيجة محاولة رفع. وتكون httpStatus تساوي nil بعد خطأ في الشبكة. |
queueDropped(count:) | أُسقطت ملاحظات من الطابور (امتلأ الطابور أو استُنفدت المحاولات). |
نتائج الالتقاط
Section titled “نتائج الالتقاط”| النتيجة | المعنى |
|---|---|
CAPTURED | التُقط الإعلان. |
SKIPPED_NO_CONSENT، SKIPPED_DISABLED، SKIPPED_BACKGROUND | لا توجد موافقة، أو SDK معطّل، أو التطبيق في الخلفية. |
SKIPPED_NOT_VISIBLE، SKIPPED_PARTIALLY_VISIBLE، SKIPPED_OCCLUDED | الإعلان مخفي، أو مقصوص، أو مغطّى بعرض أو نافذة أخرى. |
SKIPPED_NO_WINDOW_FOCUS | مشهد العرض ليس في الحالة foregroundActive (مبدّل التطبيقات، أو مركز الإشعارات، أو إشعار مكالمة واردة). وتُعاد المحاولة حين يصبح المشهد نشطاً. |
SKIPPED_VISIBILITY_UNVERIFIED | تحويل (transform)، أو طبقة مرفوعة، أو حركة، أو أبعاد غير مستقرة: لم يستطع SDK إثبات أن الإعلان ظاهر. |
SKIPPED_NOT_LAID_OUT | حدود فارغة، أو بكسلات بلون واحد أو شفافة: لم يُرسَم الإعلان بعد. |
SKIPPED_UNCHANGED، SKIPPED_RATE_LIMITED | لا جديد للالتقاط (الإعلان نفسه خلال 24 ساعة)، أو أن الالتقاط يُبطَّأ. |
ATTRIBUTION_PENDING | انتظار قصير لمعرفة الشبكة. |
DISCARDED_GEOMETRY_CHANGED | تحرّك العرض أو تغيّر مقاسه أثناء الالتقاط؛ وهذا طبيعي أثناء التمرير. |
SKIPPED_NOT_SETTLED | في البانر والإعلان المدمج: لا يوجد إطار مستقر بعد. وفي الإعلان بملء الشاشة: انتهى العرض قبل أن تتوفر صورة صالحة. |
FAILED_CAPTURE | لم تُرجع أداة الرسم صورة. أبلغنا بها مع نوع الجهاز وإصدار iOS. |
UNSUPPORTED_LAYER_CONTENT | في الالتقاط محتوى لا تستطيع الطريقة قراءته، ويظهر بكسلات شفافة (الفيديو على الجهاز الحقيقي). ولا تُرفع صورة. |
UNSUPPORTED_SECURE_CONTENT | محجوزة؛ لا يُصدرها الإصدار 1.0.0 من SDK. |
REJECTED_TOO_LARGE، REJECTED_SIZE_MISMATCH | الصورة أكبر من الحد المسموح، أو يختلف مقاسها عن مقاس العرض. |
SKIPPED_FULLSCREEN_NOT_TRACKED | عُرض إعلان Google بملء الشاشة دون استدعاء مطابق لـ Ad80.trackFullScreenAd. تشخيص فقط، ولا صورة أبداً. |
SKIPPED_FULLSCREEN_AMBIGUOUS | تعذّر ربط العرض المُتتبَّع بإعلان واحد بالضبط (إعلانان مُتتبَّعان أو معروضان في الوقت نفسه). لا صورة. |
SKIPPED_FULLSCREEN_DISABLED | الالتقاط بملء الشاشة مغلق في الإعدادات عن بُعد. |