MediationNativeListener

Kotlin |Java

public interface MediationNativeListener

أداة معالجة تتضمّن عمليات ردّ لكي تتواصل أداة الربط مع مكتبة التوسّط. يجب إعادة إرسال الأحداث إلى مكتبة التوسّط لإدارة تدفّق الإعلانات بشكلٍ سليم.

ملخّص

الإجراءات العامة
`abstract void`	`onAdClicked(MediationNativeAdapter adapter)` تشير إلى أنّ المستخدم قد نقر على هذا الإعلان.
`abstract void`	`onAdClosed(MediationNativeAdapter adapter)` يشير إلى أنّ عنصر التحكّم في الإعلان عرض شيئًا بملء الشاشة وينقل الآن عنصر التحكّم مرة أخرى إلى التطبيق.
`abstract void`	`onAdFailedToLoad( MediationNativeAdapter adapter, @NonNull AdError adError )` يشير إلى تعذُّر تحميل طلب إعلان.
`abstract void`	`onAdFailedToLoad(MediationNativeAdapter adapter, int error)` تم إيقاف هذا الإجراء نهائيًا. يمكنك استخدام `onAdFailedToLoad` بدلاً من ذلك.
`abstract void`	`onAdImpression(MediationNativeAdapter adapter)` تشير إلى أنّه تم تسجيل مرّة ظهور للإعلان.
`abstract void`	`onAdLeftApplication(MediationNativeAdapter adapter)` تشير إلى أنّ الإعلان يتسبّب في انتقال الجهاز إلى تطبيق آخر (مثل متصفّح ويب).
`abstract void`	`onAdLoaded( MediationNativeAdapter adapter, UnifiedNativeAdMapper unifiedNativeAdMapper )` تشير إلى أنّه تم طلب إعلان وتلقّيه بنجاح.
`abstract void`	`onAdOpened(MediationNativeAdapter adapter)` تشير إلى أنّ عنصر التحكّم في الإعلان يعرض شيئًا بملء الشاشة.
`abstract void`	`onVideoEnd(MediationNativeAdapter adapter)` تشير إلى أنّ الإعلان انتهى من تشغيل الفيديو بالكامل.

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

onAdClicked

abstract void onAdClicked(MediationNativeAdapter adapter)

تشير إلى أنّ المستخدم قد نقر على هذا الإعلان. يجب عدم استدعاء هذه الطريقة إلا إذا تم ضبط setOverrideClickHandling على "صحيح". يُستخدَم هذا المعرّف لمقاييس الناشرين، ويجب استدعاؤه بالإضافة إلى أي أحداث أخرى.

المعلمات
`MediationNativeAdapter adapter`	محوّل البرامج الإعلانية للوساطة الذي أطلق الحدث.

onAdClosed

abstract void onAdClosed(MediationNativeAdapter adapter)

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

راجِع onAdFailedToLoad.

المعلمات
`MediationNativeAdapter adapter`	محوّل البرامج الإعلانية للوساطة الذي أطلق الحدث.

onAdFailedToLoad

abstract void onAdFailedToLoad(
    MediationNativeAdapter adapter,
    @NonNull AdError adError
)

يشير إلى تعذُّر تحميل طلب إعلان.

المعلمات
`MediationNativeAdapter adapter`	محوّل البرامج الإعلانية للوساطة الذي أطلق الحدث.
`@NonNull AdError adError`	`AdError` التي توضّح سبب تعذّر النقل.

انظر أيضًا
`onAdLoaded`

onAdFailedToLoad

abstract void onAdFailedToLoad(MediationNativeAdapter adapter, int error)

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

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

المعلمات
`MediationNativeAdapter adapter`	محوّل البرامج الإعلانية للوساطة الذي أطلق الحدث.
`int error`	رمز خطأ يوضّح سبب التعذُّر.

انظر أيضًا
`onAdLoaded`

onAdImpression

abstract void onAdImpression(MediationNativeAdapter adapter)

تشير إلى أنّه تم تسجيل مرّة ظهور للإعلان. يجب عدم استدعاء هذه الطريقة إلا إذا تم ضبط setOverrideImpressionRecording على "صحيح". يُستخدَم هذا المعرّف لمقاييس الناشرين، ويجب استدعاؤه بالإضافة إلى أي أحداث أخرى.

المعلمات
`MediationNativeAdapter adapter`	محوّل البرامج الإعلانية للوساطة الذي أطلق الحدث.

onAdLeftApplication

abstract void onAdLeftApplication(MediationNativeAdapter adapter)

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

المعلمات
`MediationNativeAdapter adapter`	محوّل البرامج الإعلانية للوساطة الذي أطلق الحدث.

onAdLoaded

abstract void onAdLoaded(
    MediationNativeAdapter adapter,
    UnifiedNativeAdMapper unifiedNativeAdMapper
)

تشير إلى أنّه تم طلب إعلان وتلقّيه بنجاح.

راجِع onAdFailedToLoad.

المعلمات
`MediationNativeAdapter adapter`	محوّل البرامج الإعلانية للوساطة الذي أطلق الحدث.
`UnifiedNativeAdMapper unifiedNativeAdMapper`	فئة الربط التي توفّر عملية ربط من عنصر الإعلان في شبكة الإعلانات التي تستخدم التوسّط إلى عنصر الإعلان المدمج مع المحتوى الموحّد.

onAdOpened

abstract void onAdOpened(MediationNativeAdapter adapter)

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

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

المعلمات
`MediationNativeAdapter adapter`	محوّل البرامج الإعلانية للوساطة الذي أطلق الحدث.

onVideoEnd

abstract void onVideoEnd(MediationNativeAdapter adapter)

تشير إلى أنّ الإعلان انتهى من تشغيل الفيديو بالكامل.

المعلمات
`MediationNativeAdapter adapter`	محوّل البرامج الإعلانية للوساطة الذي أطلق الحدث.