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

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

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

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

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

قبل تشغيل التطبيق، فعّل السجلات التفصيلية لـ SDK، ثم اعرض فقط ما يحمل الوسم AD80:

Terminal window
adb shell setprop log.tag.AD80 DEBUG
adb logcat -s AD80

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

import android.util.Log
import dev.ad80.core.Ad80DiagnosticsListener
import dev.ad80.core.Ad80Event
import dev.ad80.sdk.Ad80
val ad80Log = Ad80DiagnosticsListener { event ->
when (event) {
is Ad80Event.ConfigInvalid -> Log.w("MyApp", "AD80 config invalid: ${event.reason}")
is Ad80Event.Disabled -> Log.i("MyApp", "AD80 disabled: ${event.reason}")
is Ad80Event.Capture -> Log.d("MyApp", "AD80 capture ${event.placementId}: ${event.outcome}")
is Ad80Event.UploadResult -> Log.d("MyApp", "AD80 upload HTTP ${event.httpStatus}, retry=${event.willRetry}")
else -> Log.v("MyApp", "AD80 $event")
}
}
Ad80.addDiagnosticsListener(ad80Log)
// Later, for example in a debug screen's onDestroy:
Ad80.removeDiagnosticsListener(ad80Log)
الحدثالمعنى
Initializedبدأ SDK العمل.
ConfigInvalid(reason)إدخالات ملف manifest ناقصة أو خاطئة (missing publisher key، missing endpoint، malformed endpoint، cleartext endpoint must be loopback، unsupported endpoint scheme). ويبقى SDK خاملاً.
AdMobUnavailableحزمة Google Mobile Ads غير موجودة في التطبيق، فلا تُراقب إلا العروض المسجّلة.
Disabled(reason)LOCAL (عبر setEnabled(false))، أو REMOTE (الإعدادات عن بُعد)، أو MANIFEST (dev.ad80.ENABLED=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)نتيجة محاولة رفع.
QueueDropped(count)أُسقطت ملاحظات من الطابور (امتلأ الطابور أو استُنفدت المحاولات).
النتيجةالمعنى
CAPTUREDالتُقط الإعلان.
SKIPPED_NO_CONSENT, SKIPPED_DISABLED, SKIPPED_BACKGROUNDلا توجد موافقة، أو SDK معطّل، أو التطبيق في الخلفية.
SKIPPED_NOT_VISIBLE, SKIPPED_PARTIALLY_VISIBLE, SKIPPED_OCCLUDED, SKIPPED_NO_WINDOW_FOCUS, SKIPPED_VISIBILITY_UNVERIFIED, SKIPPED_NOT_LAID_OUTلم يكن الإعلان ظاهراً بالكامل بشكل يمكن التحقق منه.
SKIPPED_UNCHANGED, SKIPPED_RATE_LIMITEDلا جديد يستحق الالتقاط، أو أن الالتقاط مُبطَّأ مؤقتاً.
ATTRIBUTION_PENDINGانتظار قصير حتى تُعرف الشبكة.
DISCARDED_GEOMETRY_CHANGEDتحرّك العرض أو تغيّر أثناء النسخ، وسيُلتقط من جديد.
FAILED_PIXEL_COPYلم يستطع النظام نسخ البكسلات.
UNSUPPORTED_API_LEVELAPI 24 أو 25.
UNSUPPORTED_SECURE_WINDOWعلى النافذة FLAG_SECURE.
UNSUPPORTED_SURFACE_VIEWمحتوى سطح (surface) تعذّر التقاطه.
REJECTED_TOO_LARGE, REJECTED_SIZE_MISMATCHالصورة كبيرة جداً (وفي العرض المسجَّل: كانت ستملأ النافذة كلها)، أو لم تطابق العرض.
REJECTED_UNVERIFIED_AD_WINDOWبملء الشاشة: نافذة الإعلان من Google لم تجتز الفحوص في أي لقطة من العرض (مثلاً في تعدد النوافذ أو صورة داخل صورة)، فلا توجد صورة.
SKIPPED_NOT_SETTLEDبملء الشاشة: انتهى العرض قبل أن تتوفر صورة صالحة.
SKIPPED_FULLSCREEN_NOT_TRACKEDفُتح نشاط إعلان من Google دون استدعاء مطابق لـ Ad80.trackFullScreenAd. تشخيص فقط، ولا صورة أبداً.
SKIPPED_FULLSCREEN_AMBIGUOUSتعذّر ربط العرض المُتتبَّع بنشاط إعلان واحد بالضبط (تُتُبِّع إعلان آخر والأول معلّق، أو كان نشاطا إعلان مفتوحين معاً). لا توجد صورة.
SKIPPED_FULLSCREEN_DISABLEDالالتقاط بملء الشاشة مغلق في الإعدادات عن بُعد.