با استفاده از Ad Inspector می توانید:
- واحدهای تبلیغاتی خود را بررسی کنید
- بررسی کنید که آیا تبلیغات شما همانطور که انتظار می رود پر می شود یا خیر
- خطاها را شناسایی کنید و جزئیات مربوط به نحوه رفع آنها را مشاهده کنید
- جزئیات هر شبکه آگهی مناقصه باز را در هر درخواست مشاهده کنید
- مشاهده جزئیات میانجی برای هر شبکه تبلیغاتی در هر درخواست
- منابع آگهی مناقصه باز یا واسطه آبشار شخص ثالث را آزمایش کنید
- بررسی کنید که هر واحد تبلیغاتی را برای مناقصه باز و میانجی گری آبشار به درستی پیکربندی کرده اید
این راهنما نحوه راه اندازی و استفاده از ویژگی های مختلف در بازرس آگهی را نشان می دهد.
پیش نیازها
برای استفاده از Ad Inspector باید:
- راهنمای شروع را کامل کنید.
- از Google Mobile Ads SDK نسخه 20.2.0 یا بالاتر استفاده کنید.
- حالت تست را فعال کنید یا دستگاه خود را به Ad Manager پیوند دهید . بازرس آگهی فقط در دستگاه های آزمایشی یا مرتبط راه اندازی می شود.
بازرس آگهی را راه اندازی کنید
Ad inspector را می توان از هر نقطه ای از برنامه شما به روش های زیر راه اندازی کرد:
- از دکمه راه اندازی از منوی اشکال زدایی استفاده کنید.
- از حرکتی که در تنظیمات بازرس آگهی انتخاب کرده اید استفاده کنید.
- به صورت برنامه نویسی با استفاده از API ارائه شده .
با استفاده از منوی اشکال زدایی راه اندازی کنید
برای راه اندازی بازرس آگهی از طریق منوی اشکال زدایی، نیازی به تغییر در برنامه شما نیست. فقط یک تبلیغ را پیدا کنید که توسط شبکه Ad Manager شما ارائه می شود و با دو انگشت آن را لمس کنید و نگه دارید تا منوی اشکال زدایی باز شود. سپس، Open ad inspector را انتخاب کنید.
اگر دستگاه خود را پیوند ندادهاید، ممکن است از شما خواسته شود به حساب Ad Manager خود وارد شوید.
همچنین میتوانید تنظیمات Ad inspector را از تنظیمات اشکالزدایی انتخاب کنید و حرکتی را انتخاب کنید که بتواند بازرس آگهی را در آینده بدون نیاز به رفتن از منوی اشکالزدایی باز کند.
به صورت برنامه ای راه اندازی کنید
Ad Inspector همچنین می تواند به صورت برنامه ریزی شده راه اندازی شود:
جاوا
MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
public void onAdInspectorClosed(@Nullable AdInspectorError error) {
// Error will be non-null if ad inspector closed due to an error.
}
});
کاتلین
MobileAds.openAdInspector(context) { error ->
// Error will be non-null if ad inspector closed due to an error.
}
این API برای دستگاههای آزمایشی کهبه صورت برنامه ای.
مشاهده و عیب یابی واحدهای تبلیغاتی
پس از راهاندازی، صفحه اصلی بازرس آگهی ظاهر میشود که حاوی فهرستی از همه واحدهای تبلیغات از زمانی که بازرس آگهی در این جلسه برنامه فعال شده بود، دستگاه درخواستهای تبلیغاتی را برای آن ارسال کرده است. این فهرست همچنین شامل واحدهای تبلیغاتی با مناقصه باز فعال است که به ترتیب زمانی با بیشترین درخواستهای اخیر تکمیلشده در ابتدا و مواردی که هیچ درخواست آگهی تکمیلشدهای ندارند (کمرنگ) مرتب شدهاند:
توصیه میکنیم قبل از استفاده از بازرس آگهی ، SDK تبلیغات موبایلی Google را مقداردهی اولیه کنید .
جزئیات آبشار میانجی را برای یک واحد تبلیغاتی مشاهده کنید
روی یک واحد تبلیغات ضربه بزنید تا گزارش درخواست SDK آن را مشاهده کنید، که جزئیات مربوط به آبشار میانجی را تا زمانی که آگهی پر شد (یا آبشار بدون پر شده به پایان رسید) را برای آخرین درخواستهای آگهی ارائه میدهد.
هر درخواست را می توان با استفاده از نشانگر افشا گسترش داد تا نتایج آبشار میانجی را برای آن درخواست به همراه هر خطا و تاخیری که برای آن درخواست اعمال می شود نشان دهد.
برای منابع تبلیغاتی شخص ثالث، پیام های خطا مستقیماً از منبع تبلیغ ارسال می شود. اگر به اطلاعات بیشتری نیاز دارید، با منبع آگهی شخص ثالث خود مشورت کنید.
مشاهده جزئیات مناقصه برای یک واحد تبلیغاتی
اگر در مناقصه باز تازه کار هستید، مقدمه مناقصه باز را بخوانید.
در گزارش درخواست SDK، میتوانید منابع تبلیغاتی Open Bidding ببینید که در درخواست آگهی فراخوانی میشوند. برای مشاهده جزئیات هر منبع تبلیغ در حراج Open Bidding روی یک واحد تبلیغات در گزارش درخواست SDK ضربه بزنید.
نتایج Open Bidding به منظور نزدیک کردن موارد قابل اجرا به بالای لیست مرتب شده اند:
در بالای صفحه، شبکه تبلیغاتی برنده حراج است.
شبکه های تبلیغاتی بعدی با مشکلاتی هستند. برای مشکلات میتوانید مراحل عیبیابیبرای مشکلات موجود در انتهای سؤالات متداول Open Bidding .
سپس، شبکههای تبلیغاتی هستند که هیچ آگهی بازگردانده نشدهاند یا پیشنهادی ندادهاند. این یک نشانگر احتمالی بسیاری از مسائل مختلف با منبع آگهی است زیرا ممکن است به دلیل تنظیم یا تصمیم گیری آن پیشنهاد قیمت نداشته باشد. میتوانید به راهنمای تنظیم منبع آگهی مراجعه کنید یاسؤالات متداول مناقصه باز برای پشتیبانی بیشتر.
در نهایت، در انتهای لیست، شبکه های تبلیغاتی هستند که حراجOpen Bidding را از دست داده اند.
آبشار میانجی میتواند منبع تبلیغی را که برنده حراجOpen Bidding شده است، بر اساس ارزش eCPM خود قرار دهد.
یک آبشار میانجی نتیجه رقابت گروه های بازده متعدد برای موجودی یکسان است. میتوانید تا ده شریک بازدهی شخص ثالث را به یک گروه بازدهی اضافه کنید، از جمله شرکای بازدهی در مناقصه باز و میانجیگری برای شرکای بازدهی برنامههای تلفن همراه.
اشکال زدایی پیشرفته واحد تبلیغات
هنگام عیبیابی واحدهای تبلیغاتی، جستجو در درخواست و پاسخ آگهی برای شناسایی جایی که مشکلی وجود دارد، یا اشتراکگذاری با پشتیبانی Google برای کمک به رفع اشکال میتواند مفید باشد. روی نماد منو در بالای زنجیره آبشار ضربه بزنید و اشتراکگذاری درخواست و پاسخ آگهی را انتخاب کنید تا درخواست و پاسخ کامل آگهی صادر شود. این کار شما را از مشکل اجرای ردیابی های شبکه در برنامه خود نجات می دهد.
علاوه بر این، می توانید با ضربه زدن روی گزینه پارامتر مناقصه شخص ثالث در همان منوی رشته درخواست، پارامترهای مناقصه شخص ثالث رمزگشایی شده را مشاهده کنید. این اطلاعات جزئیات مربوط به پارامترهای پیشنهادی شخص ثالث را ارائه می دهد که ممکن است مشکل داشته باشند، به شما کمک می کند برنامه خود را اشکال زدایی کنید یا تأیید کنید که شبکه با موفقیت سیگنال های خود را جمع آوری می کند.
مشاهده آداپتورهای موجود
برای مشاهده لیستی از همه آداپتورهای شخص ثالث مرتبط با منابع تبلیغاتی در تنظیمات مناقصه یا میانجیگری در برنامه خود، روی تب Adapters کلیک کنید. سپس، کارت ها را برای مشاهده وضعیت اولیه و نسخه های SDK گسترش دهید. همراه با آداپتورهای شخص ثالث پشتیبانی شده، می توانید آداپتورهای رویداد سفارشی را نیز مشاهده کنید. رویدادهای سفارشی به ناشران اجازه میدهد از شبکههای تبلیغاتی استفاده کنند که Ad Managerاز آنها پشتیبانی نمیکند. رویدادهای سفارشی از آداپتورهای شخص ثالث استاندارد در لیست آداپتورها با نام کلاس منحصر به فردشان قابل تشخیص هستند. علاوه بر ارائه اطلاعات نام کلاس و وضعیت، بازرس آگهی همچنین برچسب های اختصاص داده شده به آن رویدادهای سفارشی را در رابط وبAd Manager نمایش می دهد.
درصورتیکه آداپتور پیدا نشد یا مقداردهی اولیه نشد، به.
واحدهای تبلیغاتی خود را آزمایش کنید
اگر میخواهید واحد تبلیغات خود را بدون نیاز به پیمایش به آن در رابط کاربری برنامهتان آزمایش کنید، بازرس آگهی مستقیماً از صفحه جزئیات واحد آگهی از آن پشتیبانی میکند. علاوه بر این، میتوانید چندین واحد تبلیغاتی را بهطور همزمان آزمایش کنید، درخواستهای آگهی آزمایشی خود را بهصورت ناهمزمان بارگیری و مشاهده کنید، و حتی آزمایشهای منبع آگهی را انجام دهید.
تست تبلیغات
آزمایشهای آگهی بازرس آگهی که در این بخش توضیح داده شده است، ابزاری عالی برای تأیید تجربه تبلیغات پایه شما و تأیید پیکربندی میانجیگری شما هنگام استفاده از آزمایش منبع آگهی منفرد است.
وقتی آماده آزمایش واحد تبلیغاتی خود هستید، روی دکمه درخواست آگهی آزمایشی در بالای صفحه بازرس آگهی خود ضربه بزنید تا آزمایش آگهی بازرس آگهی شما فعال شود. سپس نتایج آزمایش در گزارش درخواست SDK در زیر هدر درخواست شده از بازرس آگهی ظاهر می شود.
نحوه استفاده از بازرس آگهی در برنامه خود را بیاموزید
تست منبع آگهی واحد
Ad Inspector دارای قابلیتی است که درخواستهای تبلیغات را در برنامه شما محدود میکند تا فقط از یک منبع آگهی Open Bidding یا آبشار تبلیغاتی را ارائه دهد. این به شما امکان میدهد تأیید کنید که آداپتور شخص ثالث را به درستی پیادهسازی کردهاید و منبع آگهی همانطور که انتظار میرود ارائه میشود.
برای فعال کردن این ویژگی، سوئیچ آزمایش منبع آگهی واحد را در پایین صفحه تغییر دهید. این کادر گفتگوی انتخاب منبع آگهی زیر را نشان می دهد:
قبل از اینکه بتوانید از آزمایش منبع آگهی منفرد استفاده کنید، باید Google Mobile Ads SDK را مقداردهی کنید .
سپس می توانید یک منبع تبلیغاتی را برای آزمایش انتخاب کنید. پس از انتخاب منبع تبلیغ، صفحه زیر ظاهر می شود:
تنظیم آزمایش منبع آگهی واحد برای هر درخواست آگهی بعدی که در همان جلسه ارائه میکنید اعمال میشود. با این حال، برای تبلیغات ذخیره شده قبلی در آن جلسه که هنوز نمایش داده نشده اند، اعمال نمی شود. راهاندازی مجدد اجباری برنامهتان هنگام استفاده از آزمایش منبع آگهی منفرد توصیه میشود تا آگهیهای ذخیرهشده در حافظه پنهان که میتوانستند بهجای اینکه منبع آگهی انتخابی شما درخواست دریافت کند، ارائه شوند، باطل شود.
پس از راهاندازی مجدد برنامه، همه مکانهای واحد تبلیغات سعی میکنند آگهی را فقط از شبکه انتخابشده نشان دهند. راهاندازی بازرس آگهی زمانی که یک آزمایش منبع آگهی واحد فعال است، منبع آگهی آزمایشی فعال را نشان میدهد:
در حالت آزمایش منبع آگهی تک، همه درخواستهای آگهی سعی میکنند با منبع آگهی انتخابشده پر شوند، صرفنظر از اینکه آن منبع آگهی برای مناقصه یا میانجیگری برای واحد آگهی درخواستی پیکربندی شده است. اگر منبع تبلیغی که آزمایش میکنید در آبشار میانجی برای یک واحد تبلیغاتی نباشد، پیام خطای «No fill» دریافت میکنید.
در یک آزمایش منبع آگهی، میتوانید روی یک واحد تبلیغات ضربه بزنید تا گزارش درخواست SDK آن را مشاهده کنید. این به شما امکان میدهد بدانید که آیا منبع آگهی درخواستهای تبلیغاتی را که پس از فعال شدن تست منبع تبلیغ تکنفره انجام شده است، پر کرده است یا خیر. اگر منبع تبلیغ نتوانست تبلیغی را بارگیری کند، یک پیام خطایی ظاهر می شود که خطا را توصیف می کند.
اگر چندین نمونه از منبع تبلیغات انتخابی را به یک آبشار میانجی اضافه کرده باشید، هر نمونه از تماس با منبع آگهی را در آبشار مشاهده خواهید کرد تا زمانی که آگهی پر شود یا آبشار بدون پر شود.
یک آزمایش منبع تبلیغاتی را متوقف کنید
برای توقف آزمایش، سوئیچ را خاموش کنید:
سپس یک پیام تأیید در صفحه راه اندازی مجدد زیر ظاهر می شود:
توصیه میکنیم پس از توقف آزمایش، برنامهتان را مجدداً اجباری راهاندازی کنید تا هر گونه تبلیغات ذخیرهشده در حافظه پنهان منبع آگهی آزمایششده را باطل کنید.
کل خروجی های اشکال زدایی را کپی کنید
بازرس آگهی از کپی کردن یک رشته JSON حاوی کل خروجی های اشکال زدایی از ابزار، از جمله جزئیات برنامهAd Manager ، وضعیت های اولیه آداپتور، و نتایج آزمایش همه واحدهای تبلیغاتی پشتیبانی می کند.
برای انجام این کار، روی نماد برنامه هفت بار ضربه بزنید تا پیام بازرس تبلیغات کپی شده JSON به کلیپ بورد را مشاهده کنید.