الفئة: AdEvent

google.ima.AdEvent

الفئة static

ويتم عرض هذا النوع من الأحداث بواسطة الإعلان على أنه إشعار عند تغيُّر حالة الإعلان ووقت تفاعل المستخدمين مع الإعلان. على سبيل المثال، عند بدء تشغيل الإعلان والنقر عليه والمزيد. يمكنك التسجيل في الفعاليات المختلفة التي تم تغيير حالتها على AdsManager.

التعداد

النوع

ثابت

سلسلة

أنواع AdEvents

القيمة
AD_CAN_PLAY	يتم الإطلاق عندما يكون الإعلان جاهزًا للتشغيل بدون تخزين مؤقت، إما في بداية الإعلان أو بعد اكتمال التخزين المؤقت.
CONTENT_PAUSE_REQUESTED	يتم تنشيط هذه الميزة عندما يكون من الضروري إيقاف المحتوى مؤقتًا. ويحدث ذلك عادةً قبل أن يوشك الإعلان على تغطية المحتوى.
CONTENT_RESUME_REQUESTED	يتم تنشيطها عند استئناف المحتوى. ويحدث هذا عادةً عند انتهاء الإعلان أو تصغيره.
{CLICK}	يتم الإطلاق عند النقر على الإعلان.
تم النقر على الفيديو	يتم إطلاقه عند النقر على الجزء الذي لا يمثّل نسبة نقر إلى ظهور في إعلان الفيديو.
VIDEO_ICON_CLICKED	يتم إطلاقه عندما ينقر أحد المستخدمين على رمز الفيديو.
تم البدء	يتم إطلاقه عند بدء تشغيل الإعلان.
AD_PROGRESS	يتم الإطلاق عند تغيير قيمة الوقت الحالي للإعلان. سيؤدي استدعاء getAdData() في هذه الفعالية إلى عرض كائن AdProgressData.
التخزين المؤقت للإعلانات	يتم الإطلاق عندما يتوقف تشغيل الإعلان في المخزن المؤقت.
مرات الظهور	يتم تنشيطه عند إرسال إشعار لعنوان URL لمرات الظهور.
تم الإيقاف مؤقتًا	يتم الإطلاق عند إيقاف الإعلان مؤقتًا.
تم الاستئناف	يتم الإطلاق عند استئناف الإعلان.
FIRST_QUARTILE	يتم إطلاقه عندما يتقاطع رأس تشغيل الإعلان مع الربع الأول.
نقطة متوسطة	يتم إطلاقه عندما يتقاطع رأس تشغيل الإعلان مع نقطة المنتصف.
THIRD_QUARTILE	يتم إطلاقه عند عبور رأس تشغيل الإعلان في الربع الثالث.
إكمال	يتم الإطلاق عند اكتمال تشغيل الإعلان.
DURATION_CHANGE	يتم إطلاقه عند تغيير مدة الإعلان.
USER_CLOSE	يتم إطلاقه عندما يغلق المستخدم الإعلان.
تم التحميل	يتم الإطلاق عند توفر بيانات الإعلان.
ALL_ADS_COMPLETED	يتم إطلاقه عندما ينتهي مدير الإعلانات من تشغيل جميع الإعلانات الصالحة في استجابة الإعلانات، أو عندما لا تُرجع الاستجابة أي إعلانات صالحة.
تم تخطّي السؤال.	يتم إطلاقه عندما يتخطّى المستخدم الإعلان.
LINEAR_CHANGED	يتم الإطلاق عندما يتغير الإعلان المعروض من خطي إلى غير خطي أو العكس.
SKIPPABLE_STATE_CHANGED	يتم إطلاقه عند تغيير الحالة القابلة للتخطي للإعلانات المعروضة.
البيانات الوصفية	يتم الإطلاق عند تحميل قائمة إعلانات.
AD_BREAK_READY	يتم تنشيط هذه القاعدة عندما يتم تشغيل قاعدة إعلان أو فاصل إعلاني VMAP إذا كانت autoPlayAdBreaks خاطئة.
السجلّ	يتم إطلاقه عند مواجهة خطأ غير فادح. ولن يحتاج المستخدم إلى اتّخاذ أي إجراء لأن حزمة تطوير البرامج (SDK) ستستمر في العمل مع الإعلان نفسه أو تشغيل الإعلان التالي وفقًا لحالة الخطأ.
VOLUME_CHANGED	يتم الإطلاق عند تغير حجم الإعلان.
حجم المجلد	يتم الإطلاق عند تجاهل حجم الإعلان.
التفاعل	يتم إطلاقه عندما يؤدي أحد الإعلانات إلى عرض معاودة الاتصال. تحتوي التفاعلات مع الإعلانات على سلسلة رقم تعريف التفاعل في بيانات الإعلان.

الخاصية

النوع

ثابت

سلسلة

أنواع AdEvents

القيمة
AD_CAN_PLAY	يتم الإطلاق عندما يكون الإعلان جاهزًا للتشغيل بدون تخزين مؤقت، إما في بداية الإعلان أو بعد اكتمال التخزين المؤقت.
CONTENT_PAUSE_REQUESTED	يتم تنشيط هذه الميزة عندما يكون من الضروري إيقاف المحتوى مؤقتًا. ويحدث ذلك عادةً قبل أن يوشك الإعلان على تغطية المحتوى.
CONTENT_RESUME_REQUESTED	يتم تنشيطها عند استئناف المحتوى. ويحدث هذا عادةً عند انتهاء الإعلان أو تصغيره.
{CLICK}	يتم الإطلاق عند النقر على الإعلان.
تم النقر على الفيديو	يتم إطلاقه عند النقر على الجزء الذي لا يمثّل نسبة نقر إلى ظهور في إعلان الفيديو.
VIDEO_ICON_CLICKED	يتم إطلاقه عندما ينقر أحد المستخدمين على رمز الفيديو.
تم البدء	يتم إطلاقه عند بدء تشغيل الإعلان.
AD_PROGRESS	يتم الإطلاق عند تغيير قيمة الوقت الحالي للإعلان. سيؤدي استدعاء getAdData() في هذه الفعالية إلى عرض كائن AdProgressData.
التخزين المؤقت للإعلانات	يتم الإطلاق عندما يتوقف تشغيل الإعلان في المخزن المؤقت.
مرات الظهور	يتم تنشيطه عند إرسال إشعار لعنوان URL لمرات الظهور.
تم الإيقاف مؤقتًا	يتم الإطلاق عند إيقاف الإعلان مؤقتًا.
تم الاستئناف	يتم الإطلاق عند استئناف الإعلان.
FIRST_QUARTILE	يتم إطلاقه عندما يتقاطع رأس تشغيل الإعلان مع الربع الأول.
نقطة متوسطة	يتم إطلاقه عندما يتقاطع رأس تشغيل الإعلان مع نقطة المنتصف.
THIRD_QUARTILE	يتم إطلاقه عند عبور رأس تشغيل الإعلان في الربع الثالث.
إكمال	يتم الإطلاق عند اكتمال تشغيل الإعلان.
DURATION_CHANGE	يتم إطلاقه عند تغيير مدة الإعلان.
USER_CLOSE	يتم إطلاقه عندما يغلق المستخدم الإعلان.
تم التحميل	يتم الإطلاق عند توفر بيانات الإعلان.
ALL_ADS_COMPLETED	يتم إطلاقه عندما ينتهي مدير الإعلانات من تشغيل جميع الإعلانات الصالحة في استجابة الإعلانات، أو عندما لا تُرجع الاستجابة أي إعلانات صالحة.
تم تخطّي السؤال.	يتم إطلاقه عندما يتخطّى المستخدم الإعلان.
LINEAR_CHANGED	يتم الإطلاق عندما يتغير الإعلان المعروض من خطي إلى غير خطي أو العكس.
SKIPPABLE_STATE_CHANGED	يتم إطلاقه عند تغيير الحالة القابلة للتخطي للإعلانات المعروضة.
البيانات الوصفية	يتم الإطلاق عند تحميل قائمة إعلانات.
AD_BREAK_READY	يتم تنشيط هذه القاعدة عندما يتم تشغيل قاعدة إعلان أو فاصل إعلاني VMAP إذا كانت autoPlayAdBreaks خاطئة.
السجلّ	يتم إطلاقه عند مواجهة خطأ غير فادح. ولن يحتاج المستخدم إلى اتّخاذ أي إجراء لأن حزمة تطوير البرامج (SDK) ستستمر في العمل مع الإعلان نفسه أو تشغيل الإعلان التالي وفقًا لحالة الخطأ.
VOLUME_CHANGED	يتم الإطلاق عند تغير حجم الإعلان.
حجم المجلد	يتم الإطلاق عند تجاهل حجم الإعلان.
التفاعل	يتم إطلاقه عندما يؤدي أحد الإعلانات إلى عرض معاودة الاتصال. تحتوي التفاعلات مع الإعلانات على سلسلة رقم تعريف التفاعل في بيانات الإعلان.

الطُرق

إعلان

getAd() تعرض الإعلان

احصل على الإعلان الحالي الذي يتم تشغيله أو تشغيله للتو.

المرتجعات

nullable Ad الإعلان المرتبط بالفعالية أو خالٍ من الإعلانات في حال عدم وجود إعلان ملائم.

getAdData

getAdData() تعرض كائنًا

تسمح بمرور بيانات إضافية من الإعلان.

مثال:

if (event.type == google.ima.AdEvent.Type.LOG) {
  let adData = event.getAdData();
  if (adData['adError']) {
    console.log('Non-fatal error occurred: ' +
        adData['adError'].getMessage());
  }
}

المرتجعات

nullable Object البيانات الإضافية للحدث. أحداث السجلّات التي تمّ جمعها للخطأ تحمل عنصرًا من النوع "google.ima.AdError" والذي يمكن الوصول إليه باستخدام المفتاح "adError".