يمكنك مشاركة ملاحظاتك حول "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة" في قناة #gma-next-gen-sdk على Discord في خادم Google Advertising and Measurement Community.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

Android iOS Unity Flutter

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

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

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

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

قبل المتابعة، عليك إعداد GMA Next-Gen SDK.

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

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

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

شكل الإعلان	رقم تعريف الوحدة الإعلانية التجريبية
الإعلانات على شاشة فتح التطبيق	`ca-app-pub-3940256099942544/9257395921`
إعلانات البانر التكيُّفية الثابتة	`ca-app-pub-3940256099942544/9214589741`
إعلانات البانر التكيُّفية المضمّنة	`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 أو بطريقة آلية باستخدام GMA Next-Gen SDK.

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

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

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

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

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

حمِّل تطبيقك المتكامل مع الإعلانات وأرسِل طلب عرض إعلان.
ابحث في سجلّ logcat عن رسالة مشابهة للرسالة التالية، والتي تعرض رقم تعريف جهازك وكيفية إضافته كجهاز اختباري:
```
I/Ads: Use RequestConfiguration.Builder.setTestDeviceIds(Arrays.asList("33BE2250B43518CCDA7DE426D04EE231"))
to get test ads on this device."
```
انسخ رقم تعريف الجهاز الاختباري إلى الحافظة.
عدِّل الرمز البرمجي لاستدعاء RequestConfiguration.Builder.setTestDeviceIds() وأدخِل قائمة بأرقام تعريف أجهزتك الاختبارية.
جافا
```
List<String> testDeviceIds = Arrays.asList("33BE2250B43518CCDA7DE426D04EE231");
RequestConfiguration configuration =
new RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build();
MobileAds.setRequestConfiguration(configuration);
```
Kotlin
```
val testDeviceIds = Arrays.asList("33BE2250B43518CCDA7DE426D04EE231")
val configuration = RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build()
MobileAds.setRequestConfiguration(configuration)
```
يمكنك اختياريًا التحقّق من isTestDevice() للتأكّد من أنّه تمّت إضافة جهازك بشكلٍ صحيح كجهاز اختباري.

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

بالنسبة إلى الإعلانات المتقدّمة المدمجة مع المحتوى، يتم إضافة السلسلة إعلان اختباري قبل مادة عرض العنوان.

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

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

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

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

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