google.
מחלקה לציון מאפיינים של הבקשה להצגת מודעה.
יצרן
בקשה להצגת מודעות
בקשה חדשה (Ads)(
- יישומים
- google.ima.AdsRequestInterface
נכסים
adTagUrl
מחרוזת
מציינת את כתובת ה-URL של תג המודעה שהתבקשה משרת המודעות. למידע נוסף על בניית כתובת ה-URL של תג המודעה, קראו את המאמר יצירת תג וידאו ראשי של מודעה באופן ידני.
הפרמטר הזה נדרש.
תשובה למודעה
(null, מחרוזת או מסמך שאינו Null)
המדיניות מציינת מסמך VAST 2.0 שישמש כתגובה למודעות במקום לשלוח בקשה דרך כתובת URL של תג מודעה. פעולה זו יכולה לעזור בניפוי באגים ובמצבים אחרים שבהם כבר יש תגובת VAST.
הפרמטר הזה הוא אופציונלי.
משך זמן של תוכן
(null או מספר)
מציינת את משך הזמן של התוכן בשניות. נעשה בו שימוש בשני מקרים: 1) טירגוט מודעות של AdX ו-2) החלטה מתי לטעון מראש את הסרטון לאחר צפייה ב-VMAP.
הפרמטר הזה אופציונלי.
מילות מפתח המופיעות בתוכן
(מערך מחרוזת או ריק)
מציינת את מילות המפתח המשמשות לתיאור התוכן שיוצג. בשימוש בבקשות של AdX.
הפרמטר הזה אופציונלי.
כותרת התוכן
(null או מחרוזת)
מציינת את כותרת התוכן שיוצג. בשימוש בבקשות של AdX.
הפרמטר הזה אופציונלי.
nonNonFullFullSlot
בוליאני
המדיניות הזו מאלצת הצגה של מודעות AdSense לא לינאריות כמיקום מודעה לינארי מלא. אם היא מוגדרת, סרטון התוכן יושהה ומודעת הטקסט או התמונה לא לינארית תוצג כמשבצת מלאה. הסרטון 'תוכן' ימשיך לפעול לאחר דילוג על המודעה או סגירתה.
גובה מודעה לינארי
מספר
מציינת את הגובה של האזור המלבני שבתוכו מוצגת מודעה לינארית. ערך זה משמש כאחד מהקריטריונים לבחירת מודעות. הערך הזה לא חייב להתאים לגובה המודעה בפועל.
הפרמטר הזה נדרש.
לינאריAdSlotWidth
מספר
מציינת את הרוחב של האזור המלבני שבתוכו מוצגת מודעה לינארית. ערך זה משמש כאחד מהקריטריונים לבחירת מודעות. הערך הזה לא חייב להתאים לרוחב המודעה בפועל.
הפרמטר הזה נדרש.
liveStreamPrefetchSeconds
מספר
המדיניות מציינת את משך הזמן המקסימלי להמתנה בשניות, לאחר קריאה ל-requestAds, לפני שליחת הבקשה לכתובת ה-URL של תג המודעה. ניתן להשתמש באפשרות הזו כדי להציג בקשות במהלך אירוע בשידור חי, כדי לצמצם את עליות חדות במספר הבקשות.
לא לינארי של מודעות
מספר
מציינת את הגובה של האזור המלבני שבתוכו מודעה לא לינארית מוצגת. ערך זה משמש כאחד מהקריטריונים לבחירת מודעות. הערך הזה לא חייב להתאים לגובה המודעה בפועל.
הפרמטר הזה נדרש.
NonLinearAdSlotWidth
מספר
מציינת את הרוחב של האזור המלבני שבתוכו מוצגת מודעה לא לינארית. ערך זה משמש כאחד מהקריטריונים לבחירת מודעות. הערך הזה לא חייב להתאים לרוחב המודעה בפועל.
הפרמטר הזה נדרש.
omidAccessModeRules
אובייקט שאינו Null עם מאפייני מחרוזת
אובייקט ההגדרות למיפוי ספקים לאימות במצבי OMID. המפתחות חייבים להיות ערכים ב-google.ima.OmidVerificationספק, והערכים חייבים להיות ערכים ב-google.ima.OmidAccessMode.
כתובות ה-URL של סקריפט האימות מותאמות באופן פנימי לביטויים רגולריים של הספקים שסופקו, כדי לפענח את המפתח של OmidAuthenticationProvider. לאחר מכן IMA מחפש את מצב הגישה של הספק הנתון באמצעות אובייקט זה.
אם יש כתובות URL של סקריפטים שלא מפנות לספק ידוע, או אם ספק ה-OmidVerifyProvide, שלא מסופק באובייקט הזה, IMA ישתמש במצב הגישה שסופק עבור OmidVerification Provider.OTHER אם ספק ה-OmidVerification Provider אינו כלול.ייעשה שימוש במצב הגישה המוגבלת.
כתובת URL של הדף
(null או מחרוזת)
מציינת את כתובת ה-URL המלאה של הדף שייכללו בבקשה להצגת מודעות של Google למטרות טירגוט. כתובת ה-URL צריכה להיות כתובת URL חוקית. אם צוין, הערך הזה ישמש עבור מאקרו VAST של [PAGEURL].
הפרמטר הזה אופציונלי.
VASTLoadTimeout
מספר
שינוי הזמן הקצוב לתפוגה של ברירת מחדל לעומס על VAST ב-אלפיות השנייה עבור wrapper יחיד. הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 5,000 אלפיות השנייה.
הפרמטר הזה אופציונלי.
שיטות
setAdווילAutoPlay
setAdווילAutoPlay(autoPlay) מחזיר ערך ריק
מודיעה ל-SDK אם הנגן מתכוון להתחיל את התוכן ואת המודעה בתגובה לפעולה של משתמש, או אם היא תופעל באופן אוטומטי. שינוי ההגדרה הזו לא ישפיע על הפעלת המודעות.
פרמטר |
|
|---|---|
|
הפעלה אוטומטית |
בוליאני האם התוכן והמודעה יופעלו באופן אוטומטי, או אם הם יופעלו על ידי פעולת משתמש. |
- החזרות
-
void
setAdווילPlayMuted
setAdווילPlayMuted(Muted) מחזירה
מודיעה ל-SDK אם הנגן מתכוון להתחיל את המודעה כשהוא מושתק. שינוי ההגדרה הזו לא ישפיע על הפעלת המודעות, אבל הוא ישלח את האות המתאים בבקשה למודעה כדי לאפשר לקונים להגיש הצעות מחיר על מלאי שטחי פרסום מושתק.
פרמטר |
|
|---|---|
|
מושתק |
בוליאני האם המודעה תופעל במצב מושתק. |
- החזרות
-
void
הגדרה רציפה (CI)
setContinuousהפעלה(הפעלה רציפה) מחזירה ריק
מודיעה ל-SDK אם הנגן מתכוון להמשיך לפעול את סרטוני התוכן אחד אחרי השני, בדומה לשידור בטלוויזיה. שינוי ההגדרה הזו לא ישפיע על ההפעלה של המודעה, אבל הוא ישלח את האות המתאים בבקשה הזו כדי לאפשר לקונים להגיש הצעות מחיר לפי סוג המלאי של המודעה.
פרמטר |
|
|---|---|
|
הפעלה רציפה |
בוליאני האם הסרטון מופעל ברצף, אחד אחרי השני. |
- החזרות
-
void