وباستخدام "أداة فحص الإعلانات"، يمكنك إجراء ما يلي:
- فحص وحداتك الإعلانية
- التحقّق من تعبئة إعلاناتك على النحو المتوقّع
- تحديد الأخطاء والاطّلاع على التفاصيل حول كيفية حلّها
- عرض تفاصيل كل شبكة إعلانات "عرض أسعار مفتوح" لكل طلب
- عرض تفاصيل التوسّط لكل شبكة إعلانات لكل طلب
- اختبار مصادر إعلانات فردية تابعة لجهات خارجية لعرض الأسعار المفتوح أو توسّط العرض الإعلاني بدون انقطاع
- التحقّق من ضبط كلّ وحدة إعلانية بشكلٍ صحيح لكلٍّ من "عرض الأسعار المفتوح" توسّط العرض الإعلاني بدون انقطاع
يوضّح هذا الدليل كيفية إطلاق الميزات المختلفة واستخدامها في الإعلان الجديد.
المتطلبات الأساسية
لاستخدام "أداة فحص الإعلانات"، يجب تنفيذ ما يلي:
- أكمِل دليل البدء.
- استخدام إصدار المكوّن الإضافي Flutter لإعلانات الأجهزة الجوّالة 1.3.0 أو أعلى.
- تفعيل الاختبار الوضع أو الرابط جهازك إلى "مدير إعلانات Google" لا يتم تشغيل "أداة فحص الإعلانات" إلا على الأجهزة الاختبارية أو الأجهزة المرتبطة.
تشغيل "أداة فحص الإعلانات"
ويمكن تشغيل "أداة فحص الإعلانات" من أيّ مكان في تطبيقك بالطرق التالية:
- استخدِم زر التشغيل من قائمة تصحيح الأخطاء.
- استخدِم الإيماءة التي اختَرتها في إعدادات "أداة فحص الإعلانات".
- آليًا باستخدام واجهة برمجة التطبيقات المقدَّمة
الإطلاق باستخدام قائمة تصحيح الأخطاء
لا يلزم إجراء أي تغييرات على تطبيقك لتشغيل أداة فحص الإعلانات من خلال عملية تصحيح الأخطاء. القائمة؛ ما عليك سوى البحث عن إعلان تعرضه شبكة "مدير الإعلانات" ثم النقر مع الاستمرار الإعلان بإصبعين لفتحه قائمة تصحيح الأخطاء. وبعد ذلك، اختَر فتح أداة فحص الإعلانات.
إذا لم تربط جهازك، قد يُطلب منك لتسجيل الدخول إلى حسابك على "مدير إعلانات Google"
يمكنك أيضًا اختيار إعدادات "أداة فحص الإعلانات" من إعدادات تصحيح الأخطاء. اختيار إيماءة يمكنها فتح أداة فحص الإعلانات في المستقبل بدون الحاجة إلى الانتقال من خلال قائمة تصحيح الأخطاء.
الإطلاق آليًا
يمكن أيضًا إطلاق "أداة فحص الإعلانات" آليًا:
MobileAds.instance.openAdInspector(
(AdInspectorError? error) {
// Error will be non-null if ad inspector closed due to an error.
});
تعمل واجهة برمجة التطبيقات هذه مع الأجهزة الاختبارية. مسجّلة برمجيًا.
عرض الوحدات الإعلانية وتحديد مشاكلها وحلّها
بعد إطلاق "أداة فحص الإعلانات"، تظهر الشاشة الرئيسية التي تحتوي على قائمة بجميع الوحدات قدَّم الجهاز طلبات إعلانات منذ تفعيل "أداة فحص الإعلانات" خلال هذه الفترة جلسة التطبيق. تحتوي القائمة أيضًا على وحدات إعلانية تم فيها تفعيل "عرض الأسعار المفتوح" وترتيبه بترتيب زمني مع الطلبات الأكثر اكتمالاً أولاً، وتلك التي تم إكمالها لا طلبات إعلان مكتملة (غير مكتملة):
نوصي بتهيئة إعلانات Google للجوّال حزمة SDK قبل الاستعانة بأداة فحص الإعلانات
الاطّلاع على تفاصيل العرض الإعلاني بدون انقطاع للتوسّط في وحدة إعلانية
انقر على وحدة إعلانية لعرض سجلّ طلبات حزمة تطوير البرامج (SDK) الخاص بها، والذي يقدّم تفاصيل عن تدفّق التوسّط وصولاً إلى المرحلة التي تمت فيها تعبئة الإعلان (أو العرض الإعلاني بدون انقطاع بدون تعبئة) للحصول على أحدث طلبات الإعلان.
يمكن توسيع كل طلب باستخدام مؤشر الإفصاح لعرض النتائج. تدفق التوسّط لهذا الطلب، إلى جانب أي خطأ ووقت استجابة التي كانت سارية على هذا الطلب.
بالنسبة إلى مصادر الإعلانات التابعة لجهات خارجية، يتم إرسال رسائل الخطأ مباشرةً من مصدر الإعلان وإذا كنت بحاجة إلى مزيد من المعلومات، يُرجى الرجوع إلى مصدر إعلانك التابع لجهة خارجية.
عرض تفاصيل عروض الأسعار لوحدة إعلانية
إذا كنت حديث العهد باستخدام "عرض الأسعار المفتوح"، اطّلِع على مقدمة عن "عرض الأسعار المفتوح" عروض الأسعار:
في سجلّ طلبات حزمة تطوير البرامج (SDK)، يمكنك الاطّلاع على bidding مصادر الإعلانات التي يتم استدعاؤها في طلب الإعلان. انقر على وحدة إعلانية في سجلّ طلبات حزمة تطوير البرامج (SDK) لعرضها تفاصيل كل مصدر إعلان في bidding المزاد.
يتم فرز bidding النتائج لجلب العناصر القابلة للتنفيذ الأقرب إلى أعلى القائمة:
وفي أعلى الصفحة، تظهر شبكة الإعلانات التي فازت بالمزاد.
ننتقل تاليًا إلى شبكات الإعلانات التي تتضمّن مشاكل. يمكنك اتباع خطوات تحديد المشاكل وحلّها في نهاية bidding الأسئلة الشائعة
وبعد ذلك، هناك شبكات الإعلانات التي لم تعرض أي إعلانات أو لم تقدم عروض أسعار. هذا النمط مؤشرًا محتملاً للعديد من المشاكل المختلفة في مصدر الإعلان قد لا يقدم عرض سعر بسبب إعداده أو قراره. يمكنك الرجوع إلى الإعلان دليل إعداد المصدر الأسئلة الشائعة عن "عرض الأسعار المفتوح" للمزيد من المعلومات والدعم.
وأخيرًا، في أسفل القائمة، توجد شبكات الإعلانات التي فقدت bidding مزاد
يمكن أن يؤدي العرض الإعلاني بدون انقطاع في التوسط إلى وضع مصدر الإعلان الذي فاز bidding المزاد وفقًا لقيمة التكلفة الفعلية لكل ألف ظهور.
تدفق التوسط هو نتيجة مجموعات أرباح متعددة تتنافس على المستودع نفسه. يمكنك إضافة ما يصل إلى عشرة شركاء أرباح من جهات خارجية إلى شريك واحد مجموعة الشبكات الإعلانية المدِرّة للأرباح، بما في ذلك الشركاء المدِرّين للأرباح لعرض الأسعار المفتوح والتوسّط للأجهزة الجوّالة. التطبيقات الشريكة لتحقيق الأرباح
تصحيح أخطاء الوحدة الإعلانية المتقدمة
عند تحديد مشاكل الوحدات الإعلانية وحلّها، قد يكون من المفيد التوغّل في طلب الإعلان والاستجابة لتحديد مواضع الإخفاق، أو لمشاركتها مع Google الدعم للمساعدة في تصحيح الأخطاء. النقر على رمز القائمة في أعلى العرض الإعلاني بدون انقطاع سلسلة واختيار مشاركة طلب الإعلان والاستجابة لتصدير طلب الإعلان بالكامل والاستجابة. يوفر عليك هذا عناء الاضطرار إلى تشغيل عمليات تتبع الشبكة على تطبيقك الخاص.
إضافةً إلى ذلك، يمكنك الاطّلاع على مَعلمات عروض الأسعار التابعة لجهات خارجية التي تم فك ترميزها بالنقر على خيار مَعلمة عروض الأسعار التابعة لجهة خارجية في القائمة نفسها التي يظهر فيها الطلب. السلسلة. ويوفر ذلك تفاصيل عن مَعلمات عروض الأسعار التابعة لجهات خارجية التي قد المشكلات، أو سيساعدك في تصحيح الأخطاء في تطبيقك أو في التحقق من أن إحدى الشبكات يجمع إشاراته بنجاح.
![]() |
![]() |
عرض المحوّلات المتاحة
انقر على علامة التبويب المحوّلات للاطّلاع على قائمة بجميع المحوّلات التابعة لجهات خارجية. مع مصادر الإعلانات في إعدادات عروض الأسعار أو التوسّط في تطبيقك. بعد ذلك، يمكنك توسيع البطاقات لعرض حالات الإعداد وإصدارات حزمة تطوير البرامج (SDK). يمكنك أيضًا الاطّلاع على حدث مخصّص إلى جانب المحوّلات المتوافقة التابعة لجهات خارجية. محوّلات. تتيح الأحداث المخصّصة يستخدم الناشرون شبكات الإعلانات التي Ad Manager لا يدعم. يمكن التمييز بين الأحداث المخصّصة والأحداث العادية التابعة لجهات خارجية في قائمة المحوّلات حسب أسماء الفئات الفريدة. بالإضافة إلى توفير اسم الفئة ومعلومات الحالة، فإن أداة فحص الإعلانات تعرض أيضًا التصنيفات المعيّنة لهذه الأحداث المخصَّصة في Ad Manager واجهة ويب.
في حالة عدم العثور على المحول أو تعذر إعداده، راجع فحص عرض إعلانات تطبيقات الأجهزة الجوّالة لمزيد من المعلومات.
![]() |
![]() |
اختبار وحداتك الإعلانية
إذا أردت اختبار وحدتك الإعلانية بدون الحاجة إلى الانتقال إليها في في واجهة مستخدم التطبيق، تتيح أداة فحص الإعلانات ذلك مباشرةً من شاشة تفاصيل الوحدة الإعلانية. بالإضافة إلى ذلك، يمكنك اختبار وحدات إعلانية متعددة في وقت واحد، وتحميلها بشكل غير متزامن. وعرض طلبات الإعلانات الاختبارية وإجراء اختبارات لمصدر إعلان فردي.
اختبار الإعلان
تُعدّ اختبارات الإعلانات في "أداة فحص الإعلانات" الموضّحة في هذا القسم أداة رائعة والتحقّق من تجربة الإعلانات الأساسية والتحقّق من صحة التوسّط الإعدادات عند استخدامها مع اختبار مصدر إعلان فردي.
عندما تكون مستعدًا لاختبار وحدتك الإعلانية، انقر على الزر طلب إعلان تجريبي على أعلى شاشة "أداة فحص الإعلانات" لتشغيل اختبار الإعلانات في "أداة فحص الإعلانات" اختبار ستظهر النتائج بعد ذلك في سجل طلبات حزمة تطوير البرامج (SDK) أسفل العنوان من أداة فحص الإعلانات
اختبار مصدر إعلان واحد
تتوفّر في "أداة فحص الإعلانات" ميزة لحظر طلبات الإعلان في تطبيقك من أجل عرض الإعلانات فقط الإعلانات من إعلان توسّط واحد bidding أو إعلان توسّط للعرض الإعلاني بدون انقطاع المصدر. يتيح لك ذلك التأكّد من أنّك نفّذت الطرف الثالث بشكل صحيح وأن يعمل مصدر الإعلان على النحو المتوقع.
لتفعيل هذه الميزة، يمكنك تفعيل مفتاح التبديل اختبار مصدر إعلان فردي عند أسفل الشاشة. وسيؤدي ذلك إلى عرض مربّع الحوار التالي لاختيار مصدر الإعلان:
يجب إعداد إعلانات Google للأجهزة الجوّالة حزمة SDK قبل أن تتمكّن من استخدام اختبار مصدر إعلان فردي
ويمكنك بعد ذلك اختيار مصدر إعلان واحد لاختباره. بعد اختيار مصدر إعلان تظهر الشاشة التالية:
ينطبق إعداد اختبار مصدر الإعلان الفردي على أي طلبات إعلان مستقبلية تقدّمها في نفس الجلسة. ومع ذلك، لا ينطبق هذا التغيير على أي إعلانات مخزنة مؤقتًا في تلك الفترة الجلسة التي لم يتم عرضها بعد. ننصحك بفرض إعادة تشغيل تطبيقك. عند تطبيق اختبار مصدر إعلان واحد لإلغاء صلاحية أي إعلانات مخزّنة مؤقتًا بدلاً من أن يتلقّى مصدر الإعلان الذي اخترته طلبًا.
بعد إعادة تشغيل تطبيقك، تحاول جميع مواضع الوحدات الإعلانية عرض إعلان من الشبكة التي تم تحديدها فقط. إطلاق "أداة فحص الإعلانات" عند إجراء اختبار لمصدر إعلان واحد نشط يعرض مصدر الإعلان التجريبي النشط:
في وضع اختبار مصدر الإعلان الفردي، تحاول جميع طلبات الإعلانات ملء البيانات المحدّدة مصدر الإعلان، بغض النظر عما إذا كان مصدر الإعلان قد تم إعداده لتقديم عروض الأسعار أو التوسط للوحدة الإعلانية المطلوبة. إذا لم يكن مصدر الإعلان الذي تختبره تدفق التوسّط في وحدة إعلانية، ستحصل على "بلا تعبئة" .
في اختبار مصدر إعلان واحد، يمكنك النقر على وحدة إعلانية لعرض سجلّ طلبات حزمة تطوير البرامج (SDK) الخاص بها. يتيح لك ذلك معرفة ما إذا كان مصدر الإعلان قد ملأ طلبات الإعلان التي تم إجراؤها بعد تفعيل اختبار مصدر إعلان فردي إذا تعذّر على مصدر الإعلان تحميل إعلان، تظهر رسالة خطأ تصف الخطأ.
في حال أضفت مثيلات متعددة من مصدر الإعلان المحدّد إلى عملية توسّط. العرض الإعلاني بدون انقطاع، ستلاحظ كل مرة يتم فيها إجراء طلب على مصدر الإعلان العرض الإعلاني بدون انقطاع إلى أن تتم تعبئة الإعلان أو انتهاء العرض الإعلاني بدون انقطاع
إيقاف اختبار مصدر إعلان واحد
لإيقاف الاختبار، استخدِم مفتاح التبديل لإيقاف الاختبار:
بعد ذلك، تظهر رسالة تأكيد على شاشة إعادة التشغيل التالية:
ننصحك بفرض إعادة تشغيل تطبيقك بعد إيقافه من أجل تنفيذ ما يلي: إيقاف أي إعلانات مخزّنة مؤقتًا لمصدر الإعلان الذي تمّ اختباره.
نسخ نتائج تصحيح الأخطاء بالكامل
تتيح أداة فحص الإعلانات نسخ سلسلة JSON تحتوي على تصحيح الأخطاء الكامل والمخرجات من الأداة، بما في ذلك تفاصيل Ad Manager التطبيق وحالات إعداد المحوّلات اختبار جميع الوحدات الإعلانية.
ولإجراء ذلك، انقر على رمز التطبيق سبع مرات إلى أن تظهر لك الرسالة نسخ الإعلان أداة فحص التشفير JSON إلى الحافظة.