گوگل ایما . AdError
AdError اطلاعاتی را در مورد اینکه آیا در حین بارگیری یا پخش تبلیغ رخ داده است یا خیر، به کاربر ارائه می دهد. ابزار دسترسی errorType اطلاعاتی در مورد اینکه آیا خطا در حین بارگیری یا پخش آگهی رخ داده است ارائه می دهد.
- تمدید می شود
- خطا
شمارش ها
کد خطا
عدد
کدهای خطای احتمالی که هنگام بارگیری یا پخش تبلیغات مطرح می شوند. ErrorCodes مقادیر عددی هستند و می توانند در یکی از محدوده های زیر باشند:
- کدهای خطای تبلیغاتی منطبق با استاندارد VAST 3 از بلوک های زیر 1000 استفاده می کنند.
- کدهای خطای خاص SDK: 1000-1099 برای خطاهای عمومی سطح بالا 1100-1199 برای خطاهای عمومی سطح پایین 1200-1299 برای خطاهای خاص پخش ویدیو
ارزش | |
|---|---|
VAST_MALFORMED_RESPONSE | پاسخ آگهی به عنوان یک تبلیغ VAST معتبر شناخته نشد. کد خطای VAST 100 |
VAST_SCHEMA_VALIDATION_ERROR | خطای اعتبارسنجی طرحواره VAST. کد خطای VAST 101 |
VAST_UNSUPPORTED_VERSION | پاسخ آگهی حاوی یک نسخه VAST پشتیبانی نشده بود. کد خطای VAST 102 |
VAST_TRAFFICKING_ERROR | خطای قاچاق پخش کننده ویدیو یک نوع تبلیغ دریافت کرد که انتظارش را نداشت و/یا نمی تواند نمایش دهد. کد خطای VAST 200 |
VAST_UNEXPECTED_LINEARITY | خطی بودن تبلیغات با آنچه پخش کننده ویدیو انتظار دارد متفاوت است. کد خطای VAST 201 |
VAST_UNEXPECTED_DURATION_ERROR | مدت زمان VAST با مدت زمان واقعی فایل رسانه ای متفاوت است. کد خطای VAST 202 |
VAST_WRAPPER_ERROR | خطای عمومی VAST Wrapper. کد خطای VAST 300 |
VAST_LOAD_TIMEOUT | VAST URI ارائه شده، یا یک VAST URI ارائه شده در یک عنصر بسته بندی بعدی، طبق تعریف پخش کننده ویدیو یا در دسترس نبود یا به پایان رسید. مهلت زمانی 5 ثانیه برای درخواست های اولیه VAST و هر بسته بندی بعدی است. کد خطای VAST 301 |
VAST_TOO_MANY_REDIRECTS | به حداکثر تعداد تغییر مسیرهای بسته بندی VAST رسیده است. کد خطای VAST 302 |
VAST_NO_ADS_AFTER_WRAPPER | پس از یک یا چند بسته بندی هیچ پاسخ VAST تبلیغاتی وجود ندارد. کد خطای VAST 303 |
VIDEO_PLAY_ERROR | هنگام پخش آگهی ویدیویی خطایی روی داد. کد خطای VAST 400 |
VAST_MEDIA_LOAD_TIMEOUT | بارگیری دارایی های رسانه از یک پاسخ VAST انجام نشد. زمان پیش‌فرض برای بارگیری رسانه 8 ثانیه است. کد خطای VAST 402 |
VAST_LINEAR_ASSET_MISMATCH | دارایی‌هایی در پاسخ آگهی VAST برای آگهی خطی یافت شد، اما هیچ‌کدام از آنها با قابلیت‌های پخش‌کننده ویدیو مطابقت نداشت. کد خطای VAST 403 |
VAST_PROBLEM_DISPLAYING_MEDIA_FILE | مشکل در نمایش MediaFile در حال حاضر اگر پخش ویدیو به دلیل کیفیت پخش ضعیف متوقف شود، استفاده می شود. کد خطای VAST 405 |
OVERLAY_AD_PLAYING_FAILED | یک تبلیغ همپوشانی ارائه نشد. کد خطای VAST 500 |
NONLINEAR_DIMENSIONS_ERROR | نمایش تبلیغات غیرخطی امکان پذیر نیست زیرا ابعاد خلاقانه با ناحیه نمایش خلاق مطابقت ندارند (مثلاً بعد خلاقیت خیلی بزرگ است). کد خطای VAST 501 |
OVERLAY_AD_LOADING_FAILED | آگهی همپوشانی بارگیری نشد. کد خطای VAST 502 |
VAST_NONLINEAR_ASSET_MISMATCH | دارایی‌هایی در پاسخ آگهی VAST برای آگهی غیرخطی پیدا شد، اما هیچ‌کدام از آنها با قابلیت‌های پخش‌کننده ویدیو مطابقت نداشت. کد خطای VAST 503 |
COMPANION_REQUIRED_ERROR | امکان نمایش یک یا چند همراه مورد نیاز وجود ندارد. تبلیغ اصلی کنار گذاشته شده است زیرا همراهان مورد نیاز نمایش داده نمی شوند. کد خطای VAST 602 |
COMPANION_AD_LOADING_FAILED | آگهی همراه بارگیری یا ارائه نشد. کد خطای VAST 603 |
خطای ناشناخته | یک خطای غیرمنتظره رخ داد و علت آن مشخص نیست. برای اطلاعات بیشتر به خطای داخلی مراجعه کنید. کد خطای VAST 900 |
VPAID_ERROR | یک خطای VPAID روی داد. برای اطلاعات بیشتر به خطای داخلی مراجعه کنید. کد خطای VAST 901 |
FAILED_TO_REQUEST_ADS | مشکلی در درخواست تبلیغات از سرور وجود داشت. کد خطای IMA 1005 |
VAST_ASSET_NOT_FOUND | هیچ دارایی در پاسخ آگهی VAST یافت نشد. کد خطای IMA 1007 |
VAST_EMPTY_RESPONSE | یک پاسخ VAST حاوی یک تگ |
UNKNOWN_AD_RESPONSE | پاسخ آگهی درک نشد و قابل تجزیه نیست. کد خطای IMA 1010 |
ADS_REQUEST_NETWORK_ERROR | مشکلی در درخواست تبلیغات از سرور وجود داشت. کد خطای IMA 1012 |
INVALID_AD_TAG | نشانی اینترنتی تگ آگهی مشخص شده نامعتبر بود. باید به درستی کدگذاری شود. کد خطای IMA 1013 |
STREAM_INITIALIZATION_FAILED | هنگام درج آگهی سمت سرور، خطایی در راه‌اندازی جریان وجود داشت. کد خطای IMA 1020 |
ASSET_FALLBACK_FAILED | در بازگشت دارایی خطایی وجود داشت. کد خطای IMA 1021 |
INVALID_ARGUMENTS | آرگومان های نامعتبر به روش های SDK ارائه شد. کد خطای IMA 1101 |
AUTOPLAY_DISALLOWED | مرورگر از پخش بدون تعامل کاربر جلوگیری کرد. کد خطای IMA 1205 |
CONSENT_MANAGEMENT_PROVIDER_NOT_READY | یک ارائه‌دهنده مدیریت رضایت در صفحه شناسایی شد و نشان داده است که رضایت هنوز مشخص نیست. کد خطای IMA 1300 |
تایپ کنید
رشته
انواع خطاهای احتمالی برای بارگیری و پخش آگهی.
ارزش | |
|---|---|
AD_LOAD | نشان می دهد که هنگام بارگیری آگهی با خطا مواجه شده است. دلایل احتمالی: هیچ پاسخی از طرف سرور آگهی دریافت نشد، پاسخ تبلیغات نادرست برگردانده شد، یا پارامترهای درخواست آگهی تأیید اعتبار را تأیید نکردند. |
AD_PLAY | نشان می دهد که خطا پس از بارگیری آگهی، در حین پخش آگهی، رخ داده است. دلایل احتمالی: دارایی های تبلیغات بارگیری نشد و موارد دیگر. |
خواص
کد خطا
عدد
کدهای خطای احتمالی که هنگام بارگیری یا پخش تبلیغات مطرح می شوند. ErrorCodes مقادیر عددی هستند و می توانند در یکی از محدوده های زیر باشند:
- کدهای خطای تبلیغاتی منطبق با استاندارد VAST 3 از بلوک های زیر 1000 استفاده می کنند.
- کدهای خطای خاص SDK: 1000-1099 برای خطاهای عمومی سطح بالا 1100-1199 برای خطاهای عمومی سطح پایین 1200-1299 برای خطاهای خاص پخش ویدیو
ارزش | |
|---|---|
VAST_MALFORMED_RESPONSE | پاسخ آگهی به عنوان یک تبلیغ VAST معتبر شناخته نشد. کد خطای VAST 100 |
VAST_SCHEMA_VALIDATION_ERROR | خطای اعتبارسنجی طرحواره VAST. کد خطای VAST 101 |
VAST_UNSUPPORTED_VERSION | پاسخ آگهی حاوی یک نسخه VAST پشتیبانی نشده بود. کد خطای VAST 102 |
VAST_TRAFFICKING_ERROR | خطای قاچاق پخش کننده ویدیو یک نوع تبلیغ دریافت کرد که انتظارش را نداشت و/یا نمی تواند نمایش دهد. کد خطای VAST 200 |
VAST_UNEXPECTED_LINEARITY | خطی بودن تبلیغات با آنچه پخش کننده ویدیو انتظار دارد متفاوت است. کد خطای VAST 201 |
VAST_UNEXPECTED_DURATION_ERROR | مدت زمان VAST با مدت زمان واقعی فایل رسانه ای متفاوت است. کد خطای VAST 202 |
VAST_WRAPPER_ERROR | خطای عمومی VAST Wrapper. کد خطای VAST 300 |
VAST_LOAD_TIMEOUT | VAST URI ارائه شده، یا یک VAST URI ارائه شده در یک عنصر بسته بندی بعدی، طبق تعریف پخش کننده ویدیو یا در دسترس نبود یا به پایان رسید. مهلت زمانی 5 ثانیه برای درخواست های اولیه VAST و هر بسته بندی بعدی است. کد خطای VAST 301 |
VAST_TOO_MANY_REDIRECTS | به حداکثر تعداد تغییر مسیرهای بسته بندی VAST رسیده است. کد خطای VAST 302 |
VAST_NO_ADS_AFTER_WRAPPER | پس از یک یا چند بسته بندی هیچ پاسخ VAST تبلیغاتی وجود ندارد. کد خطای VAST 303 |
VIDEO_PLAY_ERROR | هنگام پخش آگهی ویدیویی خطایی روی داد. کد خطای VAST 400 |
VAST_MEDIA_LOAD_TIMEOUT | بارگیری دارایی های رسانه از یک پاسخ VAST انجام نشد. زمان پیش‌فرض برای بارگیری رسانه 8 ثانیه است. کد خطای VAST 402 |
VAST_LINEAR_ASSET_MISMATCH | دارایی‌هایی در پاسخ آگهی VAST برای آگهی خطی یافت شد، اما هیچ‌کدام از آنها با قابلیت‌های پخش‌کننده ویدیو مطابقت نداشت. کد خطای VAST 403 |
VAST_PROBLEM_DISPLAYING_MEDIA_FILE | مشکل در نمایش MediaFile در حال حاضر اگر پخش ویدیو به دلیل کیفیت پخش ضعیف متوقف شود، استفاده می شود. کد خطای VAST 405 |
OVERLAY_AD_PLAYING_FAILED | یک تبلیغ همپوشانی ارائه نشد. کد خطای VAST 500 |
NONLINEAR_DIMENSIONS_ERROR | نمایش تبلیغات غیرخطی امکان پذیر نیست زیرا ابعاد خلاقانه با ناحیه نمایش خلاق مطابقت ندارند (مثلاً بعد خلاقیت خیلی بزرگ است). کد خطای VAST 501 |
OVERLAY_AD_LOADING_FAILED | آگهی همپوشانی بارگیری نشد. کد خطای VAST 502 |
VAST_NONLINEAR_ASSET_MISMATCH | دارایی‌هایی در پاسخ آگهی VAST برای آگهی غیرخطی پیدا شد، اما هیچ‌کدام از آنها با قابلیت‌های پخش‌کننده ویدیو مطابقت نداشت. کد خطای VAST 503 |
COMPANION_REQUIRED_ERROR | امکان نمایش یک یا چند همراه مورد نیاز وجود ندارد. تبلیغ اصلی کنار گذاشته شده است زیرا همراهان مورد نیاز نمایش داده نمی شوند. کد خطای VAST 602 |
COMPANION_AD_LOADING_FAILED | آگهی همراه بارگیری یا ارائه نشد. کد خطای VAST 603 |
خطای ناشناخته | یک خطای غیرمنتظره رخ داد و علت آن مشخص نیست. برای اطلاعات بیشتر به خطای داخلی مراجعه کنید. کد خطای VAST 900 |
VPAID_ERROR | یک خطای VPAID روی داد. برای اطلاعات بیشتر به خطای داخلی مراجعه کنید. کد خطای VAST 901 |
FAILED_TO_REQUEST_ADS | مشکلی در درخواست تبلیغات از سرور وجود داشت. کد خطای IMA 1005 |
VAST_ASSET_NOT_FOUND | هیچ دارایی در پاسخ آگهی VAST یافت نشد. کد خطای IMA 1007 |
VAST_EMPTY_RESPONSE | یک پاسخ VAST حاوی یک تگ |
UNKNOWN_AD_RESPONSE | پاسخ آگهی درک نشد و قابل تجزیه نیست. کد خطای IMA 1010 |
ADS_REQUEST_NETWORK_ERROR | مشکلی در درخواست تبلیغات از سرور وجود داشت. کد خطای IMA 1012 |
INVALID_AD_TAG | نشانی اینترنتی تگ آگهی مشخص شده نامعتبر بود. باید به درستی کدگذاری شود. کد خطای IMA 1013 |
STREAM_INITIALIZATION_FAILED | هنگام درج آگهی سمت سرور، خطایی در راه‌اندازی جریان وجود داشت. کد خطای IMA 1020 |
ASSET_FALLBACK_FAILED | در بازگشت دارایی خطایی وجود داشت. کد خطای IMA 1021 |
INVALID_ARGUMENTS | آرگومان های نامعتبر به روش های SDK ارائه شد. کد خطای IMA 1101 |
AUTOPLAY_DISALLOWED | مرورگر از پخش بدون تعامل کاربر جلوگیری کرد. کد خطای IMA 1205 |
CONSENT_MANAGEMENT_PROVIDER_NOT_READY | یک ارائه‌دهنده مدیریت رضایت در صفحه شناسایی شد و نشان داده است که رضایت هنوز مشخص نیست. کد خطای IMA 1300 |
تایپ کنید
رشته
انواع خطاهای احتمالی برای بارگیری و پخش آگهی.
ارزش | |
|---|---|
AD_LOAD | نشان می دهد که هنگام بارگیری آگهی با خطا مواجه شده است. دلایل احتمالی: هیچ پاسخی از طرف سرور آگهی دریافت نشد، پاسخ تبلیغات نادرست برگردانده شد، یا پارامترهای درخواست آگهی تأیید اعتبار را تأیید نکردند. |
AD_PLAY | نشان می دهد که خطا پس از بارگیری آگهی، در حین پخش آگهی، رخ داده است. دلایل احتمالی: دارایی های تبلیغات بارگیری نشد و موارد دیگر. |
مواد و روش ها
getErrorCode
getErrorCode() عدد را برمی گرداند
- برمی گرداند
numberکد خطا، همانطور که در AdError.ErrorCode تعریف شده است.
getInnerError
getInnerError() برمی گرداند (تهی یا خطا)
خطای ایجاد شده را برمی گرداند.
- برمی گرداند
(null or non-null Error)خطای داخلی که در حین پردازش رخ داده است، یا اگر این اطلاعات در دسترس نباشد، باطل است. این خطا ممکن است یک خطای بومی یا یک AdError، یک زیر کلاس از یک خطای بومی باشد. در صورتی که خطای ایجاد شده در دسترس نباشد، ممکن است این خطا برگردد.
دریافت پیام
getMessage() رشته را برمی گرداند
- برمی گرداند
stringپیام این خطا.
getType
getType() رشته را برمی گرداند
- برمی گرداند
stringنوع این خطا، همانطور که در AdError.Type تعریف شده است.
getVastErrorCode
getVastErrorCode() عدد را برمی گرداند
- برمی گرداند
numberاگر کد خطای VAST موجود باشد، آن را برمی‌گرداند، در غیر این صورت AdError.ErrorCode.UNKNOWN_ERROR را برمی‌گرداند.
toString
toString() رشته را برمی گرداند
- برمی گرداند
string