با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این راهنما نحوه اشکالزدایی سرویس تبلیغات را با استفاده از پیشنمایش درونبرنامه و ابزارهای تحویل Ad Manager نشان میدهد.
پیشنمایش درونبرنامه به شما امکان میدهد خلاقیتهای خود را که در برنامه تلفن همراهتان ارائه شدهاند، بررسی کنید. این پیشنمایش بهویژه زمانی مفید است که خلاقیتهایی دارید که با برنامه تعامل دارند، رفتار منحصربهفردی دارند یا برای برخی رندرها به برنامه تکیه میکنند (از جمله خلاقیتهای بومی و MRAID).
ابزارهای تحویل Ad Manager اطلاعاتی را در مورد تبلیغات ارائه می دهد. بنابراین هنگامی که تبلیغات غیرمنتظره ارائه می شود، از ابزارهای تحویل استفاده کنید تا دلیل آن را بیابید.
اشکال زدایی نیاز به تعامل با منوی گزینه های اشکال زدایی SDK دارد. روش پیشنهادی برای باز کردن منو این است که تابع زیر را در برنامه خود قرار دهید و آن را بر اساس عملکرد کاربر فعال کنید:
هر واحد تبلیغاتی معتبر از حساب Ad Manager شما برای باز کردن منوی گزینههای اشکالزدایی کافی است.
راه دیگر برای باز کردن منو این است که یک فشار طولانی با دو انگشت روی خلاقیت انجام دهید، اما این کار برای همه قالبهای تبلیغاتی، مانند تبلیغات بومی، کار نمیکند، و باید مراقب باشید که هنگام تلاش برای کشیدن انگشت، روی تبلیغ کلیک نکنید. فراخوانی روش قبلی بسیار قوی تر است.
دستگاه خود را پیوند دهید
پس از افزودن قابلیت باز کردن منوی گزینه های اشکال زدایی، برنامه خود را اجرا کرده و عملکرد را فعال کنید. منوی زیر باز می شود:
برای پیوند دادن دستگاه خود، پیشنمایش خلاق را انتخاب کنید. یک مرورگر باز می شود و به طور خودکار شما را به یک مرورگر هدایت می کند تا وارد Ad Manager شوید. پس از ورود به سیستم، نام دستگاه خود را بگذارید تا آن را در حساب Ad Manager خود ثبت کنید. سپس بر روی تأیید کلیک کنید.
پس از فشار دادن یک خلاقیت از رابط کاربری، دوباره منوی گزینه های اشکال زدایی را در دستگاه خود فعال کنید و یک بار دیگر Creative Preview را انتخاب کنید. این مرحله به SDK امکان میدهد Ad Manager را بررسی کند تا تأیید کند که پیوند دستگاه با موفقیت انجام شده است و اطلاعاتی در مورد اینکه کدام خلاقیت را تحت فشار قرار دادهاید دریافت کند. اگر پیوند دستگاه قبلاً موفقیت آمیز بود، منوی اشکال زدایی بلافاصله بسته می شود. اگر ناموفق بود، از شما خواسته می شود که حساب خود را دوباره پیوند دهید.
در نهایت، یک تبلیغ برای شکافی که میخواهید پیشنمایش کنید، بارگذاری کنید تا خلاقیت خود را ببینید.
ابزار تحویل
برای عیبیابی تحویل آگهی خود، مراحل Inspect delivery در Ad Manager را دنبال کنید. اگر مراحل را با موفقیت انجام داده باشید، درخواست در رابط کاربری Ad Manager نشان داده میشود و میتوانید اطلاعات بیشتری درباره آگهی ارائه شده مشاهده کنید.
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-03 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis guide helps you debug ad serving in your mobile app using in-app preview and Ad Manager delivery tools.\u003c/p\u003e\n"],["\u003cp\u003eIn-app preview lets you test your own creatives within your app, while delivery tools provide insight into ad delivery issues.\u003c/p\u003e\n"],["\u003cp\u003eTo use these tools, you'll need to integrate the Google Mobile Ads SDK, link your device to your Ad Manager account, and then trigger the debug menu in your app.\u003c/p\u003e\n"],["\u003cp\u003eYou can then push specific creatives to your linked device for previewing, or use delivery tools to diagnose unexpected ad behavior.\u003c/p\u003e\n"]]],[],null,["This guide shows how to debug ad serving using in-app preview and the Ad Manager\ndelivery tools.\n\n[In-app preview](//support.google.com/admanager/answer/7160685) lets you inspect\nyour own creatives rendered within your mobile app. This preview is especially\nuseful if you have creatives that interact with the app, have unique behavior,\nor rely on the app for some rendering (including native creatives and MRAID).\n\nThe [Ad Manager delivery tools](//support.google.com/admanager/answer/7449957)\ngive information on which ads were delivered; so when unexpected ads deliver,\nuse the delivery tools to find out why.\n\nPrerequisites\n\n- Version 10.2.0 or higher of the Google Mobile Ads SDK.\n\n- Access to a Google Ad Manager account.\n- Complete the [Get started guide](/ad-manager/mobile-ads-sdk/android/quick-start).\n\nPrepare your app\n\nDebugging requires interaction with the SDK's debug options menu. The\nrecommended way to open the menu is to include the following function in your\napp, and trigger it based on a user action: \n\nJava \n\n```java\npublic class MainActivity extends AppCompatActivity {\n\n ...\n\n @Override\n protected void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n setContentView(R.layout.activity_main);\n\n // Initialize the Mobile Ads SDK.\n MobileAds.initialize(this);\n }\n\n ...\n\n // Opens a debug menu. Call this method based on a user action.\n // Replace YOUR_AD_UNIT_ID with your own ad unit ID.\n public void openDebugMenu() {\n MobileAds.openDebugMenu(this, \"YOUR_AD_UNIT_ID\");\n }\n}\n```\n\nKotlin \n\n```kotlin\nclass MainActivity : AppCompatActivity() {\n\n ...\n\n override fun onCreate(savedInstanceState: Bundle?) {\n super.onCreate(savedInstanceState)\n setContentView(R.layout.activity_main)\n\n // Initialize the Mobile Ads SDK.\n MobileAds.initialize(this)\n }\n\n ...\n\n // Opens a debug menu. Call this method based on a user action.\n // Replace YOUR_AD_UNIT_ID with your own ad unit ID.\n fun openDebugMenu() {\n MobileAds.openDebugMenu(this, \"YOUR_AD_UNIT_ID\")\n }\n}\n```\n\n\u003cbr /\u003e\n\n| **Key Point:** `MobileAds.initialize()` must be called before `MobileAds.openDebugMenu()`.\n\nAny valid ad unit from your Ad Manager account is sufficient to open the debug\noptions menu.\n\nAnother way to open the menu is to do a [long two-finger\npress](//support.google.com/admanager/answer/7180401) on the creative, but this\ndoesn't work for all ad formats, such as native ads, and you must be careful not\nto click the ad when attempting to swipe. Calling the previous method is much\nmore robust.\n\nLink your device\n\nAfter adding the capability to open the debug options menu, run your app and\ntrigger the function. The following menu opens:\n\nSelect **Creative Preview** to link your device. A browser opens and\nautomatically navigates you to a browser to sign in to Ad Manager. After signing\nin, name your device to register it with your Ad Manager account. Then click\n**Verify**.\n\nAt this point, you can verify that your device has been linked in the [Ad\nManager UI](//admanager.google.com/home/). You can also [let others access your\ndevices](//support.google.com/admanager/answer/7160685#make-public).\n\nIn-app preview\n\nFollow the steps to [push a creative to your linked\ndevice](//support.google.com/admanager/answer/7160685#push). Make sure that the\npushed creative is part of an active line item targeted to the ad slot where you\nwant the creative.\n\nAfter pushing a creative from the UI, trigger the debug options menu on your\ndevice again and select **Creative Preview** once more. This step lets the SDK\ncheck Ad Manager to verify that the device linking was successful and to get\nsome information about which creative you pushed. If device linking was\npreviously successful, the debug menu closes immediately. If it was\nunsuccessful, you're prompted to link your account again.\n\nFinally, load an ad for the slot you want to preview to see your creative.\n\nDelivery tools\n\nFollow the steps in [Inspect delivery in Ad\nManager](//support.google.com/admanager/answer/7180401#inspect-in-ui) to\ntroubleshoot your ad delivery. If you've completed the steps successfully, the\nrequest shows up in the Ad Manager UI and you can view more info about the ad\nthat served."]]