این راهنما نحوه راهاندازی و استفاده از ویژگیهای مختلف در ad inspector را نشان میدهد.
پیشنیازها
برای استفاده از بازرس تبلیغات، باید:
- راهنمای شروع به کار را تکمیل کنید.
- از نسخه ۹.۱.۰ یا بالاتر SDK تبلیغات موبایلی گوگل استفاده کنید.
- دستگاه خود را به عنوان دستگاه آزمایشی اضافه کنید . بازرس تبلیغات فقط روی دستگاههای آزمایشی اجرا میشود.
بازرس تبلیغات را راهاندازی کنید
بازرس تبلیغات (Ad inspector) را میتوان از هر جایی در برنامه شما به روشهای زیر اجرا کرد:
- هنگام ثبت یک دستگاه آزمایشی، از ژست انتخاب شده در رابط کاربری AdMob استفاده کنید.
- از طریق برنامهنویسی و با استفاده از API ارائه شده .
- از دکمهی راهاندازی در منوی اشکالزدایی استفاده کنید.
راهاندازی با استفاده از حرکات
برای اجرای بازرس تبلیغات با یک اشاره، نیازی به تغییر در برنامه شما نیست؛ فقط اشارهای (دو بار تکان دادن یا لرزش) را که در AdMob برای آن دستگاه آزمایشی پیکربندی کردهاید، اجرا کنید. اطلاعات بیشتر
پس از تنظیم یک حرکت در رابط کاربری AdMob (و انتظار ۱۵ دقیقهای برای انتشار آن)، برنامه شما باید یک درخواست تبلیغ برای SDK تبلیغات موبایل گوگل ارسال کند تا تنظیمات حرکت شما را بشناسد. اگر حرکت مشخص شده شما کار نمیکند، یک تبلیغ را بارگذاری کنید، برنامه خود را مجدداً راهاندازی کنید و دوباره حرکت را آزمایش کنید.
راهاندازی به صورت برنامهنویسیشده
بازرس تبلیغات همچنین میتواند به صورت برنامهنویسی شده راهاندازی شود:
این API برای دستگاههای آزمایشی که به صورت برنامهنویسی یا در رابط کاربری AdMob ثبت شدهاند، کار میکند.
مشاهده و عیبیابی واحدهای تبلیغاتی
پس از اجرا، صفحه اصلی بازرس تبلیغات ظاهر میشود که شامل فهرستی از تمام واحدهای تبلیغاتی در رابط کاربری AdMob مرتبط با شناسه برنامه AdMob شما است که دارای پیکربندیهای پیشنهاد قیمت یا میانجیگری هستند:
توصیه میکنیم قبل از استفاده از ad inspector، کیت توسعه نرمافزاری تبلیغات موبایلی گوگل (Google Mobile Ads SDK) را راهاندازی اولیه کنید .
جزئیات آبشار میانجیگری را برای یک واحد تبلیغاتی مشاهده کنید
برای مشاهده گزارش درخواست SDK یک واحد تبلیغاتی، روی آن ضربه بزنید. این گزارش جزئیاتی در مورد روند میانجیگری تا زمانی که تبلیغ پر شده است (یا روند بدون پر شدن تمام شده است) برای آخرین درخواستهای تبلیغاتی ارائه میدهد.
هر درخواست را میتوان با استفاده از نشانگر افشا گسترش داد تا نتایج آبشار میانجیگری برای آن درخواست، به همراه هرگونه خطا و تأخیری که برای آن درخواست وجود داشته است، نشان داده شود.
برای منابع تبلیغاتی شخص ثالث، پیامهای خطا مستقیماً از منبع تبلیغاتی ارسال میشوند. اگر به اطلاعات بیشتری نیاز دارید، با منبع تبلیغاتی شخص ثالث خود مشورت کنید.
جزئیات پیشنهاد قیمت برای یک واحد تبلیغاتی را مشاهده کنید
اگر در زمینه پیشنهاد قیمت تازهکار هستید، بخش مرور کلی را مطالعه کنید.
در گزارش درخواست SDK، میتوانید منابع تبلیغاتی پیشنهاد دهندهای را که در درخواست تبلیغ فراخوانی شدهاند، مشاهده کنید. برای مشاهده جزئیات هر منبع تبلیغاتی در مزایده پیشنهاد دهنده، روی یک واحد تبلیغاتی در گزارش درخواست SDK ضربه بزنید.
نتایج پیشنهاد قیمت به گونهای مرتب شدهاند که موارد قابل اجرا به بالای لیست نزدیکتر شوند:
در بالا، شبکه تبلیغاتی برنده مزایده قرار دارد.
در مرحله بعد شبکههای تبلیغاتی دارای مشکل هستند. میتوانید مراحل عیبیابی را برای مشکلات دنبال کنید.
سپس، شبکههای تبلیغاتی وجود دارند که هیچ تبلیغی برایشان ارسال نشده یا پیشنهادی ارائه نکردهاند. این میتواند نشاندهندهی مشکلات مختلف زیادی در منبع تبلیغاتی باشد، زیرا ممکن است به دلیل تنظیمات یا تصمیمگیری، پیشنهادی ارائه نداده باشد. میتوانید به راهنمای تنظیمات منبع تبلیغاتی مراجعه کنید یا برای پشتیبانی مستقیماً با منبع تبلیغاتی تماس بگیرید .
در نهایت، در انتهای لیست، شبکههای تبلیغاتی هستند که در مزایده شکست خوردند.
آبشار میانجیگری میتواند منبع تبلیغاتی که در مزایده برنده شده است را بر اساس ارزش eCPM آنها قرار دهد.
وقتی یک منبع تبلیغاتی در آبشار میانجیگری فراخوانی میشود، میتواند تبلیغات ارائه دهد. برای کسب اطلاعات بیشتر در مورد نحوه عملکرد پیشنهاد قیمت با آبشار میانجیگری، به مثال ۲ و مثال ۳ از منابع تبلیغاتی پیشنهاد قیمت و آبشاری در یک گروه میانجیگری مراجعه کنید.
اشکالزدایی پیشرفته واحد تبلیغاتی
هنگام عیبیابی واحدهای تبلیغاتی، بررسی دقیق درخواست و پاسخ تبلیغات برای شناسایی محل نقص یا به اشتراک گذاشتن آن با پشتیبانی گوگل برای کمک به اشکالزدایی میتواند مفید باشد. روی نماد منو در بالای زنجیره آبشاری ضربه بزنید و گزینه اشتراکگذاری درخواست و پاسخ تبلیغات را انتخاب کنید تا درخواست و پاسخ کامل تبلیغات را صادر کنید. این کار شما را از دردسر اجرای ردیابیهای شبکه در برنامه خودتان نجات میدهد.
علاوه بر این، میتوانید پارامترهای مناقصه شخص ثالث رمزگشاییشده را با ضربه زدن روی گزینه پارامتر مناقصه شخص ثالث در همان منوی رشته درخواست مشاهده کنید. این کار جزئیاتی در مورد اینکه کدام پارامترهای مناقصه شخص ثالث ممکن است مشکل داشته باشند، ارائه میدهد و به شما کمک میکند تا برنامه خود را اشکالزدایی کنید یا تأیید کنید که یک شبکه با موفقیت سیگنالهای خود را جمعآوری میکند.
مشاهده آداپتورهای موجود
برای مشاهده فهرستی از تمام آداپتورهای شخص ثالث مرتبط با منابع تبلیغاتی در پیکربندیهای پیشنهاد قیمت یا میانجیگری در برنامه خود، روی برگه آداپتورها کلیک کنید. سپس، کارتها را باز کنید تا وضعیت راهاندازی اولیه و نسخههای SDK آنها را مشاهده کنید. در کنار آداپتورهای شخص ثالث پشتیبانیشده، میتوانید آداپتورهای رویداد سفارشی را نیز مشاهده کنید.
رویدادهای سفارشی به ناشران اجازه میدهند از شبکههای تبلیغاتی که AdMob از آنها پشتیبانی نمیکند، استفاده کنند. رویدادهای سفارشی با نامهای کلاس منحصر به فرد خود از آداپتورهای شخص ثالث استاندارد در لیست آداپتورها قابل تشخیص هستند. بازرس تبلیغات علاوه بر ارائه نام کلاس و اطلاعات وضعیت، برچسبهای اختصاص داده شده به آن رویدادهای سفارشی را نیز در رابط وب AdMob نمایش میدهد.
در صورتی که آداپتور پیدا نشد یا نتوانست مقداردهی اولیه شود، برای اطلاعات بیشتر به عیبیابی مشکلات یافت شده با استفاده از بازرس تبلیغات مراجعه کنید.
واحدهای تبلیغاتی خود را آزمایش کنید
اگر میخواهید واحد تبلیغاتی خود را بدون نیاز به پیمایش در رابط کاربری برنامه خود آزمایش کنید، بازرس تبلیغات (ad inspector) این کار را مستقیماً از صفحه جزئیات واحد تبلیغاتی پشتیبانی میکند. علاوه بر این، میتوانید چندین واحد تبلیغاتی را به طور همزمان آزمایش کنید، درخواستهای تبلیغاتی آزمایشی خود را به صورت ناهمزمان بارگیری و مشاهده کنید و حتی آزمایشهای منبع تبلیغاتی واحد را انجام دهید.
تست تبلیغات
تستهای تبلیغاتی بازرس تبلیغات که در این بخش ذکر شدهاند، ابزاری عالی برای تأیید تجربه تبلیغات پایه شما و اعتبارسنجی پیکربندی واسطهگری شما هنگام استفاده با تست منبع تبلیغات واحد هستند.
وقتی آماده آزمایش واحد تبلیغاتی خود شدید، روی دکمه «درخواست آزمایش تبلیغات» در بالای صفحه بازرس تبلیغات خود ضربه بزنید تا آزمایش تبلیغات بازرس تبلیغات شما آغاز شود. سپس نتایج آزمایش در گزارش درخواست SDK در زیر عنوان « درخواستشده از بازرس تبلیغات» ظاهر میشود.
آزمایش منبع تبلیغاتی واحد
بازرس تبلیغات (Ad inspector) قابلیتی دارد که درخواستهای تبلیغات در برنامه شما را محدود میکند تا فقط تبلیغات را از یک منبع تبلیغاتی با قیمتگذاری (bidding) یا واسطهگری آبشاری (fall mediation) نمایش دهد. این به شما امکان میدهد تأیید کنید که آداپتور شخص ثالث را به درستی پیادهسازی کردهاید و منبع تبلیغ مطابق انتظار عمل میکند.
برای فعال کردن این ویژگی، دکمهی «تست منبع تبلیغات واحد» را در پایین صفحه فعال یا غیرفعال کنید. با این کار، کادر انتخاب منبع تبلیغات زیر نمایش داده میشود:
قبل از اینکه بتوانید از تست تک منبع تبلیغاتی استفاده کنید، باید SDK تبلیغات موبایلی گوگل را مقداردهی اولیه کنید .
سپس میتوانید یک منبع تبلیغاتی واحد را برای آزمایش انتخاب کنید. پس از انتخاب منبع تبلیغاتی، صفحه زیر ظاهر میشود:
تنظیمات تست منبع تبلیغ واحد برای هر درخواست تبلیغاتی که در آینده در همان جلسه ارسال میکنید اعمال میشود. با این حال، برای هیچ یک از تبلیغات ذخیره شده قبلی در آن جلسه که هنوز نمایش داده نشدهاند، اعمال نمیشود. هنگام اعمال تست منبع تبلیغ واحد، راهاندازی مجدد اجباری برنامه توصیه میشود تا هرگونه تبلیغات ذخیره شدهای که میتوانند به جای منبع تبلیغ انتخابی شما که درخواستی دریافت میکند، نمایش داده شوند، باطل شوند.
پس از راهاندازی مجدد برنامه، تمام واحدهای تبلیغاتی سعی میکنند فقط تبلیغی از شبکه انتخابشده را نشان دهند. راهاندازی بازرس تبلیغات هنگامی که یک تست منبع تبلیغ فعال است، منبع تبلیغ آزمایشی فعال را نشان میدهد:
در حالت تست منبع تبلیغاتی واحد، تمام درخواستهای تبلیغاتی سعی میکنند با منبع تبلیغاتی انتخاب شده پر شوند، صرف نظر از اینکه آن منبع تبلیغاتی برای واحد تبلیغاتی درخواستی برای پیشنهاد قیمت یا میانجیگری پیکربندی شده باشد. اگر منبع تبلیغاتی که آزمایش میکنید در آبشار میانجیگری برای یک واحد تبلیغاتی نباشد، پیام خطای "عدم پر کردن" دریافت خواهید کرد.
در تست منبع تبلیغات تکی، میتوانید روی یک واحد تبلیغاتی ضربه بزنید تا گزارش درخواست SDK آن را مشاهده کنید. این به شما امکان میدهد بدانید که آیا منبع تبلیغاتی درخواستهای تبلیغاتی ارسال شده پس از فعال کردن تست منبع تبلیغات تکی را پر کرده است یا خیر. اگر منبع تبلیغاتی نتواند تبلیغی را بارگذاری کند، یک پیام خطا ظاهر میشود که خطا را شرح میدهد.
اگر چندین نمونه از منبع تبلیغ انتخاب شده را به یک آبشار میانجیگری اضافه کرده باشید، هر نمونه از فراخوانی منبع تبلیغ را در آبشار مشاهده خواهید کرد تا زمانی که تبلیغ پر شود یا آبشار بدون پر شدن به پایان برسد.
توقف تست یک منبع تبلیغاتی واحد
برای متوقف کردن آزمایش، کلید را خاموش کنید:
سپس یک پیام تأیید در صفحه راهاندازی مجدد زیر ظاهر میشود:
توصیه میکنیم پس از توقف آزمایش، برنامه خود را مجدداً راهاندازی کنید تا هرگونه تبلیغات ذخیرهشده در حافظه پنهان برای منبع تبلیغاتی که آزمایش شده است، باطل شود.
اشکالزدایی تنظیمات حریم خصوصی
پیشنیازها: نسخه ۹.۶.۰ یا بالاتر از کیت توسعه نرمافزاری تبلیغات موبایلی گوگل
شما میتوانید از بازرس تبلیغات (ad inspector) برای مشاهده سیگنالهای حریم خصوصی زیر که در درخواست تبلیغ به عنوان بخشی از ادغام ناشر با IAB Europe TCF ارسال شدهاند، استفاده کنید:
- GDPR اعمال میشود (
IABTCF_gdprApplies) - رشته AC (
IABTCF_AddtlConsent) - رشته TC (
IABTCF_TCString)
پس از بارگذاری یک تبلیغ یا انجام آزمایش تبلیغ در بازرس تبلیغات، روی نماد منو در درخواست زیر گزارش درخواست SDK ضربه بزنید. سپس، گزینه سیگنالهای حریم خصوصی را انتخاب کنید.
صفحه سیگنالهای حریم خصوصی، سیگنالهای حریم خصوصی ارسال شده در درخواست تبلیغ را نمایش میدهد.
برای کسب اطلاعات بیشتر در مورد رشته AC، به مشخصات فنی رضایت تکمیلی گوگل مراجعه کنید. برای مشاهده جزئیات رضایت جزئی در رشته TC، مانند شناسه CMP و فهرست شناسههای فروشنده رضایت داده شده مرتبط با IAB، روی رمزگشایی کلیک کنید تا رمزگذار/رمزگشای IAB GPP باز شود.
اگر با هرگونه خطایی مواجه شدید، برای عیبیابی، مراحل موجود در بخش «درک مشکلات حریم خصوصی» را دنبال کنید.
کپی کردن کل خروجیهای اشکالزدایی
بازرس تبلیغات از کپی کردن یک رشته JSON حاوی کل خروجیهای اشکالزدایی از ابزار، از جمله جزئیات برنامه AdMob شما، وضعیتهای اولیهسازی آداپتور و نتایج آزمایش همه واحدهای تبلیغاتی پشتیبانی میکند.
برای انجام این کار، هفت بار روی آیکون برنامه ضربه بزنید تا پیام Copyed ad inspector JSON to clipboard را ببینید.