حل المشكلات — Android
ابدأ من سجلات التصحيح ومستمع التشخيص، فهي غالباً تخبرك بالسبب مباشرة.
فحص الاتصال لا يتجاوز انتظار أول رفع
Section titled “فحص الاتصال لا يتجاوز انتظار أول رفع”يبقى فحص الاتصال على ننتظر أول رفع ولا يتغيّر. هذه أكثر الأسباب شيوعاً:
| السبب | الحل |
|---|---|
dev.ad80.ENDPOINT غير موجود (ConfigInvalid: missing endpoint). | أضف <meta-data android:name="dev.ad80.ENDPOINT" android:value="https://api.ad80.dev" />. |
مفتاح الرفع غير موجود أو فيه خطأ كتابي (ConfigInvalid: missing publisher key، أو الرد 401 على الرفع). | انسخ المفتاح من جديد من المكان الذي حفظته فيه. وإن ضاع، أنشئ مفتاح رفع جديداً وأبطِل القديم. |
| لم تُمنح الموافقة قط. | استدعِ Ad80.setConsent(true) في كل تشغيل، بعد مسار الموافقة عندك. |
| SDK معطّل. | راجع dev.ad80.ENABLED، وأي استدعاء لـ Ad80.setEnabled(false)، وأحداث التشخيص Disabled(...). |
| مؤسستك على الخطة المجانية. | الإعدادات عن بُعد تُبقي SDK خاملاً، والرفع مرفوض. راجع الخطط. |
معرّف التطبيق في هذا البناء يختلف عن التطبيق المسجّل في لوحة المتابعة (مثلاً بسبب اللاحقة .debug). | الرفع لمعرّف تطبيق آخر يُرفض بالرمز 403. سجّل هذا المعرّف كتطبيق مستقل واستخدم مفتاحه. |
| أُلغي المفتاح. | أنشئ مفتاحاً جديداً وانشره مع التطبيق. |
| الجهاز يعمل بـ Android 7.x (API 24 أو 25). | الالتقاط يحتاج API 26 أو أعلى. |
| الإعلان لا يظهر بالكامل أبداً (يغطّيه عرض آخر، أو جزء منه خارج الشاشة، أو داخل مربع حوار، أو متحرّك أو محوَّل). | راجع نتائج Capture. وسجّل إعلانات البانر في مربعات الحوار والنوافذ المنبثقة عبر Ad80.register. |
| App Startup معطّل في تطبيقك. | استدعِ Ad80.initialize(context) في Application.onCreate(). |
الرفع مرفوض
Section titled “الرفع مرفوض”يُسقط SDK الدفعة التي تتلقّى خطأ من جهة العميل، ويواصل إعادة المحاولة عند أخطاء الخادم. وهذا معنى رموز
الحالة في UploadResult:
| الحالة | المعنى |
|---|---|
| 200 | قُبل الرفع. |
| 400 | الدفعة بصيغة خاطئة. تأكّد أنك تستخدم نسخة SDK دون أي تعديل. |
| 401 | مفتاح رفع غير معروف، أو ملغى، أو منتهي الصلاحية. |
| 403 | الخطة لا تشمل المراقبة عبر SDK، أو معرّف التطبيق في البناء لا يطابق المفتاح. |
| 413 | الطلب كبير جداً. |
| 429, 503 | الخادم مشغول، وسيعيد SDK المحاولة لاحقاً. |
الإعلانات تظهر لكن الشبكة “unknown”
Section titled “الإعلانات تظهر لكن الشبكة “unknown””تظهر الإعلانات المدمجة بالقيمة unknown ما لم تسجّل NativeAdView مع بياناته الوصفية. أما في إعلانات البانر
فتأتي الشبكة من ResponseInfo الخاص بالإعلان، وإن لم يكن محوّل الوساطة ضمن القائمة المعروفة فيظهر بالصيغة
adapter:<class name>. راجع قسم الشبكات في الإعلانات والشبكات المدعومة.
الإعلانات تظهر دون فحص لأن الرصيد الشهري نفد
Section titled “الإعلانات تظهر دون فحص لأن الرصيد الشهري نفد”إن ظهرت الإعلانات بحالة لم يُفحص: نفد الرصيد الشهري، فقد نفد الرصيد الشهري لمرات الظهور المراقَبة في خطتك. ما زال الرفع مقبولاً ويُحتسب، لكن مرات الظهور الجديدة لا تُفحص حتى الفترة التالية. راجع الخطة.
إعلان يظهر مرة واحدة مع أنه يُعرض طوال اليوم
Section titled “إعلان يظهر مرة واحدة مع أنه يُعرض طوال اليوم”هذا مقصود: كل صورة تُرفع مرة واحدة لكل شبكة كل 24 ساعة، ومرات الظهور اللاحقة في مكان العرض نفسه تُرسل مرة واحدة على الأكثر كل 24 ساعة.
إعلان بملء الشاشة لم يُلتقط
Section titled “إعلان بملء الشاشة لم يُلتقط”الإعلانات البينية وإعلانات المكافأة وإعلانات فتح التطبيق لا تُلتقط إلا في العروض التي يتتبّعها تطبيقك. ابحث عن نتيجة
Capture الخاصة بالعرض في التشخيص:
| النتيجة أو العَرَض | السبب والحل |
|---|---|
SKIPPED_FULLSCREEN_NOT_TRACKED | لم يستدعِ التطبيق Ad80.trackFullScreenAd(ad) قبل show، أو استدعاها قبل فتح الإعلان بأكثر من 5 ثوانٍ. استدعها قبل ad.show(activity) مباشرة في كل عرض. |
SKIPPED_FULLSCREEN_DISABLED | الالتقاط بملء الشاشة مغلق: إما مفتاح التقاط الإعلانات بملء الشاشة للتطبيق في لوحة المتابعة، وإما أن الالتقاط أو SDK موقوف لهذا التطبيق (مثل الخطة المجانية، أو نفاد الرصيد). يستطيع المالك أو أحد المشرفين تفعيله، ويأخذ التطبيق بالتغيير حين يجلب إعداداته في المرة القادمة. |
SKIPPED_FULLSCREEN_AMBIGUOUS | تُتُبِّع إعلان آخر والأول معلّق، أو كان نشاطا إعلان مفتوحين معاً. تتبّع إعلاناً واحداً واعرضه، ولا تتبّع إلا الإعلان الذي تعرضه. |
REJECTED_UNVERIFIED_AD_WINDOW, SKIPPED_NOT_SETTLED | نافذة الإعلان من Google لم تجتز الفحوص (تعدد النوافذ، أو صورة داخل صورة، أو شجرة عروض غير متوقعة)، أو أُغلق الإعلان قبل أن يستقر تحريك الفتح. |
لا يوجد حدث Capture أصلاً | الكائن ليس InterstitialAd ولا RewardedAd ولا RewardedInterstitialAd ولا AppOpenAd (فيُتجاهَل)، أو لا توجد موافقة، أو SDK معطّل. والنتيجة UNSUPPORTED_API_LEVEL تعني API 24 أو 25. |
| الصورة فيها شيء من تطبيقك | تطبيقك أو إحدى مكتباته يرسم داخل نشاط الإعلان من Google. لا يفرّق SDK بينه وبين الإعلان، فأزله قبل أن تتتبّع الإعلان. |
ما زالت المشكلة قائمة؟
Section titled “ما زالت المشكلة قائمة؟”راسلنا على contact@ad80.dev، واذكر معرّف التطبيق، وأحداث التشخيص من SDK حول وقت المشكلة، ووقت حدوثها. ولا ترسل أبداً مفتاح الرفع أو مفتاح API كاملاً، فبادئة المفتاح تكفي.