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

اختبر الربط — iOS

فحص الاتصال في لوحة المتابعة

Section titled “فحص الاتصال في لوحة المتابعة”
  1. افتح التطبيقات وSDK واختر تطبيقك. بمجرد أن يصبح للتطبيق مفتاح رفع، يعرض قسم فحص الاتصال الحالة ننتظر أول رفع.
  2. ابنِ تطبيقك مع SDK وشغّله على جهاز أو محاكي (بإصدار iOS 17 أو أعلى).
  3. تأكّد أن الكود يستدعي Ad80.setConsent(true) (بعد مسار الموافقة عندك).
  4. افتح شاشة فيها إعلان، واترك الإعلان ظاهراً بالكامل لبضع ثوانٍ.
  5. تتحقّق الصفحة كل بضع ثوانٍ. وحين يصل أول رفع تعرض تصلنا الإعلانات وآخر رفع … وبعد قليل يظهر الإعلان في الإعلانات.

وحدات الإعلانات التجريبية من Google تعمل أيضاً: يلتقط SDK الإعلانات التجريبية مثل أي إعلان آخر.

لا يحدّد SDK على iOS وسماً (tag) ولا نظاماً فرعياً (subsystem) للسجلات، فلا يوجد ما تصفّيه في وحدة تحكم Xcode. استخدم مستمع التشخيص بالأسفل، فهو يبلغك بكل ما يفعله SDK.

يمكنك الاختبار على المحاكي وعلى الجهاز الحقيقي. وعلى الجهاز الحقيقي قد تتعذّر قراءة مساحات الفيديو داخل الإعلانات، انظر UNSUPPORTED_LAYER_CONTENT بالأسفل.

يُبلغك Ad80.addDiagnosticsListener بما يفعله SDK: التهيئة، واكتشاف العروض، ونتائج الالتقاط، والإضافة إلى الطابور، ونتائج الرفع. تصل الأحداث على خيط خلفي تابع لـ SDK، فاجعل معالجتك سريعة. والتشخيص للمعلومة فقط، وليس دليلاً على أن الإعلان حُفظ.

import Ad80
import 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)
الحدثالمعنى
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:)أُسقطت ملاحظات من الطابور (امتلأ الطابور أو استُنفدت المحاولات).
النتيجةالمعنى
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الالتقاط بملء الشاشة مغلق في الإعدادات عن بُعد.