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

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

بالنسبة إلى إعلانات الأجهزة الجوّالة Unity 7.0.0 والإصدارات الأحدث، يمكنك:

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

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

• اختبار عمليات دمج الأحداث المخصّصة

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

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

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

• عليك إنشاء حساب على AdMob وإعداد تطبيق.

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

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

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

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

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

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

بدء العملية باستخدام الإيماءات

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

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

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

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

public void OnButtonClick() {
  MobileAds.OpenAdInspector(error => {
    // Error will be set if there was an issue and the inspector was not displayed.
  });
}

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

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

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

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

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

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

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

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

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

إذا كنت مبتدئًا في مجال عروض الأسعار، اطّلِع على النظرة العامة.

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

يتم فرز bidding النتائج لتقريب العناصر القابلة للتنفيذ من أعلى القائمة:

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

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

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

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

  

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

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

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

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

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

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

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

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

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

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

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

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

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

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

اختبار مصدر إعلان واحد

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

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

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

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

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

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

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

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

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

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

لإيقاف الاختبار، استخدِم مفتاح التبديل لإيقاف الاختبار:

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

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

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

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

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