بازرس آگهی (بتا)

با استفاده از Ad Inspector می توانید:

• واحدهای تبلیغاتی خود را بررسی کنید
• بررسی کنید که آیا تبلیغات شما همانطور که انتظار می رود پر می شود یا خیر
• خطاها را شناسایی کنید و جزئیات مربوط به نحوه رفع آنها را مشاهده کنید
• جزئیات هر شبکه آگهی مناقصه باز را در هر درخواست مشاهده کنید
• مشاهده جزئیات میانجی برای هر شبکه تبلیغاتی در هر درخواست
• منابع آگهی مناقصه باز یا واسطه آبشار شخص ثالث را آزمایش کنید
• بررسی کنید که هر واحد تبلیغاتی را برای مناقصه باز و میانجی گری آبشار به درستی پیکربندی کرده اید

این راهنما نحوه راه اندازی و استفاده از ویژگی های مختلف در بازرس آگهی را نشان می دهد.

پیش نیازها

برای استفاده از Ad Inspector باید:

• شناسه برنامه Ad Manager خود را شناسایی کنید .

• راهنمای شروع را کامل کنید.

• از نسخه Google Mobile Ads SDK استفاده کنید 8.10.0 یا بالاتر

• حالت تست را فعال کنید یا دستگاه خود را به Ad Manager پیوند دهید . بازرس آگهی فقط در دستگاه های آزمایشی یا مرتبط راه اندازی می شود.

بازرس آگهی را راه اندازی کنید

Ad Inspector را می توان از هر نقطه ای از برنامه شما به روش های زیر راه اندازی کرد:

1. از دکمه راه اندازی از منوی اشکال زدایی استفاده کنید.
2. از حرکتی که در تنظیمات بازرس آگهی انتخاب کرده اید استفاده کنید.
3. به صورت برنامه نویسی با استفاده از API ارائه شده .

با استفاده از منوی اشکال زدایی راه اندازی کنید

برای راه اندازی بازرس آگهی از طریق منوی اشکال زدایی، نیازی به تغییر در برنامه شما نیست. فقط یک تبلیغ را پیدا کنید که توسط شبکه Ad Manager شما ارائه می شود و با دو انگشت آن را لمس کنید و نگه دارید تا منوی اشکال زدایی باز شود. سپس، Open ad inspector را انتخاب کنید.

اگر دستگاه خود را پیوند نداده‌اید، ممکن است از شما خواسته شود به حساب Ad Manager خود وارد شوید.

همچنین می‌توانید تنظیمات Ad inspector را از تنظیمات اشکال‌زدایی انتخاب کنید و حرکتی را انتخاب کنید که بتواند بازرس آگهی را در آینده بدون نیاز به رفتن از منوی اشکال‌زدایی باز کند.

به صورت برنامه ای راه اندازی کنید

Ad Inspector همچنین می تواند به صورت برنامه ریزی شده راه اندازی شود:

GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
  // Error will be non-nil if there was an issue and the inspector was not displayed.
}

[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

این API برای دستگاه های آزمایشی ثبت شده کار می کندبه صورت برنامه ای

مطمئن شوید که view controller ارسال شده به این API از قبل به طور کامل روی صفحه قابل مشاهده است ( viewDidAppear: فراخوانی شده بود). اگر view controller ارسال شده در حال نمایش باشد، مانند زمانی که API در تابع viewDidLoad کنترلر view فراخوانی می شود، نمایش بازرس آگهی با شکست مواجه می شود.

مشاهده و عیب یابی واحدهای تبلیغاتی

پس از راه‌اندازی، صفحه اصلی بازرس آگهی ظاهر می‌شود که حاوی فهرستی از همه واحدهای تبلیغاتی است از زمانی که بازرس آگهی در این جلسه برنامه فعال شده است، دستگاه درخواست های تبلیغاتی را برای آن ارائه کرده است. این فهرست همچنین شامل واحدهای تبلیغاتی با مناقصه باز فعال است که به ترتیب زمانی با بیشترین درخواست‌های اخیر تکمیل‌شده در ابتدا و مواردی که هیچ درخواست آگهی تکمیل‌شده‌ای ندارند (کم‌رنگ) مرتب شده‌اند:

توصیه می‌کنیم قبل از استفاده از بازرس آگهی ، SDK تبلیغات موبایلی Google را مقداردهی اولیه کنید .

جزئیات آبشار میانجی را برای یک واحد تبلیغاتی مشاهده کنید

روی یک واحد تبلیغاتی ضربه بزنید تا گزارش درخواست SDK آن را مشاهده کنید، که جزئیات مربوط به آبشار میانجی را تا زمانی که آگهی پر شده است (یا آبشار بدون پر شده است) را برای آخرین درخواست‌های آگهی ارائه می‌دهد.

هر درخواست را می توان با استفاده از نشانگر افشا گسترش داد تا نتایج آبشار میانجی را برای آن درخواست به همراه هر خطا و تاخیری که برای آن درخواست اعمال می شود نشان دهد.

برای منابع تبلیغاتی شخص ثالث، پیام های خطا مستقیماً از منبع تبلیغ ارسال می شود. اگر به اطلاعات بیشتری نیاز دارید، با منبع آگهی شخص ثالث خود مشورت کنید.

مشاهده جزئیات مناقصه برای یک واحد تبلیغاتی

اگر در مناقصه باز تازه کار هستید، مقدمه مناقصه باز را بخوانید.

در گزارش درخواست SDK، می توانید موارد را مشاهده کنید Open Bidding منابع تبلیغاتی که در درخواست آگهی فراخوانی می شوند. روی یک واحد تبلیغاتی در گزارش درخواست SDK ضربه بزنید تا جزئیات هر منبع تبلیغ را مشاهده کنید Open Bidding حراج

این 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 به کلیپ بورد را مشاهده کنید.