דף זה תורגם על ידי Cloud Translation API.

מחלקה: AdDisplayContainer

google.ima.AdDisplayContainer

class סטטי

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

כשמופע של כיתה זו נוצר, ה-IFRAME נוצר ב-ContainerElement וטוען את ליבת ה-SDK. צריך לשמור את ה-IFRAME הזה כדי שה-SDK יפעל כראוי. לאחר הפעלת כל המודעות ו-SDK אינו נחוץ יותר, יש להשתמש בשיטה destroy() כדי להסיר את ה-SDK.

פרמטר ה-ContainerElement חייב להיות רכיב המהווה חלק מ-DOM. כדי להציג את המודעות בצורה נכונה, יש למקם את מאגר התגים בצורה נכונה. מומלץ למקם אותו מעל נגן הווידאו של התוכן ולהתאים אותו כך שיכסה את כל נגן הווידאו. לפרטים על הטמעות מומלצות, אפשר לעיין במסמכי התיעוד של SDK.

הערה: תמיד יש צורך להפעיל את השיטה initialize() בקוד שמופעל ישירות על ידי פעולת משתמש (כמו קליק או הקשה).

יצרן

מאגר AdDisplay

חדש AdDisplayContainer(containerElement, videoElement, clickTrackingElement)

פרמטר
רכיב מכיל	הרכיב שבו יש להציג את המודעות. צריך להוסיף את הרכיב ל-DOM לפני שיוצרים AdDisplayContainer. הערך לא יכול להיות ריק.
רכיב וידאו	אופציונלי מציין את רכיב ההפעלה החלופי של מודעות וידאו. תמיד מומלץ להשתמש בנגן הווידאו שלך. הערך לא יכול להיות ריק.
קליקלמעקב	אופציונלי המדיניות מציינת את אלמנט הקליק החלופי של מודעת וידאו. יש להשאיר את הערך הזה ריק כדי לאפשר ל-SDK לטפל בקליקים. גם אם סופקה, ערכת ה-SDK תשתמש ברכיב המותאם אישית למעקב אחר קליקים רק כאשר קריאייטיבים שאינם של AdSense/JavaScript מוצגים בסביבות שאינן תומכות ברכיבים של ממשק המשתמש שכוללים שכבת-על של נגן וידאו (לדוגמה, iPhone או בגרסה שקודמת ל-4.0 Android). לעולם אין לעבד את אלמנט המעקב המותאם אישית מעל נגן הווידאו כי הוא יכול ליירט קליקים לרכיבי ממשק משתמש שמתבצע ב-SDK. חשוב לציין גם שה-SDK לא ישנה את החשיפה של אלמנט המעקב המותאם אישית. המשמעות היא שאם סופק רכיב מעקב מותאם אישית של קליק, הוא חייב להיות מוצג כהלכה כאשר המודעה הלינארית מופעלת. אפשר לבדוק את ima.AdsManager.isCustomClickTrackingUsed כאשר האירוע ima.AdEvent.Type.STARTED יופעל כדי לקבוע אם להציג את המרכיב המותאם אישית של מעקב הקליקים. אם זה מתאים לממשק המשתמש, עליך להסתיר את רכיב מעקב הקליקים בזמן שהאירוע ima.AdEvent.Type.CONTENT_RESUME_REQUESTED יופעל. הערך לא יכול להיות ריק.

פרמטר

רכיב מכיל

הרכיב שבו יש להציג את המודעות. צריך להוסיף את הרכיב ל-DOM לפני שיוצרים AdDisplayContainer.

הערך לא יכול להיות ריק.

רכיב וידאו

אופציונלי

מציין את רכיב ההפעלה החלופי של מודעות וידאו. תמיד מומלץ להשתמש בנגן הווידאו שלך.

הערך לא יכול להיות ריק.

קליקלמעקב

אופציונלי

המדיניות מציינת את אלמנט הקליק החלופי של מודעת וידאו. יש להשאיר את הערך הזה ריק כדי לאפשר ל-SDK לטפל בקליקים. גם אם סופקה, ערכת ה-SDK תשתמש ברכיב המותאם אישית למעקב אחר קליקים רק כאשר קריאייטיבים שאינם של AdSense/JavaScript מוצגים בסביבות שאינן תומכות ברכיבים של ממשק המשתמש שכוללים שכבת-על של נגן וידאו (לדוגמה, iPhone או בגרסה שקודמת ל-4.0 Android). לעולם אין לעבד את אלמנט המעקב המותאם אישית מעל נגן הווידאו כי הוא יכול ליירט קליקים לרכיבי ממשק משתמש שמתבצע ב-SDK. חשוב לציין גם שה-SDK לא ישנה את החשיפה של אלמנט המעקב המותאם אישית. המשמעות היא שאם סופק רכיב מעקב מותאם אישית של קליק, הוא חייב להיות מוצג כהלכה כאשר המודעה הלינארית מופעלת. אפשר לבדוק את ima.AdsManager.isCustomClickTrackingUsed כאשר האירוע ima.AdEvent.Type.STARTED יופעל כדי לקבוע אם להציג את המרכיב המותאם אישית של מעקב הקליקים. אם זה מתאים לממשק המשתמש, עליך להסתיר את רכיב מעקב הקליקים בזמן שהאירוע ima.AdEvent.Type.CONTENT_RESUME_REQUESTED יופעל.

הערך לא יכול להיות ריק.

שיטות

כיבוי סופי

מחיקה סופית(

הרס מצבים פנימיים ורכיבי DOM שנוצרו בעבר. טעינת ה-IMA SDK תבוטל ולא יבוצעו קריאות נוספות ל-API.

אתחול

תרגיל (()ize)

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

דפדפנים מסוימים יאפשרו הפעלת סרטונים ללא אינטראקציות של משתמשים, אם הסרטון מושתק. כדי לבצע את הפעולה הזו, יש להשתמש בשיטה AdsRequest.setAdWillPlayMuted(true) ולהתקשר לשיטה הזו לפני AdsManager.start().