وباستخدام "أداة فحص الإعلانات"، يمكنك إجراء ما يلي:
- فحص وحداتك الإعلانية
- التحقّق من تعبئة إعلاناتك على النحو المتوقّع
- تحديد الأخطاء والاطّلاع على التفاصيل حول كيفية حلّها
- عرض تفاصيل كل شبكة إعلانات "عرض أسعار مفتوح" لكل طلب
- عرض تفاصيل التوسّط لكل شبكة إعلانات لكل طلب
- اختبار مصادر إعلانات فردية تابعة لجهات خارجية لعرض الأسعار المفتوح أو توسّط العرض الإعلاني بدون انقطاع
- تحقق من ضبط كل وحدة إعلانية بشكل صحيح لكل من "عرض الأسعار المفتوح" وتوسّط العرض الإعلاني بدون انقطاع
يوضّح هذا الدليل كيفية إطلاق الميزات المختلفة واستخدامها في أداة فحص الإعلانات.
المتطلّبات الأساسية
لاستخدام "أداة فحص الإعلانات"، يجب تنفيذ ما يلي:
- أكمِل دليل البدء.
- استخدِم إصدارًا من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" 8.10.0 أو إصدارًا أحدث.
- عليك تفعيل وضع الاختبار أو ربط جهازك بـ "مدير الإعلانات". لا يتم تشغيل "أداة فحص الإعلانات" إلا على الأجهزة الاختبارية أو الأجهزة المرتبطة.
تشغيل "أداة فحص الإعلانات"
ويمكن تشغيل "أداة فحص الإعلانات" من أيّ مكان في تطبيقك بالطرق التالية:
- استخدِم زر التشغيل من قائمة تصحيح الأخطاء.
- استخدِم الإيماءة التي اختَرتها في إعدادات "أداة فحص الإعلانات".
- آليًا باستخدام واجهة برمجة التطبيقات المقدَّمة
الإطلاق باستخدام قائمة تصحيح الأخطاء
لا حاجة إلى إجراء أيّ تغييرات في تطبيقك لتشغيل "أداة فحص الإعلانات" من خلال قائمة تصحيح الأخطاء. ما عليك سوى البحث عن إعلان تعرضه شبكة "مدير الإعلانات" والنقر مع الاستمرار على الإعلان بإصبعين لفتح قائمة تصحيح الأخطاء. وبعد ذلك، اختَر فتح أداة فحص الإعلانات.
في حال عدم ربط جهازك، قد يُطلب منك تسجيل الدخول إلى حسابك على "مدير الإعلانات".
يمكنك أيضًا اختيار إعدادات "أداة فحص الإعلانات" من إعدادات تصحيح الأخطاء، واختيار إيماءة يمكنها فتح أداة فحص الإعلانات في المستقبل بدون الحاجة إلى الانتقال إلى قائمة تصحيح الأخطاء.
الإطلاق آليًا
يمكن أيضًا إطلاق "أداة فحص الإعلانات" آليًا:
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.
}];
تعمل واجهة برمجة التطبيقات هذه على أجهزة الاختبار المسجَّلة آليًا.
تأكَّد من أنّ وحدة التحكّم في العرض التي تم تمريرها إلى واجهة برمجة التطبيقات هذه ظاهرة بالكامل على الشاشة (تم استدعاء viewDidAppear:). إذا كانت وحدة التحكّم بالعرض التي تم تمريرها قيد العرض، كما هو الحال عند استدعاء واجهة برمجة التطبيقات في وظيفة viewDidLoad لعناصر التحكّم في العرض، يتعذّر عرض أداة فحص الإعلانات.
عرض الوحدات الإعلانية وتحديد مشاكلها وحلّها
بعد إطلاق "أداة فحص الإعلانات"، تظهر الشاشة الرئيسية التي تحتوي على قائمة بجميع الوحدات الإعلانية قدَّم الجهاز طلبات إعلانات منذ تفعيل "أداة فحص الإعلانات" أثناء جلسة التطبيق هذه. وتتضمّن القائمة أيضًا وحدات إعلانية تم فيها تفعيل "عرض الأسعار المفتوح"، وترتيبها زمنيًا مع الطلبات الأكثر اكتمالاً أولاً، وتلك التي لم يتم إكمال طلبات الإعلان فيها (مختومة):
ننصحك بإعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة قبل استخدام أداة فحص الإعلانات.
الاطّلاع على تفاصيل العرض الإعلاني بدون انقطاع للتوسّط في وحدة إعلانية
انقر على وحدة إعلانية للاطّلاع على سجلّ طلبات حزمة تطوير البرامج (SDK) الخاص بها، والذي يقدِّم تفاصيل عن تدفق التوسّط حتى وقت تعبئة الإعلان (أو العرض الإعلاني بدون انقطاع الذي انتهى بدون تعبئة) لأحدث طلبات الإعلان.
يمكن توسيع كل طلب باستخدام مؤشر الإفصاح لعرض نتائج تدفق التوسط لهذا الطلب، إلى جانب أي خطأ ووقت استجابة كان ينطبق على هذا الطلب.
بالنسبة إلى مصادر الإعلانات التابعة لجهات خارجية، يتم إرسال رسائل الخطأ مباشرةً من مصدر الإعلان. وإذا كنت بحاجة إلى مزيد من المعلومات، يُرجى الرجوع إلى مصدر إعلانك التابع لجهة خارجية.
عرض تفاصيل عروض الأسعار لوحدة إعلانية
إذا كنت حديث العهد بميزة "عرض الأسعار المفتوح"، اطّلِع على مقدمة عن "عرض الأسعار المفتوح".
في سجلّ طلبات حزمة تطوير البرامج (SDK)، يمكنك الاطّلاع على Open Bidding مصادر الإعلانات التي يتم استدعاؤها في طلب الإعلان. انقر على وحدة إعلانية في سجلّ طلبات حزمة تطوير البرامج (SDK) لعرض تفاصيل كل مصدر إعلان في Open Bidding المزاد.
يتم فرز Open Bidding النتائج لتقريب العناصر القابلة للتنفيذ من أعلى القائمة:
وفي أعلى الصفحة، تظهر شبكة الإعلانات التي فازت بالمزاد.
ننتقل تاليًا إلى شبكات الإعلانات التي تتضمّن مشاكل. يمكنك اتّباع خطوات تحديد المشاكل وحلّها في نهاية Open Bidding الأسئلة الشائعة
وبعد ذلك، هناك شبكات الإعلانات التي لم تعرض أي إعلانات أو لم تقدم عروض أسعار. وهذا مؤشر محتمل للعديد من المشاكل المختلفة في مصدر الإعلان لأنه قد لا يتم تقديم عروض أسعار بسبب إعداده أو قراره. يمكنك الرجوع إلى دليل إعداد مصدر الإعلان أو الأسئلة الشائعة عن "عرض الأسعار المفتوح" للحصول على مزيد من الدعم.
أخيرًا، تظهر شبكات المواقع الإعلانية التي خسرتOpen Bidding المزاد في أسفل القائمة.
يمكن أن تحدّد ميزة العرض الإعلاني بدون انقطاع في ميزة "التوسّط" مصدر الإعلان الذي فاز في Open Bidding المزاد وفقًا لقيمة التكلفة الفعلية لكل ألف ظهور (eCPM).
ينتج تدفق التوسّط نتيجة مجموعات أرباح متعددة تتنافس على المستودع نفسه. يمكنك إضافة ما يصل إلى عشرة شركاء أرباح من جهات خارجية إلى مجموعة أرباح واحدة، بما في ذلك الشركاء المدِرّين للأرباح في "عرض الأسعار المفتوح" والتوسّط للشركاء المدِرّين للأرباح للتطبيقات المتوافقة مع الأجهزة الجوّالة.
تصحيح أخطاء الوحدة الإعلانية المتقدمة
عند تحديد المشاكل وحلّها في الوحدات الإعلانية، قد يكون من المفيد التعمق في طلب الإعلان والاستجابة لتحديد نقاط العطل، أو المشاركة مع فريق دعم Google للمساعدة في تصحيح الأخطاء. انقر على رمز القائمة في أعلى سلسلة العرض الإعلاني بدون انقطاع، واختَر مشاركة طلب الإعلان والاستجابة لتصدير طلب الإعلان والاستجابة الكاملَين. ويوفّر ذلك عناء الاضطرار إلى تشغيل عمليات تتبُّع الشبكات على تطبيقك.
إضافةً إلى ذلك، يمكنك الاطّلاع على مَعلمات عروض الأسعار التابعة لجهات خارجية التي تم فك ترميزها بالنقر على خيار مَعلمة عروض الأسعار التابعة لجهة خارجية في القائمة نفسها التي تتضمّن سلسلة الطلب. ويوفّر ذلك تفاصيل عن مَعلمات عروض الأسعار التابعة لجهات خارجية التي قد تواجه مشاكل، ما يساعدك في تصحيح الأخطاء في تطبيقك أو التحقّق من أنّ الشبكة تجمع إشاراتها بنجاح.
عرض المحوّلات المتاحة
انقر على علامة التبويب المحوّلات للاطّلاع على قائمة بجميع المحوّلات التابعة لجهات خارجية والمرتبطة بمصادر الإعلانات في إعدادات عروض الأسعار أو التوسّط في تطبيقك. بعد ذلك، وسِّع البطاقات لعرض حالات إعدادها وإصدارات حزمة تطوير البرامج (SDK). يمكنك أيضًا عرض محوّلات مخصّصة للأحداث، بالإضافة إلى المحوّلات المتوافقة التابعة لجهات خارجية. تتيح الأحداث المخصّصة للناشرين استخدام شبكات إعلانات Ad Manager لا تتوافق معها. يمكن تمييز الأحداث المخصّصة عن المحوّلات العادية التابعة لجهات خارجية في قائمة المحوّلات من خلال أسماء الفئات الفريدة. بالإضافة إلى توفير اسم الفئة ومعلومات الحالة، يعرض فاحص الإعلانات أيضًا التصنيفات المخصّصة لتلك الأحداث المخصّصة في Ad Manager واجهة الويب.
في حال عدم العثور على المحوّل أو تعذّر إعداده، يمكنك الاطّلاع على فحص عرض إعلانات التطبيقات للأجهزة الجوّالة للحصول على مزيد من المعلومات.
اختبار وحداتك الإعلانية
إذا كنت تريد اختبار وحدتك الإعلانية بدون الحاجة إلى الانتقال إليها في واجهة مستخدم تطبيقك، تتيح أداة فحص الإعلانات ذلك مباشرةً من شاشة تفاصيل الوحدة الإعلانية. بالإضافة إلى ذلك، يمكنك اختبار وحدات إعلانية متعدّدة في الوقت نفسه، وتحميل طلبات الإعلان الاختبارية وعرضها بشكل غير متزامن، وحتى إجراء اختبارات فردية لمصدر الإعلانات.
اختبار الإعلان
تعتبر اختبارات الإعلانات في "أداة فحص الإعلانات" الموضّحة في هذا القسم أداة رائعة للتحقّق من تجربة الإعلانات الأساسية وللتحقّق من صحة إعدادات التوسّط عند استخدامها مع اختبار مصدر إعلان فردي.
عندما تكون مستعدًا لاختبار وحدتك الإعلانية، انقر على الزرّ طلب إعلان تجريبي في أعلى شاشة "أداة فحص الإعلانات" لتشغيل اختبار الإعلانات في "أداة فحص الإعلانات". وستظهر النتائج الاختبارية بعد ذلك في سجلّ طلبات حزمة تطوير البرامج (SDK) أسفل العنوان مطلوب من أداة فحص الإعلانات.
اختبار مصدر إعلان واحد
تتضمّن "أداة فحص الإعلانات" ميزة لحظر طلبات الإعلانات في تطبيقك من أجل عرض الإعلانات من مصدر إعلان واحد Open Bidding أو مصدر إعلان توسّط العرض الإعلاني بدون انقطاع. يتيح لك ذلك التأكّد من أنّك نفّذت المحوِّل التابع لجهة خارجية بشكلٍ صحيح وأنّ مصدر الإعلان يعرض الإعلانات على النحو المتوقّع.
لتفعيل هذه الميزة، يمكنك تفعيل مفتاح التبديل اختبار مصدر إعلان واحد في أسفل الشاشة. وسيؤدي ذلك إلى عرض مربّع الحوار التالي لاختيار مصدر الإعلان:
يجب إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة قبل أن تتمكّن من استخدام اختبار مصدر إعلان فردي.
ويمكنك بعد ذلك اختيار مصدر إعلان واحد لاختباره. بعد اختيار مصدر إعلان، تظهر الشاشة التالية:
ينطبق إعداد اختبار مصدر الإعلان الفردي على أي طلبات إعلان مستقبلية تقدّمها في الجلسة نفسها. ومع ذلك، لا ينطبق ذلك على أي إعلانات مخزنة مؤقتًا في تلك الجلسة لم يتم عرضها بعد. ويُنصَح بفرض إعادة تشغيل تطبيقك عند تطبيق اختبار واحد لمصدر الإعلان لإلغاء صلاحية أي إعلانات مخزّنة مؤقتًا يمكن عرضها بدلاً من أن يتلقّى مصدر الإعلان الذي اخترته طلبًا.
بعد إعادة تشغيل تطبيقك، تحاول جميع مواضع الوحدات الإعلانية عرض إعلان من الشبكة المحدّدة فقط. عند إطلاق "أداة فحص الإعلانات" عندما يكون اختبار مصدر إعلان فردي نشطًا، يتم عرض مصدر الإعلان التجريبي النشط:
في وضع اختبار مصدر الإعلان الفردي، تحاول جميع طلبات الإعلان التعبئة باستخدام مصدر الإعلان المحدّد، بغض النظر عمّا إذا تم إعداد مصدر الإعلان هذا لتقديم عروض الأسعار أو التوسّط للوحدة الإعلانية المطلوبة. إذا لم يكن مصدر الإعلان الذي تختبره في تدفق التوسط لوحدة إعلانية، ستظهر لك رسالة خطأ "بلا تعبئة".
في اختبار مصدر إعلان واحد، يمكنك النقر على وحدة إعلانية لعرض سجلّ طلبات حزمة تطوير البرامج (SDK) الخاص بها. ويتيح لك ذلك معرفة ما إذا كان مصدر الإعلان قد ملأ طلبات الإعلان التي تم إجراؤها بعد تفعيل اختبار مصدر إعلان فردي. إذا تعذّر على مصدر الإعلان تحميل إعلان، ستظهر رسالة خطأ تصف الخطأ.
إذا أضفت مثيلات متعددة من مصدر الإعلان المحدّد إلى العرض الإعلاني بدون انقطاع للتوسّط، سترى كل مثيل من الطلب المقدّم إلى مصدر الإعلان في العرض الإعلاني بدون انقطاع إلى أن تتم تعبئة الإعلان أو انتهى العرض الإعلاني بدون انقطاع بدون تعبئة.
إيقاف اختبار مصدر إعلان واحد
لإيقاف الاختبار، استخدِم مفتاح التبديل لإيقاف الاختبار:
بعد ذلك، تظهر رسالة تأكيد على شاشة إعادة التشغيل التالية:
ننصحك بفرض إعادة تشغيل تطبيقك بعد إيقاف الاختبار لإلغاء صلاحية أي إعلانات مخزّنة مؤقتًا لمصدر الإعلان الذي تم اختباره.
نسخ نتائج تصحيح الأخطاء بالكامل
تتيح أداة فحص الإعلانات نسخ سلسلة JSON تحتوي على نتائج تصحيح الأخطاء الكاملة من الأداة، بما في ذلك تفاصيلAd Manager تطبيقك وحالات إعداد المهايئات ونتائج الاختبار لجميع الوحدات الإعلانية.
ولإجراء ذلك، انقر على رمز التطبيق سبع مرات حتى تظهر لك الرسالة تم نسخ ملف JSON الخاص بأداة فحص الإعلان إلى الحافظة.