CustomEventListener

Kotlin |Java

public interface CustomEventListener

الفئات الفرعية المباشرة المعروفة

CustomEventBannerListener وCustomEventInterstitialListener وCustomEventNativeListener

CustomEventBannerListener	تم إيقاف واجهة برمجة التطبيقات هذه نهائيًا. يُرجى استخدام Adapter وMediationAdLoadCallback بدلاً منها.
CustomEventInterstitialListener	تم إيقاف واجهة برمجة التطبيقات هذه نهائيًا. يُرجى استخدام Adapter وMediationAdLoadCallback بدلاً منها.
CustomEventNativeListener	تم إيقاف واجهة برمجة التطبيقات هذه نهائيًا. يُرجى استخدام Adapter وMediationAdLoadCallback بدلاً منها.

---

تم إيقاف واجهة برمجة التطبيقات هذه نهائيًا.

يُرجى استخدام Adapter وMediationAdLoadCallback بدلاً منها.

أداة أساسية لتتبُّع الأحداث المخصّصة لإعلانات البانر والإعلانات البينية يُرجى عدم تنفيذ هذه الواجهة مباشرةً. بدلاً من ذلك، نفِّذ CustomEventBannerListener و/أو CustomEventInterstitialListener و/أو CustomEventNativeListener.

ملخّص

الإجراءات العامة
abstract void	onAdClicked() تشير إلى أنّ المستخدِم قد نقر على هذا الحدث المخصّص.
abstract void	onAdClosed() تشير إلى أنّ الحدث المخصّص عرض شيئًا بملء الشاشة، ويتم الآن نقل عنصر التحكّم مرة أخرى إلى التطبيق.
abstract void	onAdFailedToLoad(@NonNull AdError adError) يشير إلى تعذُّر تنفيذ طلب حدث مخصّص مع ذكر السبب الأساسي.
abstract void	onAdFailedToLoad(int errorCode) تم إيقاف هذا الإجراء نهائيًا. يمكنك استخدام onAdFailedToLoad بدلاً من ذلك.
abstract void	onAdLeftApplication() تشير إلى أنّ تفاعل المستخدم مع الحدث المخصّص يؤدي إلى انتقال الجهاز إلى تطبيق آخر (مثل متصفّح الويب).
abstract void	onAdOpened() تشير إلى أنّ الحدث المخصّص يعرض شيئًا بملء الشاشة.

الإجراءات العامة

onAdClicked

abstract void onAdClicked()

تشير إلى أنّ المستخدِم قد نقر على هذا الحدث المخصّص. يتم استخدام هذا الحدث لمقاييس الناشرين، ويجب استدعاؤه بالإضافة إلى أي أحداث أخرى، ولا تستنتج مكتبة التوسّط هذا الحدث أبدًا. على سبيل المثال، يعني onAdLeftApplication بشكل عام أنّ المستخدم قد نقر على إعلان، ولكن يجب استدعاء onAdClicked بغض النظر عن ذلك.

onAdClosed

abstract void onAdClosed()

تشير إلى أنّ الحدث المخصّص عرض شيئًا بملء الشاشة، ويتم الآن نقل عنصر التحكّم مرة أخرى إلى التطبيق. وقد يكون هذا المستخدم قد عاد من تطبيق آخر.

انظر أيضًا
onAdOpened

onAdFailedToLoad

abstract void onAdFailedToLoad(@NonNull AdError adError)

يشير إلى تعذُّر تنفيذ طلب حدث مخصّص مع ذكر السبب الأساسي. قد يكون الخطأ فعليًا أو مجرد عدم توفّر بيانات.

بعد طلب عرض إعلان، يجب أن يبلغ الحدث المخصّص عن نجاح الطلب أو تعذّره. في حال عدم تلقّي أي استجابة خلال المهلة الزمنية، تنتقل حزمة SDK لإعلانات Google على الأجهزة الجوّالة إلى وسيط آخر، ما يؤدي إلى عدم عرض إعلان قد يكون ناجحًا.

المعلمات
@NonNull AdError adError	AdError التي توضّح سبب تعذّر النقل.

onAdFailedToLoad

abstract void onAdFailedToLoad(int errorCode)

تم إيقاف هذا الإجراء نهائيًا.

يمكنك استخدام onAdFailedToLoad بدلاً من ذلك.

يشير إلى تعذُّر تنفيذ طلب حدث مخصّص مع ذكر السبب الأساسي. قد يكون الخطأ فعليًا أو مجرد عدم توفّر بيانات.

بعد طلب عرض إعلان، يجب أن يبلغ الحدث المخصّص عن نجاح الطلب أو تعذّره. في حال عدم تلقّي أي استجابة خلال المهلة الزمنية، تنتقل حزمة SDK لإعلانات Google على الأجهزة الجوّالة إلى وسيط آخر، ما يؤدي إلى عدم عرض إعلان قد يكون ناجحًا.

المعلمات
int errorCode	رمز خطأ يوضّح سبب التعذُّر.

onAdLeftApplication

abstract void onAdLeftApplication()

تشير إلى أنّ تفاعل المستخدم مع الحدث المخصّص يؤدي إلى انتقال الجهاز إلى تطبيق آخر (مثل متصفّح الويب). يجب استدعاء هذه الطريقة قبل وضع التطبيق الحالي في الخلفية.

onAdOpened

abstract void onAdOpened()

تشير إلى أنّ الحدث المخصّص يعرض شيئًا بملء الشاشة. قد يكون ذلك android.app.Activity، أو قد يكون مقدمة للتبديل إلى تطبيق آخر.

بعد إغلاق هذه الشاشة، يجب استدعاء onAdClosed.