اختبار أنواع تصميمات الإعلانات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختيار النظام الأساسي:
Android
iOS
توفّر حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" واجهة برمجة تطبيقات تتيح لك تحديد نوع تصميم إعلان لطلبات الاختبار. عند ضبط المَعلمة، يتم استرداد المواد الإبداعية من النوع المحدّد وعرضها فقط.
الاستخدام
لتحديد نوع مادة إبداعية، أدرِج المَعلمة ft_ctype في كائن إضافات
وامررها إلى طلب الإعلان. وقد يؤدي ذلك إلى حصر الإعلانات المتاحة وعدم عرض أي إعلان.
Kotlin
val extras = Bundle()
extras.putString("ft_ctype", "video_app_install")
val request = AdRequest
.Builder()
.addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
.build()
Java
Bundle extras = new Bundle();
extras.putString("ft_ctype", "video_app_install");
AdRequest request = new AdRequest
.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build();
يعرض الجدول التالي القيم الصالحة لـ ft_ctype:
| نوع تصميم الإعلان |
ft_ctype |
التنسيق |
| HTML5 |
html5 |
إعلان بانر وإعلان بيني وإعلان مقابل مكافأة |
| صورة إعلان تثبيت التطبيق |
image_app_install |
إعلان بانر، إعلان مدمج مع المحتوى، إعلان بيني، إعلان مقابل مكافأة |
| الصورة المعروضة |
image_display |
بانر، إعلان بيني |
| عرض شريحة جزئية |
partial_slot |
إعلان بانر وإعلان مدمج مع المحتوى وإعلان بيني |
| نص إعلان تثبيت التطبيق |
text_app_install |
إعلان بانر وإعلان مدمج مع المحتوى وإعلان بيني |
| النص الذي يظهر للمستخدم |
text_display |
إعلان بانر وإعلان مدمج مع المحتوى وإعلان بيني |
| TrueView |
trueview |
بيني، مقابل مكافأة |
| فيديو لتثبيت تطبيق |
video_app_install |
إعلان بانر، إعلان مدمج مع المحتوى، إعلان بيني، إعلان مقابل مكافأة |
تؤثّر هذه الميزة في إعلانات Google فقط. إذا كانت وحدتك الإعلانية تتيح التوسّط، لن تلتزم الإعلانات المعروضة من مصادر إعلانات تابعة لجهات خارجية بالمعلّمة ft_ctype. ننصحك بإجراء الاختبار باستخدام وحدة إعلانية غير مفعَّلة فيها ميزة التوسّط.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Mobile Ads SDK allows you to specify a desired creative type for test queries, ensuring only creatives of that type are retrieved and rendered.\u003c/p\u003e\n"],["\u003cp\u003eTo use this feature, set the \u003ccode\u003eft_ctype\u003c/code\u003e request parameter within a bundle of extras in test mode, specifying the desired creative type like "video_app_install" or "html5".\u003c/p\u003e\n"],["\u003cp\u003eThis feature works with various creative types, formats, and ad units, as detailed in the provided table mapping creative types to their corresponding \u003ccode\u003eft_ctype\u003c/code\u003e values.\u003c/p\u003e\n"],["\u003cp\u003eWhile useful for testing, using \u003ccode\u003eft_ctype\u003c/code\u003e may increase the chance of no fills and only affects Google ads, not those from third-party ad networks through mediation.\u003c/p\u003e\n"]]],["The Google Mobile Ads SDK allows specifying a creative type for test ad queries using the `ft_ctype` parameter within an extras object, passed to the ad request. This restricts ads to the defined type, potentially resulting in no fill. Valid `ft_ctype` values include `html5`, `image_app_install`, `video_app_install`, and others, each with supported formats (e.g., Banner, Interstitial). This parameter only works in test mode and impacts only Google ads, not third-party ads from mediated sources.\n"],null,["# Test creative types\n\nSelect platform: [Android](/admob/android/test-creative-types \"View this page for the Android platform docs.\") [iOS](/admob/ios/test-creative-types \"View this page for the iOS platform docs.\")\n\n\u003cbr /\u003e\n\n\nGoogle Mobile Ads SDK\n\nprovides an API that lets you specify a creative type\nfor test queries. When the parameter is set, only creatives of the specified\ntype are retrieved and rendered.\n\nUsage\n-----\n\nTo specify a creative type, include the `ft_ctype` parameter in an extras object\nand pass it to the ad request. This may restrict which ads are available and\nresult in no fill.\n**Note:** The `ft_ctype` parameter only works in [Test Mode](/admob/android/test-ads#enable_test_devices). \n\n### Kotlin\n\n val extras = Bundle()\n extras.putString(\"ft_ctype\", \"video_app_install\")\n\n val request = AdRequest\n .Builder()\n .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)\n .build()\n\n### Java\n\n Bundle extras = new Bundle();\n extras.putString(\"ft_ctype\", \"video_app_install\");\n\n AdRequest request = new AdRequest\n .Builder()\n .addNetworkExtrasBundle(AdMobAdapter.class, extras)\n .build();\n\nThe following table lists the valid values for `ft_ctype`:\n\n| Creative Type | ft_ctype | Format |\n|----------------------|-------------------|----------------------------------------|\n| HTML5 | html5 | Banner, Interstitial, Rewarded |\n| App install image | image_app_install | Banner, Native, Interstitial, Rewarded |\n| Display image | image_display | Banner, Interstitial |\n| Display partial slot | partial_slot | Banner, Native, Interstitial |\n| App install text | text_app_install | Banner, Native, Interstitial |\n| Display text | text_display | Banner, Native, Interstitial |\n| Trueview | trueview | Interstitial, Rewarded |\n| App install video | video_app_install | Banner, Native, Interstitial, Rewarded |\n\nThis feature impacts Google ads only. If your ad unit enables\n[mediation](/admob/android/mediation), ads returned from third-party ad sources don't\nrespect the `ft_ctype` parameter. We recommend testing with an ad unit that\ndoesn't have mediation enabled."]]
