این راهنما نحوه فعال کردن تبلیغات آزمایشی را برای ادغام تبلیغات خود توضیح می دهد. توصیه می‌شود در حین توسعه، تبلیغات آزمایشی را فعال کنید تا بتوانید رفتار کلیکی را بدون تأثیر بر آمار کمپین‌های رزرو خود یا کسر هزینه از تبلیغ‌کنندگان در Ad Exchange آزمایش کنید.
سریعترین راه برای فعال کردن آزمایش، استفاده از واحدهای تبلیغات نمایشی ارائه شده توسط Google است. این واحدهای تبلیغاتی با حساب Ad Manager شما مرتبط نیستند، بنابراین هیچ خطری برای ایجاد ترافیک نامعتبر در حساب شما در هنگام استفاده از این واحدهای تبلیغاتی وجود ندارد.
در اینجا واحدهای تبلیغاتی نمایشی هستند که به خلاقیت های آزمایشی خاصی برای هر قالب اشاره می کنند:
نکته کلیدی: این واحدهای تبلیغاتی نمایشی برای ارائه تبلیغات فروش مستقیم در Ad Manager پیکربندی شده‌اند و تبلیغات مستقیم فروش AdChoices را برنمی‌گردانند.
دستگاه های تست را فعال کنید
اگر می‌خواهید آزمایش‌های دقیق‌تری را با تبلیغات تولیدی انجام دهید، اکنون می‌توانید دستگاه خود را به‌عنوان یک دستگاه آزمایشی پیکربندی کنید و از شناسه‌های واحد تبلیغاتی خود که در رابط کاربری Ad Manager ایجاد کرده‌اید استفاده کنید.
مراحل زیر را دنبال کنید تا دستگاه خود را به عنوان یک دستگاه آزمایشی اضافه کنید.
دستگاه تست خود را به صورت برنامه ریزی شده اضافه کنید
برای ثبت دستگاه تست خود مراحل زیر را انجام دهید:
برنامه ادغام شده با تبلیغات خود را بارگیری کنید و درخواست تبلیغات کنید.
خروجی logcat را برای پیامی مشابه پیام زیر بررسی کنید که شناسه دستگاه شما و نحوه اضافه کردن آن را به عنوان یک دستگاه آزمایشی به شما نشان می دهد:
I/Ads: Use RequestConfiguration.Builder.setTestDeviceIds(Arrays.asList("33BE2250B43518CCDA7DE426D04EE231"))
to get test ads on this device."
شناسه دستگاه آزمایشی خود را در کلیپ بورد خود کپی کنید.
شناسه دستگاه آزمایشی خود را جایگزین TEST_DEVICE_ID کنید.
می‌توانید به‌صورت اختیاری isTestDevice() بررسی کنید تا تأیید کنید که دستگاه شما به‌درستی به‌عنوان دستگاه آزمایشی اضافه شده است.
برنامه خود را دوباره اجرا کنید. اگر تبلیغ یک تبلیغ Google باشد، یک برچسب آگهی آزمایشی را در قسمت بالای آگهی (برنما، ویدیوی بینابینی یا پاداش) خواهید دید:
برای تبلیغات پیشرفته بومی، دارایی عنوان با رشته آگهی آزمایشی اضافه می شود.
تبلیغات با این برچسب آگهی آزمایشی قابل کلیک کردن هستند. درخواست‌ها، نمایش‌ها و کلیک‌ها روی تبلیغات آزمایشی در گزارش‌های حساب شما نشان داده نمی‌شوند.
تست با میانجیگری
واحدهای تبلیغاتی نمونه Google فقط Google Ads را نشان می دهد. برای آزمایش پیکربندی میانجیگری، باید از روش فعال کردن دستگاه‌های تست استفاده کنید.
تبلیغات واسطه‌ای برچسب آگهی آزمایشی ارائه نمی‌کنند . شما مسئول اطمینان از فعال بودن تبلیغات آزمایشی برای هر یک از شبکه‌های میانجی شما هستید تا این شبکه‌ها حساب شما را برای فعالیت نامعتبر پرچم‌گذاری نکنند. برای اطلاعات بیشتر، راهنمای میانجیگری مربوط به هر شبکه را ببینید.
اگر مطمئن نیستید که یک آداپتور شبکه تبلیغاتی میانجی از تبلیغات آزمایشی پشتیبانی می‌کند یا خیر، مطمئن‌ترین کار این است که در طول توسعه روی تبلیغات آن شبکه کلیک نکنید. می‌توانید از متد getMediationAdapterClassName() در هر یک از قالب‌های تبلیغاتی استفاده کنید تا بفهمید کدام شبکه تبلیغاتی تبلیغ فعلی را ارائه کرده است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis guide helps you enable test ads in your app during development to avoid impacting campaign stats and accidental charges.\u003c/p\u003e\n"],["\u003cp\u003eYou can use Google-provided demo ad units or configure your own device as a test device for more realistic testing scenarios.\u003c/p\u003e\n"],["\u003cp\u003eWhen using your own ad units, register your device programmatically for testing and remember to remove this configuration before releasing your app.\u003c/p\u003e\n"],["\u003cp\u003eTest ads are clearly labeled, ensuring clicks won't affect your reports; however, mediated ads might not have this label, requiring extra caution.\u003c/p\u003e\n"],["\u003cp\u003eFor mediation testing, enable test ads for each network individually and refer to their respective guides to ensure accurate results and prevent invalid activity flags.\u003c/p\u003e\n"]]],["To enable test ads, use Google-provided demo ad units during development, replacing them with your own before publishing. For more rigorous testing, configure devices as test devices. Programmatically, add devices by retrieving the device ID from logcat, then use `RequestConfiguration.Builder.setTestDeviceIds()` to register it. Test ads will have a \"Test Ad\" label. For mediation, use test devices, as mediated ads lack the label; consult each network's guide and use `getMediationAdapterClassName()` to identify the serving network.\n"],null,["Select platform: [Android](/ad-manager/mobile-ads-sdk/android/test-ads \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/test-ads \"View this page for the iOS platform docs.\") [Unity](/ad-manager/mobile-ads-sdk/unity/test-ads \"View this page for the Unity platform docs.\") [Flutter](/ad-manager/mobile-ads-sdk/flutter/test-ads \"View this page for the Flutter platform docs.\")\n\n\u003cbr /\u003e\n\nThis guide explains how to enable test ads for your ads integration. It's\nrecommended that you enable test ads during development so you can test\nclick-through behavior without affecting your reservation campaigns' stats or\ncharging advertisers on Ad Exchange.\n\n\u003cbr /\u003e\n\nPrerequisite\n\n- Complete [Get Started](/ad-manager/mobile-ads-sdk/android/quick-start).\n\nDemo ad units\n\nThe quickest way to enable testing is to use Google-provided demo ad units.\nThese ad units are not associated with your Ad Manager\naccount, so there's no risk of your account generating invalid traffic when\nusing these ad units.\n| **Key Point:** Make sure you replace these IDs with your own ad unit ID before publishing your app.\n\nHere are demo ad units that point to specific test creatives for each format:\n\n| Ad format | Demo ad unit ID |\n|-----------------------------------------------------------------------------------|----------------------------------------------|\n| [App Open](/ad-manager/mobile-ads-sdk/android/app-open) | `/21775744923/example/app-open` |\n| [Adaptive Banner](/ad-manager/mobile-ads-sdk/android/banner) | `/21775744923/example/adaptive-banner` |\n| [Fixed Size Banner](/ad-manager/mobile-ads-sdk/android/banner/fixed-size) | `/21775744923/example/fixed-size-banner` |\n| [Interstitial](/ad-manager/mobile-ads-sdk/android/interstitial) | `/21775744923/example/interstitial` |\n| [Rewarded Ads](/ad-manager/mobile-ads-sdk/android/rewarded) | `/21775744923/example/rewarded` |\n| [Rewarded Interstitial](/ad-manager/mobile-ads-sdk/android/rewarded-interstitial) | `/21775744923/example/rewarded-interstitial` |\n| [Native](/ad-manager/mobile-ads-sdk/android/native) | `/21775744923/example/native` |\n| [Native Video](/ad-manager/mobile-ads-sdk/android/native/video-ads) | `/21775744923/example/native-video` |\n\nKey Point: These demo ad units are configured to serve direct-sold ads in Ad Manager, and direct-sold ads do not return AdChoices.\n\nEnable test devices\n\nIf you want to do more rigorous testing with production-looking ads, you can\nnow configure your device as a test device and use your own ad unit IDs that\nyou've created in the Ad Manager UI.\n\n\nFollow the steps below to add your device as a test device.\n| **Key Point:** Android emulators are automatically configured as test devices.\n\nAdd your test device programmatically\n\nTo register your test device, complete the following steps:\n\n1. Load your ads-integrated app and make an ad request.\n2. Check the logcat output for a message similar to the following, which shows you your device ID and how to add it as a test device: \n\n ```text\n I/Ads: Use RequestConfiguration.Builder.setTestDeviceIds(Arrays.asList(\"33BE2250B43518CCDA7DE426D04EE231\"))\n to get test ads on this device.\"\n ```\n Copy your test device ID to your clipboard.\n3. Modify your code to call\n\n [`RequestConfiguration.Builder.setTestDeviceIds()`](/ad-manager/mobile-ads-sdk/android/reference/com/google/android/gms/ads/RequestConfiguration.Builder#setTestDeviceIds(java.util.List%3Cjava.lang.String%3E))\n\n and pass in a list of your test device IDs.\n\n Java \n\n List\u003cString\u003e testDeviceIds = Arrays.asList(\"\u003cvar translate=\"no\"\u003eTEST_DEVICE_ID\u003c/var\u003e\");\n RequestConfiguration configuration =\n new RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build();\n MobileAds.setRequestConfiguration(configuration); \n https://github.com/googleads/googleads-mobile-android-examples/blob/ccc290a583d7f552bdcf81ea76adc05beaa43f0b/java/advanced/APIDemo/app/src/main/java/com/google/android/gms/snippets/RequestConfigurationSnippets.java#L15-L18\n\n Kotlin \n\n val testDeviceIds = listOf(\"\u003cvar translate=\"no\"\u003eTEST_DEVICE_ID\u003c/var\u003e\")\n val configuration = RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build()\n MobileAds.setRequestConfiguration(configuration) \n https://github.com/googleads/googleads-mobile-android-examples/blob/ccc290a583d7f552bdcf81ea76adc05beaa43f0b/kotlin/advanced/APIDemo/app/src/main/java/com/google/android/gms/snippets/RequestConfigurationSnippets.kt#L27-L29\n\n Replace \u003cvar translate=\"no\"\u003eTEST_DEVICE_ID\u003c/var\u003e with your test device ID.\n\n You can optionally check\n\n [`isTestDevice()`](/ad-manager/mobile-ads-sdk/android/reference/com/google/android/gms/ads/AdRequest#isTestDevice(android.content.Context))\n\n to confirm that your device was properly added as a test device.\n | **Caution:** Be sure to remove the code that sets these test device IDs before you release your app.\n4. Re-run your app. If the ad is a Google ad, you'll see a **Test Ad** label\n centered at the top of the ad (banner, interstitial, or rewarded video):\n\n | **Note:** To see the **Test Ad** label, you need to be using an SDK version of 11.6.0 or higher.\n\n For native advanced ads, the headline asset is prepended with the string **Test Ad**.\n\nAds with this **Test Ad** label are safe to click. Requests, impressions, and\nclicks on test ads won't show up in your account's reports.\n| **Note:** Mediated ads do *NOT* render a **Test Ad** label. See the following section for details.\n\nTesting with mediation\n\nGoogle's sample ad units only show Google Ads. To test your\n\nmediation configuration,\nyou must use the [enable test devices](#enable_test_devices)\napproach.\n\nMediated ads do *NOT* render a Test Ad label. You are responsible for\nensuring that test ads are enabled for each of your mediation networks so these\nnetworks don't flag your account for invalid activity. See each network's\nrespective [mediation guide](/ad-manager/mobile-ads-sdk/android/mediation)\nfor more information.\n\nIf you aren't sure whether a mediation ad network adapter supports test ads, it\nis safest to avoid clicking on ads from that network during development. You\ncan use the\n\n[`getMediationAdapterClassName()`](/ad-manager/mobile-ads-sdk/android/reference/com/google/android/gms/ads/ResponseInfo#getMediationAdapterClassName())\n\nmethod on any of the ad formats to figure out which ad network served the\ncurrent ad."]]
