اختبار الوحدات الإعلانية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختيار النظام الأساسي:
Android
iOS
Unity
Flutter
تتيح "أداة فحص الإعلانات" الاختبارات التالية:
- الاختبار في السياق: يمكنك تحميل الإعلانات من الوحدات الإعلانية في تطبيقك، كما يمكنك فتح "أداة فحص الإعلانات" للاطّلاع على تفاصيل الطلبات المقدَّمة من الوحدات الإعلانية.
- الاختبار خارج السياق: اختبِر وحدتك الإعلانية مباشرةً في "أداة فحص الإعلانات"
بدون الانتقال إلى واجهة مستخدم تطبيقك. يمكنك اختبار وحدات إعلانية متعدّدة في الوقت نفسه، وتحميل طلبات الإعلانات الاختبارية وعرضها بشكل غير متزامن، وإجراء اختبارات لمصدر إعلان فردي.
عند إجراء اختبار خارج السياق، لا تتضمّن طلباتك المَعلمات اللازمة لتنفيذها في واجهة مستخدم تطبيقك، بما في ذلك إعدادات التعامل مع الطلبات الموجّهة إلى الأطفال، والاستهداف المخصّص، وإضافات الشبكة، والأحجام المختلفة. وبسبب القيود المفروضة على هذه الطلبات، ننصحك باستخدام الاختبار داخل السياق في واجهة مستخدم تطبيقك.
المتطلبات الأساسية
قبل المتابعة، يُرجى اتّباع الخطوات التالية:
- أكمِل جميع العناصر في قسم
المتطلبات الأساسية لإنشاء حساب على
AdMob وإعداد جهازك الاختباري وإعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
وتثبيت أحدث إصدار.
- تشغيل "فاحص الإعلانات"
طلب إعلان اختباري
لطلب إعلان اختباري في "أداة فحص الإعلانات"، أكمِل الخطوات التالية. لمزيد من التفاصيل، يُرجى الاطّلاع على كيفية استخدام "أداة فحص الإعلانات" في تطبيقك.
ضمن السياق:
- على جهاز اختباري، انتقِل إلى واجهة مستخدم تطبيقك واحمِل إعلانًا.
- افتح "فاحص الإعلان". في علامة التبويب الوحدة الإعلانية، ابحث عن الوحدة الإعلانية التي حمّلت الإعلان فيها.
- في سجلّ طلبات حزمة تطوير البرامج (SDK)، اطّلِع على تفاصيل الإعلان التجريبي الذي طلبته.
Out-of-context:
- في علامة التبويب الوحدة الإعلانية، انقر على وحدتك الإعلانية ثم على طلب إعلان اختباري.
- في سجلّ طلبات حزمة تطوير البرامج (SDK)، اطّلِع على تفاصيل الإعلان التجريبي الذي طلبته.

إذا كان تنسيق الوحدة الإعلانية يعرض غير معروف، سيظهر خيار طلب إعلان اختباري باللون الرمادي.
اختبار مصدر إعلان واحد
يمكن لأداة فحص الإعلانات حصر طلبات الإعلان في تطبيقك على عرض إعلانات من مصدر إعلان واحد مستند إلى عروض الأسعار أو بنظام العرض بدون انقطاع. يتيح لك هذا النهج التأكّد من أنّك نفّذت عملية الدمج بشكلٍ صحيح مع المحوّل التابع لجهة خارجية، وأنّ مصدر الإعلان يعرِض الإعلانات على النحو المتوقع.
لاختبار مصدر إعلان واحد، أكمِل الخطوات التالية:
في أداة فحص الإعلانات، انقر على زر التبديل اختبار مصدر إعلان فردي. يظهر مربّع الحوار اختبار مصدر إعلان فردي:
Android
|
iOS
|
اختَر مصدر إعلان لاختباره. بعد ذلك، ستظهر لك صفحة
فرض إعادة تشغيل التطبيق:

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

في وضع اختبار مصدر الإعلان الفردي، تحاول جميع طلبات الإعلان تعبئة الإعلانات باستخدام مصدر الإعلان المُحدّد، بغض النظر عمّا إذا كان مصدر الإعلان قد تم إعداده لعروض الأسعار أو العرض الإعلاني بدون انقطاع. إذا لم يتم إعداد مصدر الإعلان الذي تختبره للمزايدة أو العرض الإعلاني بدون انقطاع للوحدة الإعلانية، ستتلقّى رسالة الخطأ التالية:
Ad Unit has no applicable adapter for single ad source testing on network: AD_SOURCE_ADAPTER_CLASS_NAME
للتأكّد مما إذا كان مصدر الإعلان قد تمكّن من تعبئة طلبات الإعلان بعد بدء اختبار مصدر إعلان فردي، انقر على وحدة إعلانية للاطّلاع على سجلّ طلبات حزمة تطوير البرامج (SDK). إذا تعذّر على مصدر الإعلان تحميل إعلان، ستظهر رسالة خطأ تصف الخطأ، مثل Adapter failed to initialize
.
في حال أضفت عدّة مثيلات من مصدر الإعلان المُحدّد إلى عرض إعلاني بدون انقطاع، سيظهر لك كل مثيل من الطلب المقدّم إلى مصدر الإعلان. تستمر هذه العملية إلى أن يتم عرض الإعلان أو ينتهي العرض الإعلاني بدون انقطاع من غير تعبئة إعلان.
إيقاف اختبار مصدر إعلان فردي
لإيقاف الاختبار، أكمِل الخطوات التالية:
- في أداة فحص الإعلانات، أوقِف مفتاح اختبار مصدر إعلان فردي. يظهر مربّع الحوار هل تريد إيقاف اختبار مصدر إعلان فردي؟.
انقر على إيقاف الاختبار.

في حال نجاح هذا الإجراء، ستظهر رسالة تأكيد فوق فرض إعادة تشغيل التطبيق:

لإبطال الإعلانات المخزّنة مؤقتًا لمصدر الإعلان الذي تم اختباره، ننصحك بفرض إعادة تشغيل التطبيق بعد إيقاف الاختبار.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-09-06 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-06 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["Select platform: [Android](/admob/android/ad-inspector/test-ad-units \"View this page for the Android platform docs.\") [iOS](/admob/ios/ad-inspector/test-ad-units \"View this page for the iOS platform docs.\") [Unity](/admob/unity/ad-inspector/test-ad-units \"View this page for the Unity platform docs.\") [Flutter](/admob/flutter/ad-inspector/test-ad-units \"View this page for the Flutter platform docs.\")\n\n\u003cbr /\u003e\n\nAd inspector supports the following tests:\n\n- **In-context testing**: load ads from the ad units in your app. You can open ad inspector to view details on requests made from ad units.\n- **Out-of-context testing**: test your ad unit directly in ad inspector without navigating to your app's UI. You can test multiple ad units at once, asynchronously load and view your test ad requests, and perform single ad source tests.\n\nWhen running an out-of-context test, your requests don't carry the parameters\nto run in your app's UI, including child-directed treatment configuration,\ncustom targeting, network extras, and different sizes. Due to the limitation of\nthese requests, we recommend you use in-context testing in your app's UI.\n\nPrerequisites\n\nBefore you continue, do the following:\n\n- Complete all items in the initial [Prerequisites](/admob/flutter/ad-inspector#prerequisites) to create an AdMob account, set your test device, initialize Google Mobile Ads SDK, and install the latest version.\n- [Launch ad inspector](/admob/flutter/ad-inspector/launch-ad-inspector).\n\nRequest a test ad\n\nTo request a test ad in ad inspector, complete the following steps. For more\ndetails, see\n\n[How to use ad inspector in your app](//support.google.com/admob/answer/13063114).\n\n\n- **In-context**:\n\n 1. On a test device, navigate to your app's UI and load an ad.\n 2. Open ad inspector. In the **Ad unit** tab, find the ad unit where you loaded the ad.\n 3. In **SDK request log**, view details on your requested test ad.\n- **Out-of-context**:\n\n 1. In the **Ad unit** tab, tap on your ad unit and click **Request test ad**.\n 2. In **SDK request log**, view details on your requested test ad.\n\nIf the ad unit format shows **Unknown** , you see **Request test ad** greyed\nout.\n\nTest a single ad source\n\nAd inspector can restrict ad requests in your app to serve ads from a single\nbidding or waterfall ad source. This approach lets you verify that you've\ncorrectly integrated with the third-party adapter, and the ad source serves\nas expected.\n\nTo test a single ad source, complete the following steps:\n\n1. In **Ad inspector** , click the **Single ad source test** toggle. A\n **Single ad source test** dialog appears:\n\n\n |---------|-----|\n | Android | iOS |\n\n \u003cbr /\u003e\n\n\n2. Select an ad source to test. Afterwards, you receive the\n **Force restart app** page:\n\nThe single ad source test setting applies to any future ad requests you make.\nThis test doesn't apply to previously cached ads in that session.\nWe recommend you to force restarting your app when applying a single ad source\ntest. This approach invalidates cached ads that might display instead of\nyour chosen ad source receiving a request.\n\nAfter restarting your app, all ad unit placements attempt to show an ad from the\nselected ad source. Launching ad inspector when a single ad source test is\nactive shows the active test ad source:\n\nIn single ad source test mode, all ad requests attempt to fill with the\nselected ad source, regardless of whether that ad source was configured for\nbidding or waterfall. If the ad source you're testing is not set up for bidding\nor waterfall for the ad unit, you receive the following error message: \n\n Ad Unit has no applicable adapter for single ad source testing on network: \u003cvar translate=\"no\"\u003eAD_SOURCE_ADAPTER_CLASS_NAME\u003c/var\u003e\n\nTo verify whether the ad source filled the ad requests after you start a single\nad source test, tap an ad unit to view the SDK request log. If the ad source\nfailed to load an ad, an error message appears describing the error, such\nas `Adapter failed to initialize`.\n\nIf you've added multiple instances of the selected ad source to a waterfall, you\nsee each call instance to the ad source. This process renders until the ad is\neither filled or the waterfall ends without a fill.\n\nStop a single ad source test\n\nTo stop the test, complete the following steps:\n\n1. In **Ad inspector** , click off the **Single ad source test** toggle. The **Stop single ad source test?** dialog appears.\n2. Tap **Stop test**.\n\n\n If successful, a confirmation message appears over **Force restart app**:\n\nTo revoke cached ads for the tested ad source, we recommend you to force\nrestart the app after stopping the test."]]