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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Java

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

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

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

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

نوصي بتهيئة إعلانات Google للجوّال حزمة SDK قبل الاستعانة بأداة فحص الإعلانات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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