با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یک شنونده رویداد سفارشی پایه برای بنرها و تبلیغات بینابینی. این رابط را مستقیماً پیادهسازی نکنید. در عوض، CustomEventBannerListener و/یا CustomEventInterstitialListener و/یا CustomEventNativeListener را پیادهسازی کنید.
خلاصه
روشهای عمومی |
|---|
abstract void | نشان میدهد که کاربر روی این رویداد سفارشی کلیک کرده است. |
abstract void | نشان میدهد که رویداد سفارشی چیزی را به صورت تمام صفحه رندر کرده و اکنون کنترل را به برنامه برمیگرداند. |
abstract void | نشان میدهد که درخواست یک رویداد سفارشی به همراه علت اصلی آن با شکست مواجه شده است. |
abstract void | این روش منسوخ شده است. به جای آن onAdFailedToLoad استفاده کنید. |
abstract void | نشان میدهد که تعامل کاربر با رویداد سفارشی باعث میشود دستگاه به برنامهی دیگری (مانند مرورگر وب) تغییر وضعیت دهد. |
abstract void | نشان میدهد که رویداد سفارشی در حال رندر کردن چیزی است که به صورت تمام صفحه نمایش داده میشود. |
روشهای عمومی
abstract void onAdClicked()
نشان میدهد که کاربر روی این رویداد سفارشی کلیک کرده است. این رویداد برای معیارهای ناشر استفاده میشود و باید علاوه بر سایر رویدادها فراخوانی شود؛ این رویداد هرگز توسط کتابخانه میانجیگری استنباط نمیشود. برای مثال، onAdLeftApplication عموماً به این معنی است که کاربر روی یک تبلیغ کلیک کرده است، اما onAdClicked باید صرف نظر از آن فراخوانی شود.
abstract void onAdClosed()
نشان میدهد که رویداد سفارشی چیزی را به صورت تمام صفحه رندر کرده و اکنون کنترل را به برنامه برمیگرداند. این ممکن است مربوط به کاربر باشد که از یک برنامه دیگر برگشته است.
abstract void onAdFailedToLoad(@NonNull AdError adError)
نشان میدهد که یک درخواست رویداد سفارشی به همراه علت اصلی آن با شکست مواجه شده است. این شکست میتواند یک خطای واقعی یا صرفاً عدم تکمیل فیلد باشد.
پس از درخواست یک تبلیغ، رویداد سفارشی باید موفقیت یا شکست را گزارش دهد. اگر در مدت زمان مشخصی پاسخی دریافت نشود، SDK تبلیغات موبایلی گوگل به آداپتور دیگری منتقل میشود و در نتیجه تبلیغ بالقوه موفق نمایش داده نمیشود.
abstract void onAdFailedToLoad(int errorCode)
نشان میدهد که یک درخواست رویداد سفارشی به همراه علت اصلی آن با شکست مواجه شده است. این شکست میتواند یک خطای واقعی یا صرفاً عدم تکمیل فیلد باشد.
پس از درخواست یک تبلیغ، رویداد سفارشی باید موفقیت یا شکست را گزارش دهد. اگر در مدت زمان مشخصی پاسخی دریافت نشود، SDK تبلیغات موبایلی گوگل به آداپتور دیگری منتقل میشود و در نتیجه تبلیغ بالقوه موفق نمایش داده نمیشود.
| پارامترها |
|---|
int errorCode | کد خطایی که علت خرابی را شرح میدهد. |
abstract void onAdLeftApplication()
نشان میدهد که تعامل کاربر با رویداد سفارشی باعث میشود دستگاه به برنامهی دیگری (مانند مرورگر وب) سوئیچ کند. این باید قبل از اینکه برنامهی فعلی در پسزمینه قرار گیرد، فراخوانی شود.
abstract void onAdOpened()
نشان میدهد که رویداد سفارشی در حال رندر کردن چیزی است که به صورت تمام صفحه نمایش داده میشود. این میتواند یک android.app.Activity باشد، یا میتواند پیشنیازی برای تغییر به یک برنامهی دیگر باشد.
به محض اینکه این صفحه بسته شود، onAdClosed باید فراخوانی شود.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2026-02-17 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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"]],["تاریخ آخرین بهروزرسانی 2026-02-17 بهوقت ساعت هماهنگ جهانی."],[],[]]