اختبر الربط — Android
فحص الاتصال في لوحة المتابعة
Section titled “فحص الاتصال في لوحة المتابعة”- افتح التطبيقات وSDK واختر تطبيقك. بمجرد أن يصبح للتطبيق مفتاح رفع، يعرض قسم فحص الاتصال الحالة ننتظر أول رفع.
- ابنِ تطبيقك مع SDK وشغّله على جهاز أو محاكي (بإصدار Android API 26 أو أعلى).
- تأكّد أن الكود يستدعي
Ad80.setConsent(true)(بعد مسار الموافقة عندك). - افتح شاشة فيها إعلان، واترك الإعلان ظاهراً بالكامل لبضع ثوانٍ.
- تتحقّق الصفحة كل بضع ثوانٍ. وحين يصل أول رفع تعرض تصلنا الإعلانات وآخر رفع … وبعد قليل يظهر الإعلان في الإعلانات.
وحدات الإعلانات التجريبية من Google تعمل أيضاً: يلتقط SDK الإعلانات التجريبية مثل أي إعلان آخر.
سجلات التصحيح
Section titled “سجلات التصحيح”قبل تشغيل التطبيق، فعّل السجلات التفصيلية لـ SDK، ثم اعرض فقط ما يحمل الوسم AD80:
adb shell setprop log.tag.AD80 DEBUGadb logcat -s AD80مستمع التشخيص
Section titled “مستمع التشخيص”يُبلغك Ad80.addDiagnosticsListener بما يفعله SDK: التهيئة، واكتشاف العروض، ونتائج الالتقاط، والإضافة إلى
الطابور، ونتائج الرفع. تصل الأحداث على خيط خلفي تابع لـ SDK، فاجعل معالجتك سريعة. والتشخيص للمعلومة فقط، وليس
دليلاً على أن الإعلان حُفظ.
import android.util.Logimport dev.ad80.core.Ad80DiagnosticsListenerimport dev.ad80.core.Ad80Eventimport 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)import android.util.Log;import dev.ad80.core.Ad80DiagnosticsListener;import dev.ad80.core.Ad80Event;import dev.ad80.sdk.Ad80;
Ad80DiagnosticsListener ad80Log = event -> { if (event instanceof Ad80Event.ConfigInvalid) { Log.w("MyApp", "AD80 config invalid: " + ((Ad80Event.ConfigInvalid) event).getReason()); } else if (event instanceof Ad80Event.UploadResult) { Ad80Event.UploadResult r = (Ad80Event.UploadResult) event; Log.d("MyApp", "AD80 upload HTTP " + r.getHttpStatus() + ", retry=" + r.getWillRetry()); } else { Log.v("MyApp", "AD80 " + event); }};
Ad80.addDiagnosticsListener(ad80Log);// Later:Ad80.removeDiagnosticsListener(ad80Log);الأحداث
Section titled “الأحداث”| الحدث | المعنى |
|---|---|
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) | أُسقطت ملاحظات من الطابور (امتلأ الطابور أو استُنفدت المحاولات). |
نتائج الالتقاط
Section titled “نتائج الالتقاط”| النتيجة | المعنى |
|---|---|
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_LEVEL | API 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 | الالتقاط بملء الشاشة مغلق في الإعدادات عن بُعد. |