تفعيل الإعلانات الاختبارية

اختيار النظام الأساسي: Android iOS Unity Flutter

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

هناك طريقتان للحصول على إعلانات اختبارية:

  1. استخدِم إحدى وحدات الإعلانات التجريبية من Google.
  2. استخدِم وحدتك الإعلانية وفعِّل الأجهزة الاختبارية.

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

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

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

في ما يلي وحدات إعلانية تجريبية تشير إلى تصاميم إعلانات اختبارية محدّدة لكل شكل إعلان:

شكل الإعلان رقم تعريف الوحدة الإعلانية التجريبية
الإعلانات على شاشة فتح التطبيق ca-app-pub-3940256099942544/9257395921
إعلانات البانر التكيُّفية ca-app-pub-3940256099942544/9214589741
إعلان بانر ذو حجم ثابت ca-app-pub-3940256099942544/6300978111
الإعلانات البينية ca-app-pub-3940256099942544/1033173712
الإعلانات مقابل مكافأة ca-app-pub-3940256099942544/5224354917
الإعلانات البينية مقابل مكافأة ca-app-pub-3940256099942544/5354046379
الإعلان المدمجة مع المحتوى ca-app-pub-3940256099942544/2247696110
فيديوهات مدمَجة مع المحتوى ca-app-pub-3940256099942544/1044960115

تفعيل أجهزة الاختبار

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

اتّبِع الخطوات التالية لإضافة جهازك كجهاز اختباري.

إضافة جهاز الاختبار في واجهة مستخدم AdMob

لإضافة جهاز اختباري واختبار إصدارات التطبيق الجديدة أو الحالية بطريقة غير آلية، استخدِم واجهة مستخدم AdMob. مزيد من المعلومات

إضافة جهاز الاختبار بطريقة آلية

لتسجيل جهاز الاختبار، أكمِل الخطوات التالية:

  1. حمِّل تطبيقك المتكامل مع الإعلانات وأرسِل طلب إعلان.
  2. تحقَّق من ناتج logcat بحثًا عن رسالة مشابهة لما يلي، والتي تعرض معرّف جهازك وكيفية إضافته كجهاز اختباري:
    I/Ads: Use RequestConfiguration.Builder.setTestDeviceIds(Arrays.asList("33BE2250B43518CCDA7DE426D04EE231"))
    to get test ads on this device."
    انسخ رقم تعريف جهازك الاختباري إلى الحافظة.
  3. عدِّل الرمز البرمجي لاستدعاء RequestConfiguration.Builder.setTestDeviceIds() وتضمين قائمة بأرقام تعريف أجهزتك الاختبارية.

Java

List<String> testDeviceIds = Arrays.asList("TEST_DEVICE_ID");
RequestConfiguration configuration =
    new RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build();
MobileAds.setRequestConfiguration(configuration);

Kotlin

val testDeviceIds = listOf("TEST_DEVICE_ID")
val configuration = RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build()
MobileAds.setRequestConfiguration(configuration)

استبدِل TEST_DEVICE_ID برقم تعريف جهازك التجريبي.

يمكنك اختياريًا وضع علامة في المربّع isTestDevice() للتأكّد من أنّه تمت إضافة جهازك بشكل صحيح كجهاز اختبار.

1. أعِد تشغيل تطبيقك. إذا كان الإعلان من Google، سيظهر لك التصنيف إعلان اختباري في أعلى وسط الإعلان (بانر أو إعلان بيني أو فيديو مقابل مكافأة):


<img class="screenshot" src="/admob/images/android-testad-0-admob.png" style="max-width:300px;"/>


For native advanced ads, the headline asset is prepended with the string **Test Ad**.

<img class="screenshot" src="/admob/images/native-testad-android.png" style="max-width:300px;"/>

يمكن النقر على الإعلانات التي تحمل التصنيف إعلان اختباري بدون أن يؤثّر ذلك سلبًا عليك. لن تظهر الطلبات ومرّات الظهور والنقرات على الإعلانات الاختبارية في تقارير حسابك.

ملاحظة: لعرض التصنيف إعلان اختباري، يجب استخدام إصدار 11.6.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK).

اختبار التوسّط

لا تعرض نماذج الوحدات الإعلانية من Google إلا إعلانات Google. لاختبار إعدادات &quot;توسّط AdMob&quot;، عليك استخدام أسلوب تفعيل الأجهزة الاختبارية.

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

إذا لم تكن متأكدًا مما إذا كان محوّل شبكة إعلانات التوسّط يتيح عرض إعلانات اختبارية، من الأفضل تجنُّب النقر على الإعلانات من تلك الشبكة أثناء التطوير. يمكنك استخدام طريقة getMediationAdapterClassName() مع أي من أشكال الإعلانات لمعرفة شبكة الإعلانات التي عرضت الإعلان الحالي.