حل المشكلات — iOS
ابدأ من سجلات التصحيح ومستمع التشخيص، فهي غالباً تخبرك بالسبب مباشرة.
فحص الاتصال لا يتجاوز انتظار أول رفع
Section titled “فحص الاتصال لا يتجاوز انتظار أول رفع”يبقى فحص الاتصال على ننتظر أول رفع ولا يتغيّر. هذه أكثر الأسباب شيوعاً:
| السبب | الحل |
|---|---|
المفتاح AD80Endpoint غير موجود أو فارغ (configInvalid: missing endpoint). | أضف المفتاح AD80Endpoint إلى Info.plist بالقيمة https://api.ad80.dev. |
مفتاح الرفع غير موجود أو فيه خطأ كتابي (configInvalid: missing publisher key، أو الرد 401 على الرفع). | انسخ المفتاح من جديد من المكان الذي حفظته فيه. وإن ضاع، أنشئ مفتاح رفع جديداً وأبطِل القديم. |
قيم Info.plist تأتي من إعدادات بناء (build settings) غير مضبوطة (مثلاً $(AD80_PUBLISHER_KEY) لا تُحَلّ إلى قيمة). | اضبط إعدادات البناء لإعداد البناء (build configuration) الذي تشغّله. |
لا يُستدعى Ad80.start أبداً (لا أحداث من AD80 أصلاً). | استدعِه أولاً في application(_:didFinishLaunchingWithOptions:) قبل ظهور أول عرض إعلان. |
بدأ SDK دون ربط Google Mobile Ads (adMobUnavailable). | استخدم Ad80.start(integrations: [Ad80GoogleMobileAds.integration])، أو [AD80GoogleMobileAds startAD80] في Objective-C. |
لم تُمنح الموافقة قط (SKIPPED_NO_CONSENT). | استدعِ Ad80.setConsent(true) في كل تشغيل، بعد مسار الموافقة عندك. |
| SDK معطّل. | راجع AD80Enabled في Info.plist، وأي استدعاء لـ Ad80.setEnabled(false)، وأحداث التشخيص disabled(...). |
| مؤسستك على الخطة المجانية. | الإعدادات عن بُعد تُبقي SDK خاملاً، والرفع مرفوض. راجع الخطط. |
| معرّف الحزمة (bundle identifier) في هذا البناء يختلف عن التطبيق المسجّل في لوحة المتابعة (مثلاً معرّف مختلف لكل إعداد بناء). | الرفع لمعرّف تطبيق آخر يُرفض بالرمز 403. سجّل هذا المعرّف كتطبيق مستقل واستخدم مفتاحه. وما يجوز أن يحتويه معرّف التطبيق مذكور في التطبيقات والمفاتيح؛ ومعرّف الحزمة الذي فيه شرطة (-) غير مقبول حالياً. |
| أُلغي المفتاح. | أنشئ مفتاحاً جديداً وانشره مع التطبيق. |
| الإعلان لا يظهر بالكامل أبداً (يغطّيه عرض أو نافذة أخرى، أو جزء منه خارج الشاشة، أو في نافذة أعلى من المستوى العادي، أو متحرّك أو محوَّل، أو مشهده غير نشط). | راجع نتائج capture. وسجّل العروض التي لا يجدها SDK عبر Ad80.register. |
تختبر بإعلان مدمج تجريبي وترى SKIPPED_OCCLUDED. | ما زالت لوحة التحقق من Google على الإعلانات المدمجة التجريبية تُحسب عرضاً يغطي الإعلان في الإصدار 1.0.0 من SDK. راجع الإعلانات والشبكات المدعومة. |
الرفع مرفوض
Section titled “الرفع مرفوض”يُسقط SDK الدفعة التي تتلقّى خطأ من جهة العميل، ويواصل إعادة المحاولة عند أخطاء الخادم. وهذا معنى رموز
الحالة في UploadResult:
| الحالة | المعنى |
|---|---|
| 200 | قُبل الرفع. |
| 400 | الدفعة بصيغة خاطئة. تأكّد أنك تستخدم نسخة SDK دون أي تعديل. |
| 401 | مفتاح رفع غير معروف، أو ملغى، أو منتهي الصلاحية. |
| 403 | الخطة لا تشمل المراقبة عبر SDK، أو معرّف التطبيق في البناء لا يطابق المفتاح. |
| 413 | الطلب كبير جداً. |
| 429, 503 | الخادم مشغول، وسيعيد SDK المحاولة لاحقاً. |
الإعلانات تظهر لكن الشبكة “unknown”
Section titled “الإعلانات تظهر لكن الشبكة “unknown””في إعلانات البانر تأتي الشبكة من responseInfo الخاص بالإعلان، وفي الإعلانات المدمجة من responseInfo الخاص بـ nativeAd
في العرض. وإن لم يكن محوّل الوساطة ضمن القائمة المعروفة فيظهر بالصيغة adapter:<class name>؛ والإعلان الذي ليس في
responseInfo الخاص به محوّل محمَّل بعد يظهر unknown. راجع قسم الشبكات في الإعلانات والشبكات المدعومة.
الإعلانات تظهر دون فحص لأن الرصيد الشهري نفد
Section titled “الإعلانات تظهر دون فحص لأن الرصيد الشهري نفد”إن ظهرت الإعلانات بحالة لم يُفحص: نفد الرصيد الشهري، فقد نفد الرصيد الشهري لمرات الظهور المراقَبة في خطتك. ما زال الرفع مقبولاً ويُحتسب، لكن مرات الظهور الجديدة لا تُفحص حتى الفترة التالية. راجع الخطة.
إعلان يظهر مرة واحدة مع أنه يُعرض طوال اليوم
Section titled “إعلان يظهر مرة واحدة مع أنه يُعرض طوال اليوم”هذا مقصود: كل صورة تُرفع مرة واحدة لكل شبكة كل 24 ساعة، ومرات الظهور اللاحقة في مكان العرض نفسه تُرسل مرة واحدة على الأكثر كل 24 ساعة.
إعلان بملء الشاشة لم يُلتقط
Section titled “إعلان بملء الشاشة لم يُلتقط”الإعلانات البينية وإعلانات المكافأة وإعلانات فتح التطبيق لا تُلتقط إلا في العروض التي يتتبّعها تطبيقك. ابحث عن نتيجة
Capture الخاصة بالعرض في التشخيص:
| النتيجة أو العَرَض | السبب والحل |
|---|---|
SKIPPED_FULLSCREEN_NOT_TRACKED | لم يستدعِ التطبيق Ad80.trackFullScreenAd(ad) قبل عرض الإعلان، أو استدعاها قبل فتح الإعلان بأكثر من 5 ثوانٍ. استدعها قبل ad.present(from:) مباشرة في كل عرض. |
SKIPPED_FULLSCREEN_DISABLED | الالتقاط بملء الشاشة مغلق: إما مفتاح التقاط الإعلانات بملء الشاشة للتطبيق في لوحة المتابعة، وإما أن الالتقاط أو SDK موقوف لهذا التطبيق (مثل الخطة المجانية، أو نفاد الرصيد). يستطيع المالك أو أحد المشرفين تفعيله، ويأخذ التطبيق بالتغيير حين يجلب إعداداته في المرة القادمة. |
SKIPPED_FULLSCREEN_AMBIGUOUS | تُتُبِّع إعلانان أو عُرضا معاً. تتبّع إعلاناً واحداً واعرضه، ثم الذي بعده. |
SKIPPED_NOT_SETTLED | أُغلق الإعلان قبل أن ينتهي انتقال الفتح، ولم تتوفر صورة صالحة. |
لا يوجد حدث capture أصلاً | الكائن ليس InterstitialAd ولا RewardedAd ولا RewardedInterstitialAd ولا AppOpenAd (فيُتجاهَل)، أو لا توجد موافقة، أو SDK معطّل. وهناك احتمال آخر: يتعرّف SDK على view controller الخاص بإعلان Google بملء الشاشة من اسم صنفه GADFullScreenAdViewController، وأي إصدار من Google Mobile Ads يستخدم صنفاً آخر لا يُلتقط. |
| مساحة الفيديو في الصورة سوداء | حدّ معروف: قد تظهر مساحات الفيديو في الإعلانات بملء الشاشة سوداء على iPhone الحقيقي. |
| الصورة فيها شيء من تطبيقك | تطبيقك أو إحدى مكتباته يضيف محتوى إلى عرض إعلان Google أو يرسم فوق الإعلان. لا يفرّق SDK بينه وبين الإعلان، فأزله قبل أن تتتبّع الإعلان. |
ما زالت المشكلة قائمة؟
Section titled “ما زالت المشكلة قائمة؟”راسلنا على contact@ad80.dev، واذكر معرّف التطبيق، وأحداث التشخيص من SDK حول وقت المشكلة، ووقت حدوثها. ولا ترسل أبداً مفتاح الرفع أو مفتاح API كاملاً، فبادئة المفتاح تكفي.