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

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

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

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

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

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

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

  • استخدِم الإصدار 1.3.0 أو إصدارًا أحدث من المكوّن الإضافي Flutter لإعلانات الأجهزة الجوّالة.

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

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

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

الإطلاق باستخدام قائمة تصحيح الأخطاء

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

إذا لم تربط جهازك، قد يُطلب منك تسجيل الدخول إلى حسابك على "مدير إعلانات Google".

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

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

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

MobileAds.instance.openAdInspector(
  (AdInspectorError? error) {
    // Error will be non-null if ad inspector closed due to an error.
  });

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Android
iOS

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

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

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

Android
iOS

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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