מחלקה: AdEvent

google. ima.AdEvent

class סטטי

מודעה מסוג זה מוצגת במודעה כאשר מצב המודעה משתנה וכשמשתמשים מקיימים אינטראקציה עם המודעה. לדוגמה, כשהמודעה מתחילה להופיע, כאשר לוחצים עליה ועוד. אפשר להירשם ב-AdsManager לאירועים השונים שבוצעו במצב שינוי המדינה.

מספור

סוג

סטטוס

מחרוזת

סוגים של אירועי AdEvent

ערך
AD_CAN_PLAY	מופעל כשהמודעה מוכנה להפעלה ללא אחסון במאגר נתונים, בתחילת המודעה או אחרי סיום תהליך אגירת הנתונים.
CONTENT_PAUSE_REQUESTED	מופעל כשמתבצעת השהיה של תוכן. לרוב, זה קורה ממש לפני שמודעה עומדת לכסות את התוכן.
CONTENT_RESUME_REQUESTED	מופעל כשממשיכים לחדש את התוכן. לרוב זה קורה כשמודעה מסתיימת או מכווצת.
קליק	מופעל כשמשתמש לוחץ על המודעה.
בוצעה לחיצה על הסרטון	מופעל כאשר לוחצים על החלק שאינו קליק במודעה במודעת וידאו.
סרטון_לחץ_	מופעל כשמשתמש לוחץ על סמל של סרטון.
התחיל	מופעל כשהמודעה מתחילה לפעול.
התקדמות	מופעל כשערך הזמן הנוכחי של המודעה משתנה. קריאה ל-getAdData() באירוע הזה תחזיר אובייקט AdProgressData.
אחסון זמני של מודעות	מופעל כשהמודעה נעצרת לצורך אגירת נתונים.
חשיפות	מופעל כאשר מתבצעת פינג לכתובת ה-URL של החשיפה.
מושהה	מופעל כשהמודעה מושהית.
המשך	מופעל כשהמודעה מופעלת מחדש.
FIRST_QUARTILE	מופעל כשנקודת הזמן של המודעה חוצה את הרבעון הראשון של המודעה.
נקודת אמצע	מופעל כשסמן המיקום של המודעה חוצה את נקודת האמצע.
SECOND_QUARTILE	מופעל כאשר מיקום הסמן של המודעה חוצה את הרבעון השלישי.
סיום	מופעל כשהצגת המודעה מסתיימת.
DURATION_CHANGE	מופעל כשמשך המודעה משתנה.
USER_CLOSE	מופעל כשהמשתמש סוגר את המודעה.
נטענו	מופעל כשנתוני המודעה זמינים.
ALL_ADS_COMPLETED	מופעל כשמנהל המודעות מסיים להפעיל את כל המודעות החוקיות בתגובה למודעות, או כשהתגובה לא מחזירה מודעות חוקיות.
לא בוצעה העלאה	מופעל כשהמשתמש מדלג על המודעה.
LINEAR_היה שינוי	מופעל כשהמודעה המוצגת משתנה מלינארית ללינארית, או להפך.
SKIPPABLE_STATE_CHANGED	מופעל כשמצב המודעה שניתן לדלג עליו שמוצג במודעות משתנה.
AD_מטא-נתונים	מופעל כשרשימת מודעות נטענת.
AD_BREAK_READY	מופעל כשכלל מודעות או הפסקה למודעה בפורמט VMAP היו מופעלים אם autoPlayAdBreaks היה False.
יומן	מופעל כשאירעה שגיאה לא חמורה. המשתמש לא צריך לבצע כל פעולה מכיוון שה-SDK ימשיך עם אותה הפעלת מודעה או עם ההפעלה הבאה, בהתאם למצב השגיאה.
VOLUME_CHANGED	מופעל כשנפח המודעות משתנה.
VOLUME_MUTED	מופעל כשעוצמת הקול של המודעה מושתקת.
אינטראקציה	מופעל כשמודעה מפעילה את הקריאה החוזרת לאינטראקציה. אינטראקציות עם מודעות מכילות מחרוזת מזהה אינטראקציה בנתוני המודעה.

מאפיין (property)

סוג

סטטוס

מחרוזת

סוגים של אירועי AdEvent

ערך
AD_CAN_PLAY	מופעל כשהמודעה מוכנה להפעלה ללא אחסון במאגר נתונים, בתחילת המודעה או אחרי סיום תהליך אגירת הנתונים.
CONTENT_PAUSE_REQUESTED	מופעל כשמתבצעת השהיה של תוכן. לרוב, זה קורה ממש לפני שמודעה עומדת לכסות את התוכן.
CONTENT_RESUME_REQUESTED	מופעל כשממשיכים לחדש את התוכן. לרוב זה קורה כשמודעה מסתיימת או מכווצת.
קליק	מופעל כשמשתמש לוחץ על המודעה.
בוצעה לחיצה על הסרטון	מופעל כאשר לוחצים על החלק שאינו קליק במודעה במודעת וידאו.
סרטון_לחץ_	מופעל כשמשתמש לוחץ על סמל של סרטון.
התחיל	מופעל כשהמודעה מתחילה לפעול.
התקדמות	מופעל כשערך הזמן הנוכחי של המודעה משתנה. קריאה ל-getAdData() באירוע הזה תחזיר אובייקט AdProgressData.
אחסון זמני של מודעות	מופעל כשהמודעה נעצרת לצורך אגירת נתונים.
חשיפות	מופעל כאשר מתבצעת פינג לכתובת ה-URL של החשיפה.
מושהה	מופעל כשהמודעה מושהית.
המשך	מופעל כשהמודעה מופעלת מחדש.
FIRST_QUARTILE	מופעל כשנקודת הזמן של המודעה חוצה את הרבעון הראשון של המודעה.
נקודת אמצע	מופעל כשסמן המיקום של המודעה חוצה את נקודת האמצע.
SECOND_QUARTILE	מופעל כאשר מיקום הסמן של המודעה חוצה את הרבעון השלישי.
סיום	מופעל כשהצגת המודעה מסתיימת.
DURATION_CHANGE	מופעל כשמשך המודעה משתנה.
USER_CLOSE	מופעל כשהמשתמש סוגר את המודעה.
נטענו	מופעל כשנתוני המודעה זמינים.
ALL_ADS_COMPLETED	מופעל כשמנהל המודעות מסיים להפעיל את כל המודעות החוקיות בתגובה למודעות, או כשהתגובה לא מחזירה מודעות חוקיות.
לא בוצעה העלאה	מופעל כשהמשתמש מדלג על המודעה.
LINEAR_היה שינוי	מופעל כשהמודעה המוצגת משתנה מלינארית ללינארית, או להפך.
SKIPPABLE_STATE_CHANGED	מופעל כשמצב המודעה שניתן לדלג עליו שמוצג במודעות משתנה.
AD_מטא-נתונים	מופעל כשרשימת מודעות נטענת.
AD_BREAK_READY	מופעל כשכלל מודעות או הפסקה למודעה בפורמט VMAP היו מופעלים אם autoPlayAdBreaks היה False.
יומן	מופעל כשאירעה שגיאה לא חמורה. המשתמש לא צריך לבצע כל פעולה מכיוון שה-SDK ימשיך עם אותה הפעלת מודעה או עם ההפעלה הבאה, בהתאם למצב השגיאה.
VOLUME_CHANGED	מופעל כשנפח המודעות משתנה.
VOLUME_MUTED	מופעל כשעוצמת הקול של המודעה מושתקת.
אינטראקציה	מופעל כשמודעה מפעילה את הקריאה החוזרת לאינטראקציה. אינטראקציות עם מודעות מכילות מחרוזת מזהה אינטראקציה בנתוני המודעה.

שיטות

getAd

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'.