کلاس: AdEvent

گوگل ایما . AdEvent

کلاس ایستا

این نوع رویداد توسط آگهی به عنوان یک اعلان در هنگام تغییر وضعیت آگهی و زمانی که کاربران با آگهی تعامل می کنند، مطرح می شود. به عنوان مثال، هنگامی که تبلیغ شروع به پخش می کند، روی آن کلیک می شود و موارد دیگر. می توانید برای رویدادهای مختلف تغییر وضعیت در AdsManager ثبت نام کنید.

شمارش

تایپ کنید

ایستا

رشته

انواع AdEvents

ارزش
AD_CAN_PLAY	هنگامی که تبلیغ آماده پخش بدون بافر باشد، در ابتدای تبلیغ یا پس از تکمیل بافر، پخش می‌شود.
CONTENT_PAUSE_REQUESTED	زمانی فعال می شود که محتوا باید متوقف شود. این معمولاً درست قبل از اینکه تبلیغی در حال پوشش دادن محتوا باشد اتفاق می افتد.
CONTENT_RESUME_REQUESTED	زمانی آتش می‌گیرد که محتوا باید از سر گرفته شود. این معمولاً زمانی اتفاق می‌افتد که یک آگهی تمام می‌شود یا فرو می‌ریزد.
کلیک	وقتی روی تبلیغ کلیک می شود آتش می گیرد.
VIDEO_CLICKED	زمانی فعال می شود که روی قسمت غیرکلیکی یک تبلیغ ویدیویی کلیک شود.
VIDEO_ICON_CLICKED	وقتی کاربر روی نماد ویدیو کلیک می کند فعال می شود.
آغاز شده	با شروع پخش آگهی فعال می شود.
AD_PROGRESS	زمانی فعال می شود که ارزش زمانی فعلی آگهی تغییر کند. فراخوانی getAdData() در این رویداد یک شی AdProgressData را برمی گرداند.
AD_BUFFERING	زمانی فعال می شود که پخش آگهی در بافر متوقف شده باشد.
احساس؛ عقیده؛ گمان	زمانی فعال می شود که نشانی اینترنتی نمایش پینگ شده باشد.
مکث شد	هنگامی که تبلیغ متوقف می شود فعال می شود.
از سر گرفته شد	هنگامی که آگهی از سر گرفته می شود آتش می گیرد.
FIRST_QUARTILE	زمانی فعال می‌شود که هد پخش آگهی از ربع اول عبور کند.
نقطه میانی	هنگامی که صفحه پخش آگهی از نقطه وسط عبور می کند، فعال می شود.
THIRD_QUARTILE	زمانی فعال می شود که هد پخش آگهی از ربع سوم عبور کند.
کامل	هنگامی که پخش آگهی به پایان می رسد فعال می شود.
DURATION_CHANGE	هنگامی که مدت زمان آگهی تغییر می کند فعال می شود.
USER_CLOSE	هنگامی که تبلیغ توسط کاربر بسته می شود، آتش می گیرد.
لود شده	وقتی داده‌های آگهی در دسترس باشد، آتش می‌گیرد.
ALL_ADS_COMPLETED	زمانی فعال می‌شود که مدیر آگهی‌ها همه آگهی‌های معتبر را در پاسخ آگهی‌ها پخش کند، یا وقتی پاسخ هیچ آگهی معتبری را برنمی‌گرداند.
رد شد	هنگامی که تبلیغ توسط کاربر نادیده گرفته می شود فعال می شود.
LINEAR_CHANGED	زمانی فعال می شود که تبلیغ نمایش داده شده از خطی به غیرخطی یا برعکس تغییر کند.
SKIPPABLE_STATE_CHANGED	هنگامی که حالت رد شدن تبلیغات نمایش داده شده تغییر می کند، فعال می شود.
AD_METADATA	هنگامی که لیست تبلیغات بارگیری می شود فعال می شود.
AD_BREAK_READY	در صورت نادرست بودن autoPlayAdBreaks، زمانی فعال می‌شود که یک قانون تبلیغات یا یک وقفه تبلیغاتی VMAP پخش شود.
ورود به سیستم	زمانی آتش می گیرد که با خطای غیر کشنده مواجه شود. کاربر نیازی به انجام هیچ اقدامی ندارد زیرا بسته به موقعیت خطا، SDK با همان بازپخش آگهی یا بعدی ادامه خواهد یافت.
VOLUME_CHANGED	هنگامی که حجم آگهی تغییر کرده است، فعال می شود.
VOLUME_MUTED	هنگامی که حجم آگهی بی صدا شده باشد فعال می شود.
اثر متقابل	زمانی فعال می شود که یک آگهی پاسخ تماس متقابل را فعال کند. تعاملات تبلیغاتی شامل یک رشته شناسه تعامل در داده های آگهی است.

ویژگی

تایپ کنید

ایستا

رشته

انواع AdEvents

ارزش
AD_CAN_PLAY	هنگامی که تبلیغ آماده پخش بدون بافر باشد، در ابتدای تبلیغ یا پس از تکمیل بافر، پخش می‌شود.
CONTENT_PAUSE_REQUESTED	زمانی فعال می شود که محتوا باید متوقف شود. این معمولاً درست قبل از اینکه تبلیغی در حال پوشش دادن محتوا باشد اتفاق می افتد.
CONTENT_RESUME_REQUESTED	زمانی آتش می‌گیرد که محتوا باید از سر گرفته شود. این معمولاً زمانی اتفاق می‌افتد که یک آگهی تمام می‌شود یا فرو می‌ریزد.
کلیک	وقتی روی تبلیغ کلیک می شود آتش می گیرد.
VIDEO_CLICKED	زمانی فعال می شود که روی قسمت غیرکلیکی یک تبلیغ ویدیویی کلیک شود.
VIDEO_ICON_CLICKED	وقتی کاربر روی نماد ویدیو کلیک می کند فعال می شود.
آغاز شده	با شروع پخش آگهی فعال می شود.
AD_PROGRESS	زمانی فعال می شود که ارزش زمانی فعلی آگهی تغییر کند. فراخوانی getAdData() در این رویداد یک شی AdProgressData را برمی گرداند.
AD_BUFFERING	زمانی فعال می شود که پخش آگهی در بافر متوقف شده باشد.
احساس؛ عقیده؛ گمان	زمانی فعال می شود که نشانی اینترنتی نمایش پینگ شده باشد.
مکث شد	هنگامی که تبلیغ متوقف می شود فعال می شود.
از سر گرفته شد	هنگامی که آگهی از سر گرفته می شود آتش می گیرد.
FIRST_QUARTILE	زمانی فعال می‌شود که هد پخش آگهی از ربع اول عبور کند.
نقطه میانی	هنگامی که صفحه پخش آگهی از نقطه وسط عبور می کند، فعال می شود.
THIRD_QUARTILE	زمانی فعال می شود که هد پخش آگهی از ربع سوم عبور کند.
کامل	هنگامی که پخش آگهی به پایان می رسد فعال می شود.
DURATION_CHANGE	هنگامی که مدت زمان آگهی تغییر می کند فعال می شود.
USER_CLOSE	هنگامی که تبلیغ توسط کاربر بسته می شود، آتش می گیرد.
لود شده	وقتی داده‌های آگهی در دسترس باشد، آتش می‌گیرد.
ALL_ADS_COMPLETED	زمانی فعال می‌شود که مدیر آگهی‌ها همه آگهی‌های معتبر را در پاسخ آگهی‌ها پخش کند، یا وقتی پاسخ هیچ آگهی معتبری را برنمی‌گرداند.
رد شد	هنگامی که تبلیغ توسط کاربر نادیده گرفته می شود فعال می شود.
LINEAR_CHANGED	زمانی فعال می شود که تبلیغ نمایش داده شده از خطی به غیرخطی یا برعکس تغییر کند.
SKIPPABLE_STATE_CHANGED	هنگامی که حالت رد شدن تبلیغات نمایش داده شده تغییر می کند، فعال می شود.
AD_METADATA	هنگامی که لیست تبلیغات بارگیری می شود فعال می شود.
AD_BREAK_READY	در صورت نادرست بودن autoPlayAdBreaks، زمانی فعال می‌شود که یک قانون تبلیغات یا یک وقفه تبلیغاتی VMAP پخش شود.
ورود به سیستم	زمانی آتش می گیرد که با خطای غیر کشنده مواجه شود. کاربر نیازی به انجام هیچ اقدامی ندارد زیرا بسته به موقعیت خطا، SDK با همان بازپخش آگهی یا بعدی ادامه خواهد یافت.
VOLUME_CHANGED	هنگامی که حجم آگهی تغییر کرده است، فعال می شود.
VOLUME_MUTED	هنگامی که حجم آگهی بی صدا شده باشد فعال می شود.
اثر متقابل	زمانی فعال می شود که یک آگهی پاسخ تماس متقابل را فعال کند. تعاملات تبلیغاتی شامل یک رشته شناسه تعامل در داده های آگهی است.

مواد و روش ها

getAd

getAd() Ad را برمی گرداند

آگهی فعلی را که در حال پخش است یا تازه پخش شده است، دریافت کنید.

برمی گرداند

nullable Ad آگهی مرتبط با رویداد، یا در صورت عدم وجود آگهی مرتبط، باطل می شود.

getAdData

getAdData() Object را برمی گرداند

اجازه می دهد تا داده های اضافی از آگهی منتقل شود.

مثال:

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» قابل دسترسی است.