أداة فحص الإعلانات

أداة فحص الإعلانات هي عنصر مركّب داخل التطبيق يسمح للأجهزة المعتمَدة بإجراء تحليل في الوقت الفعلي لطلبات الإعلانات الاختبارية مباشرةً داخل تطبيق متوافق مع الأجهزة الجوّالة. يتم تضمين هذه الأداة مع الإصدار 7.68.0 أو الإصدارات الأحدث من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة، ويمكن تفعيلها بدون الحاجة إلى إجراء عمليات ترميز.

باستخدام أداة فحص الإعلانات في إصدارات حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة الأقدم من 8.5.0، يمكنك إجراء ما يلي:

• فحص وحداتك الإعلانية
• فحص المحوّلات التابعة لجهات خارجية
• التحقّق من تعبئة إعلاناتك على النحو المتوقّع
• تحديد الأخطاء والاطّلاع على التفاصيل حول كيفية حلّها
• الاطّلاع على تفاصيل التوسّط لكل شبكة إعلانات في كل طلب
• اختبار مصادر إعلانات فردية تابعة لجهات خارجية تعمل في مجال التوسّط
• التأكّد من ضبط كل وحدة إعلانية بشكل صحيح للتوسّط في العرض الإعلاني بدون انقطاع
• اختبار عمليات دمج الأحداث المخصّصة

بالنسبة إلى الإصدار 8.5.0 أو الإصدارات الأحدث من حزمة "SDK لإعلانات الأجهزة الجوّالة"، يمكنك أيضًا:

• الاطّلاع على تفاصيل عروض الأسعار لكل شبكة إعلانات في كل طلب
• الاطّلاع على تفاصيل عروض الأسعار والتوسّط للعرض الإعلاني بدون انقطاع معًا لكل شبكة إعلانية في كل طلب
• اختبار مصادر إعلانات فردية تابعة لجهات خارجية للتوسّط في عروض الأسعار أو العرض بدون انقطاع

• تأكَّد من ضبط كل وحدة إعلانية بشكلٍ صحيح لعروض الأسعار و توسّط العرض الإعلاني بدون انقطاع.

يوضّح هذا الدليل كيفية تشغيل الميزات المختلفة في أداة فحص الإعلانات واستخدامها.

المتطلبات الأساسية

لاستخدام "أداة فحص الإعلانات"، عليك إجراء ما يلي:

• أنشئ حسابًا على AdMob و اضبط إعدادات تطبيق.

• أكمِل دليل البدء.

• استخدِم الإصدار 7.68.0 أو إصدارًا أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

• إضافة جهازك كجهاز اختبار لا يتم تشغيل "أداة فحص الإعلانات" إلا على الأجهزة الاختبارية.

تشغيل "أداة فحص الإعلانات"

يمكن تشغيل "أداة فحص الإعلانات" من أي مكان في تطبيقك بالطرق التالية:

1. استخدِم الإيماءة التي تم اختيارها في واجهة مستخدم AdMob عند تسجيل جهاز اختباري.
2. استخدام واجهة برمجة التطبيقات المقدَّمة آليًا
3. استخدِم زر الإطلاق من قائمة تصحيح الأخطاء.

الإطلاق باستخدام الإيماءات

ما مِن تغييرات مطلوبة على تطبيقك لتشغيل أداة فحص الإعلانات باستخدام إيماءة، ما عليك سوى تنفيذ الإيماءة (الهزّ المزدوج أو التدوير) التي ضبطتها في AdMob لجهاز الاختبار هذا. مزيد من المعلومات

بعد ضبط إيماءة في واجهة مستخدم AdMob (والانتظار لمدة 15 دقيقة لكي تتم نشرها)، يجب أن يقدّم تطبيقك طلب إعلان لحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة للتعرّف على إعداد الإيماءة. إذا لم تعمل الإيماءة المحدّدة، جرِّب تحميل إعلان وإعادة تشغيل تطبيقك واختبار الإيماءة مرة أخرى.

الإطلاق آليًا

يمكن أيضًا تشغيل "أداة فحص الإعلانات" آليًا:

Swift

GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
  // Error will be non-nil if there was an issue and the inspector was not displayed.
}

Objective-C

[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

تعمل واجهة برمجة التطبيقات هذه مع الأجهزة الاختبارية المسجّلة آليًا أو في واجهة مستخدم AdMob.

تأكَّد من أنّ عنصر التحكّم في العرض الذي تم تمريره إلى واجهة برمجة التطبيقات هذه مرئي بالكامل على الشاشة (تمّ استدعاء viewDidAppear:). إذا كان عنصر التحكّم في العرض الذي تم تمريره في أثناء عملية عرضه، مثل عند استدعاء واجهة برمجة التطبيقات في دالّة viewDidLoad الخاصة بعنصر التحكّم في العرض، تعذّر عرض "أداة فحص الإعلانات".

عرض الوحدات الإعلانية وتحديد المشاكل وحلّها

بعد الإطلاق، تظهر شاشة "أداة فحص الإعلانات" الرئيسية التي تتضمّن قائمة بكلّ وحدات الإعلانات في واجهة مستخدم AdMob المرتبطة برقم تعريف تطبيقك على AdMob التي تتضمّن إعدادات عروض الأسعار أو التوسّط:

ننصحك بإعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة قبل استخدام أداة فحص الإعلانات.

الاطّلاع على تفاصيل العرض الإعلاني بدون انقطاع للتوسّط في وحدة إعلانية

انقر على وحدة إعلانية للاطّلاع على سجلّ طلبات حزمة تطوير البرامج (SDK)، والذي يقدّم تفاصيل عن تدفق التوسّط حتى نقطة تعبئة الإعلان (أو تدفق التوسّط الذي انتهى بدون تعبئة) لأحدث طلبات الإعلان.

يمكن توسيع كل طلب باستخدام مؤشر الإفصاح لعرض نتائج تدفق التوسط لهذا الطلب، إلى جانب أي خطأ ووقت استجابة كان ينطبق على هذا الطلب.

بالنسبة إلى مصادر الإعلانات التابعة لجهات خارجية، يتم إرسال رسائل الخطأ مباشرةً من مصدر الإعلان. وإذا كنت بحاجة إلى مزيد من المعلومات، يُرجى الرجوع إلى مصدر إعلانك التابع لجهة خارجية.

عرض تفاصيل عروض الأسعار لوحدة إعلانية

المتطلّبات الأساسية: حزمة تطوير برامج "SDK لإعلانات Google على الأجهزة الجوّالة" 8.5.0 أو إصدار أحدث

إذا كنت حديث العهد بعروض الأسعار، اطّلِع على نظرة عامة.

في سجلّ طلبات حزمة تطوير البرامج (SDK)، يمكنك الاطّلاع على مصادر الإعلانات المستندة إلى عروض الأسعار التي يتمّ استدعاؤها في طلب الإعلان. انقر على وحدة إعلانية في سجلّ طلبات حزمة تطوير البرامج (SDK) لعرض تفاصيل كل مصدر إعلان في مزاد عروض الأسعار.

يتم ترتيب نتائج عروض الأسعار من أجل تقريب العناصر التي يمكن اتّخاذ إجراء بشأنها إلى أعلى القائمة:

• في أعلى الصفحة، تظهر شبكة المواقع الإعلانية التي فازت بالمزاد.

• ننتقل تاليًا إلى شبكات الإعلانات التي تتضمّن مشاكل. يمكنك اتّباع خطوات تحديد المشاكل وحلّها.

• ثمّ هناك شبكات المواقع الإعلانية التي لم يتم عرض أي إعلانات فيها أو لم تقدِّم عروض أسعار. يشير ذلك إلى احتمال حدوث العديد من المشاكل المختلفة في مصدر الإعلان، لأنّه قد لا يقدّم عرض سعر بسبب عملية الإعداد أو عملية اتخاذ القرار. يمكنك الرجوع إلى دليل إعداد مصدر الإعلان أو التواصل مع مصدر الإعلان مباشرةً للحصول على الدعم.

• أخيرًا، في أسفل القائمة، تظهر شبكات الإعلانات التي لم تفُز بمزاد عروض الأسعار.

  

يمكن أن يضع تدفق التوسّط مصدر الإعلان الذي فاز بمزاد عروض الأسعار وفقًا لقيمة التكلفة الفعلية لكل ألف ظهور.

عند طلب مصدر إعلان في تدفق التوسّط، يمكنه عرض الإعلانات. لمعرفة المزيد من المعلومات عن آلية عمل عروض الأسعار مع العرض الإعلاني بدون انقطاع للتوسّط، يمكنك الاطّلاع على المثال 2 والمثال 3 على عروض الأسعار ومصادر الإعلانات للعرض بدون انقطاع في مجموعة توسّط.

تصحيح أخطاء الوحدة الإعلانية المتقدّم

عند تحديد المشاكل وحلّها في الوحدات الإعلانية، قد يكون من المفيد التوغّل في طلب الإعلان والاستجابة لتحديد مكان حدوث المشكلة، أو مشاركتها مع فريق دعم Google للمساعدة في تصحيح الأخطاء. انقر على رمز القائمة في أعلى سلسلة العروض الإعلانية المعروضة بدون انقطاع واختَر مشاركة طلب الإعلان وردّه لتصدير طلب الإعلان بالكامل وردّه. ويوفّر ذلك عناء الاضطرار إلى تشغيل عمليات تتبُّع الشبكات على تطبيقك.

ملاحظة: لا يمكنك تصدير استجابة الإعلان إلا بعد إضافة جهازك التجريبي في واجهة مستخدم AdMob.

بالإضافة إلى ذلك، يمكنك عرض مَعلمات عروض الأسعار التابعة لجهة خارجية التي تم فك ترميزها من خلال النقر على خيار مَعلمة عروض الأسعار التابعة لجهة خارجية في القائمة نفسها التي تتضمّن سلسلة الطلب. يوفّر هذا التقرير تفاصيل عن مَعلمات عروض الأسعار التابعة لجهات خارجية التي قد تواجه مشاكل، ما يساعدك في تصحيح أخطاء تطبيقك أو التأكّد من أنّ الشبكة تجمع إشاراتها بنجاح.

عرض المحوّلات المتاحة

انقر على علامة التبويب المحوِّلات للاطّلاع على قائمة بجميع المحوِّلات التابعة لجهات خارجية والمرتبطة بمصادر الإعلانات في إعدادات عروض الأسعار أو التوسّط في تطبيقك. بعد ذلك، وسِّع البطاقات للاطّلاع على حالات بدء التشغيل وإصدارات حزمة تطوير البرامج (SDK). يمكنك أيضًا عرض محوّلات مخصّصة للأحداث، بالإضافة إلى المحوّلات المتوافقة التابعة لجهات خارجية. تتيح الأحداث المخصّصة للناشرِين استخدام شبكات المواقع الإعلانية التي لا تتوافق مع AdMob . يمكن تمييز الأحداث المخصّصة عن المحوّلات العادية التابعة لجهات خارجية في قائمة المحوّلات من خلال أسماء الفئات الفريدة. إضافةً إلى توفير اسم الفئة ومعلومات الحالة، يعرض فاحص الإعلانات أيضًا التصنيفات المخصّصة لتلك الأحداث المخصّصة في واجهة الويب AdMob.

في حال عدم العثور على المحوّل أو تعذّر إعداده، يمكنك الاطّلاع على تحديد المشاكل التي تم العثور عليها باستخدام أداة فحص الإعلانات وحلّها للحصول على مزيد من المعلومات.

ملاحظة: عمليات التنفيذ السابقة للأحداث المخصّصة قبل الإصدار 9.0.0 من واجهة برمجة التطبيقات، وذلك لأن واجهات برمجة التطبيقات المتوقّفة عن الفئة الفرعية لا تتيح الإعداد، وتظهر في شكل تم رصد مشكلة في أداة فحص الإعلانات. إذا ظهر لك هذا التحذير في "أداة فحص الإعلانات" على الرغم من أنّ عملية دمج الحدث المخصّص تبدو ناجحة، تحقّق مما إذا كان تطبيقك يستخدم واجهات قديمة مثل GADCustomEventBanner و استبدِلها بفئة GADMediationAdapter الجديدة.

اختبار وحداتك الإعلانية

إذا كنت تريد اختبار وحدتك الإعلانية بدون الحاجة إلى الانتقال إليها في واجهة مستخدم تطبيقك، تتيح لك "أداة فحص الإعلانات" إجراء ذلك مباشرةً من شاشة تفاصيل الوحدة الإعلانية. بالإضافة إلى ذلك، يمكنك اختبار وحدات إعلانية متعدّدة في الوقت نفسه، وتحميل طلبات الإعلانات الاختبارية والاطّلاع عليها بشكل غير متزامن، وحتى إجراء اختبارات لمصدر إعلان فردي.

ملاحظة مهمة: عند إجراء أحد اختبارات "أداة فحص الإعلانات" هذه، لا تتضمن طلباتك عددًا من المَعلمات التي كانت ستتضمّنها في حال بدءها في واجهة مستخدِم تطبيقك، بما في ذلك إعدادات المعالجة الموجّهة إلى الأطفال والاستهداف المخصّص ومَعلمات إضافية للشبكة وأحجام مختلفة وغير ذلك. بسبب الطبيعة المحدودة لهذه الطلبات،ننصح بإجراء الاختبار باستخدام واجهة مستخدم تطبيقك كلما أمكن ذلك.

اختبار الإعلانات

تعتبر اختبارات الإعلانات لأداة فحص الإعلانات الموضّحة في هذا القسم أداة رائعة للتحقّق من تجربة الإعلانات الأساسية وللتحقّق من صحة إعدادات التوسّط عند استخدامها مع اختبار مصدر إعلان فردي.

عندما تكون مستعدًا لاختبار وحدتك الإعلانية، انقر على الزرّ طلب إعلان تجريبي في أعلى شاشة "أداة فحص الإعلانات" لتشغيل اختبار الإعلانات في "أداة فحص الإعلانات". تظهر نتائج الاختبار بعد ذلك في سجلّ طلبات حزمة تطوير البرامج (SDK) أسفل العنوان تم طلبه من "أداة فحص الإعلانات".

التعرّف على كيفية استخدام "أداة فحص الإعلانات" في تطبيقك

اختبار مصدر إعلان فردي

تتضمّن "أداة فحص الإعلانات" ميزة لتقييد طلبات الإعلانات في تطبيقك لعرض الإعلانات فقط من مصدر إعلان واحد للتوسّط في عروض الأسعار أو للعرض بدون انقطاع. يتيح لك ذلك التأكّد من أنّك نفّذت المحوِّل التابع لجهة خارجية بشكلٍ صحيح وأنّ مصدر الإعلان يعرِض الإعلانات على النحو المتوقّع.

لتفعيل هذه الميزة، فعِّل مفتاح التبديل اختبار مصدر إعلان فردي في أسفل الشاشة. يؤدي ذلك إلى عرض مربّع الحوار التالي لاختيار مصدر الإعلان:

عليك إعداد حزمة تطوير برامج "SDK لإعلانات Google على الأجهزة الجوّالة" قبل أن تتمكّن من اختبار مصدر إعلان واحد.

ويمكنك بعد ذلك اختيار مصدر إعلان واحد لاختباره. بعد اختيار مصدر إعلان، تظهر الشاشة التالية:

ينطبق إعداد اختبار مصدر الإعلان الفردي على أي طلبات إعلانات مستقبلية تقدّمها في الجلسة نفسها. ومع ذلك، لا ينطبق ذلك على أي إعلانات تم تخزينها مؤقتًا في جلسة سابقة ولم يتم عرضها بعد. ويُنصَح بفرض إعادة تشغيل تطبيقك عند تطبيق اختبار واحد لمصدر الإعلان لإلغاء صلاحية أي إعلانات مخزّنة مؤقتًا يمكن عرضها بدلاً من أن يتلقّى مصدر الإعلان الذي اخترته طلبًا.

بعد إعادة تشغيل تطبيقك، تحاول جميع مواضع الوحدات الإعلانية عرض إعلان من الشبكة المحدّدة فقط. عند تشغيل "أداة فحص الإعلانات" عندما يكون اختبار مصدر إعلان فردي نشطًا، يظهر مصدر الإعلان الاختباري النشط:

في وضع اختبار مصدر الإعلان الفردي، تحاول جميع طلبات الإعلان تعبئة الإعلانات باستخدام مصدر الإعلان المحدّد، بغض النظر عمّا إذا تم ضبط مصدر الإعلان لعروض الأسعار أو التوسّط للوحدة الإعلانية المطلوبة. إذا لم يكن مصدر الإعلان الذي تختبره مُدرَجًا في تدفق التوسّط لإحدى الوحدات الإعلانية، ستظهر لك رسالة خطأ "تعذُّر عرض الإعلان".

في اختبار مصدر إعلان واحد، يمكنك النقر على وحدة إعلانية لعرض سجلّ طلبات حزمة تطوير البرامج (SDK) الخاص بها. يتيح لك ذلك معرفة ما إذا كان مصدر الإعلان قد تمكّن من تعبئة طلبات الإعلان التي تم إجراؤها بعد فعالية اختبار مصدر الإعلان الفردي. إذا تعذّر على مصدر الإعلان تحميل إعلان، ستظهر رسالة خطأ توضّح الخطأ.

في حال أضفت عدّة مثيلات من مصدر الإعلان المحدّد إلى تدفق التوسّط ، سترى كل مثيل من الطلب المقدّم إلى مصدر الإعلان في تدفق الإعلانات بدون انقطاع إلى أن تتم تعبئة الإعلان أو انتهى تدفق الإعلانات بدون انقطاع من غير تعبئة إعلان.

إيقاف اختبار مصدر إعلان فردي

لإيقاف الاختبار، انقر على زر الإيقاف:

ستظهر بعد ذلك رسالة تأكيد على شاشة إعادة التشغيل التالية:

ننصحك بإعادة تشغيل تطبيقك بعد إيقاف الاختبار بهدف إبطال أي إعلانات محفوظة في ذاكرة التخزين المؤقت لمصدر الإعلان الذي تم اختباره.

نسخ نتائج تصحيح الأخطاء بالكامل

يتيح "أداة فحص الإعلانات" نسخ سلسلة JSON تحتوي على مخرجات كاملة لتحديد الأخطاء وحلّها من الأداة، بما في ذلك تفاصيل تطبيقك على AdMob، وحالات إعداد المُحوِّل، ونتائج اختبار جميع الوحدات الإعلانية.

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