שאלות נפוצות בנושא Interactive Media Ads SDK של Google

למה לא מוצגות לי מודעות בכל הפורמטים?
תגי מודעות הבדיקה מוגדרים כך שיחזירו תמיד מודעות בבקשות חוקיות. הדבר נועד להקל על השילוב והבדיקה של האופן שבו הנגן שלך מבקש ומציג מודעות. עם זאת, לא תמיד יש מודעות זמינות בכל פורמט עבור האתר, החשבון או יחידת המודעות שלך. אם השילוב שלך פועל בצורה תקינה בתג הבדיקה, אבל לא בתג שלך, הסיבה לכך יכולה להיות אחת מהאפשרויות הבאות:
  • באזור שלך מוצגים סרטונים בפורמט שאינו נתמך. לדוגמה, אתם מציגים מודעות HTML5 בלבד ב-iOS או ב-Android.
  • אם השתמשת ב-Ad Manager, ייתכן שלמזהה בעל האתר שלך אין כרגע מודעות הממוקדות אליו. בנוסף, עליך לוודא שאישרת את המודעות ואת הקריאייטיבים הרלוונטיים ב-Ad Manager.
  • אם בחרת להשתמש ב-AdSense, ייתכן שבקריטריונים לטירגוט של האתר או של דף הבדיקה לא מוצגות מודעות פעילות. הסיבה הנפוצה ביותר היא שימוש באתרים פרטיים שלא נסרקו.
  • אם השתמשת ב-Ad Manager Network Partner Manager ו-descriptionURL לא מוגדר או לא נמצא ברשימת ניהול הדומיינים שבבעלות או שמופעלים, לא יוצגו מודעות לכך.
  • בדקו את ערכי הסף של minCPM שהוגדרו ב-Ad Exchange Video. מחיר גבוה לאלף חשיפות עשוי להוביל לשיעורי מילוי נמוכים מאוד. כדי לתקן זאת, אפשר לנסות להסיר את העלות המינימלית לאלף חשיפות או להסיר את הפרמטר של יחידת המודעות מהבקשה להצגת המודעה (כלומר, מיקום המודעה) כדי לבדוק אם זה משפיע על שיעור המילוי.
איך נראה descriptionUrl טוב?
כדי להשיג את היעילות הרבה ביותר, תוכן הדף שאליו descriptionUrl מפנה לא צריך להיות מורכב מאוסף של מילים או ביטויים, אלא באורך של 1-3 פסקאות המתארות בפועל את התוכן ותפקידך לספק אותו. שיטה אחת שהצליחה בעבר היא לחבר יחד תוכן של דף descriptionUrl באופן דינמי מחסימות מוגדרות מראש. לדוגמה, כמה משפטים לגבי התוכן, כמה משפטים לגבי מה שהאתר מציע ולאחר מכן כמה קטעי קוד מוגדרים מראש המשויכים לכל ערוץ AdSense (כמו "בידור" או "ספורט"). כתוצאה מכך, לכל קטע תוכן משויך descriptionUrl באופן מובהק, שמשויך למידע כללי (כגון תיאורי הז'אנרים) וגם מידע ספציפי (תוכן לגבי התוכן באופן ישיר).

ה-HTML של המטא-נתונים צריך להיות פשוט, לדוגמה:

<html>
  <head>
    <title>Domain.com - Your tag line here!</title>
  </head>
  <body>
    <h1>Descriptions</h1>
    <h2>About this Content</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
    <h2>About Domain.com</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
  </body>
</html>
למה מופיעה השגיאה "התגובה למודעה לא מכילה סוג מודעה חוקי"?
בדרך כלל, השגיאה הזו מופיעה כי לא טרגטו מודעות לpublisherId הספציפי (עבור תקופת הזמן הנתונה). התנאי הזה עשוי להשתנות לאורך היום או במשך כמה ימים מרגע שהקמפיינים מתחילים ומסתיימים. עליך לוודא שפג תוקפה של המודעה שאליה ברצונך לטרגט, ושהקריטריונים של טירגוט המודעות נכונים. כל עוד הבקשות מתקבלות, מתקבלות ומעובדות כראוי באמצעות הבדיקה publisherId, אפשר לוודא שהמודעות האלה יטופלו כראוי בזמן שה-publisherId זמין כשהמודעות יהיו זמינות.
האם יש לך תג מודעת וידאו של Ad Manager שאוכל להשתמש בו לבדיקה?
תגים לדוגמה זמינים בדף תגים לדוגמה.
האם עליי להגדיר את adSlotWidth ואת adSlotHeight עם אותם ערכים כמו sz בתג המודעה של Ad Manager?
לא בהכרח. ההגדרה של adSlotWidth ושל adSlotHeight צריכה להיות ברוחב/גובה של הנגן או של האזור שבהם רוצים להציג את המודעות. הם משמשים את AdSense כדי לקבוע אילו מודעות זמינות למרחב המשותף הזה. צמד המפתח/ערך sz שבתג המודעה של Ad Manager הוא פרמטר טירגוט, והוא לא בהכרח משפיע על הקריאייטיב שמוצג (מידע נוסף מופיע בהמשך).
התג של מודעת ההדגמה נראה מצוין, אבל כשמחליפים אותו בתג המודעה שלי, לא מוצגת מודעה.
יש לוודא ששום דבר לא נשלח אל תג המודעה שביקשת. הדרך הקלה ביותר לגלות זאת היא לצפות בתנועת ה-HTTP. אם תמונה של פיקסל 1x1 אפור.gif מוחזרת בתוך בלוק של מודעות עוגן, צריך לבדוק את הטירגוט ב-Ad Manager.
אני רוצה לבקש מודעות באמצעות אותו תג יותר מפעם אחת, אבל אני מקבלת מודעות רק לבקשה הראשונה שלי. כיצד ניתן לתקן זאת?
כשמבקשים מודעות יותר מפעם אחת, צריך להודיע לשרת המודעות שמדובר בבקשות לגיטימיות ולא בכפילויות מקריות. ה-SDK מבצע זאת באמצעות שתי קריאות מהירות ל-API:
  1. התקשרות אל destroy() במכונה של AdsManager. הפעולה הזו מונעת הצגה של מודעות בסוף הסרטון כשמבצעים את הקריאה הבאה ל-contentComplete(). עם הבקשה הבאה, יישלח לך AdsManager חדש.
  2. התקשרות אל contentComplete() במכונה של AdsLoader. הפעולה הזו מאפסת את ה-SDK כך שהבקשה החדשה להצגת מודעה לא נראית כמו הכפילות של הבקשה הקודמת.
אחרי ביצוע שתי השיחות שלמעלה, ניתן יהיה לקרוא ל-requestAds() במכונה של AdsLoader כדי להפעיל עוד קבוצת מודעות עבור הסרטון החדש.
איך אפשר לבקש מודעות שכבת-על ומודעות AdSense במשבצת מלאה באמצעות IMA SDK?

כדי לבקש מודעות AdSense באמצעות ה-SDK, תחילה עליך לקבל תג מודעה של AdSense. מידע נוסף בנושא זמין בדף AdSense לווידאו. לאחר שבחרת בתג שלך, עליך לבצע את השלבים הבאים כדי ליצור שכבת-על או בקשה להצגת מודעה במיקום מלא:

מודעות שכבת-על
  1. בשדה AdsRequest, מגדירים את מצב התצוגה NORMAL.
  2. יש להוסיף את הפרמטר overlay=1 לתג המודעה.
מודעות משבצת מלאה
  1. בשדה AdsRequest, מגדירים את מצב התצוגה FULLSCREEN.
  2. יש להוסיף את הפרמטר overlay=0 לתג המודעה.
השגיאה "כתובת ה-URL לקליקים לא חוקית" מופיעה כשלוחצים על המודעה. מה יכולה להיות הסיבה לכך?
הסיבה השכיחה ביותר לשגיאה הזו היא כתובת URL לקליקים שלא טופלה כראוי. אם השגיאה הזו מופיעה, יש לוודא שכתובת ה-URL לקליקים סומנה בתו בריחה (escape) כראוי בתגובת ה-VAST.
למה אני רואה את השגיאה "VAST Document Empty" (ריק של מסמך VAST)?
שגיאה זו מתרחשת כאשר תג המודעה מחזיר מסמך VAST ריק, שמציין שהמודעה לא הוצגה כראוי. ניתן לפנות למנהל החשבון או לנציג של שרת המודעות כדי לבדוק למה תג המודעה לא עובד.
האם אפשר לשנות את הגודל או את הטקסט של התיבה דילוג על המודעה או רכיבים אחרים של ממשק המשתמש?
ערכות ה-IMA SDK לא תומכות בשינוי הפריסה, הגודל או התוכן של רכיבי ממשק המשתמש. מידע נוסף על רכיבי ממשק משתמש זמין במאמר AdsManager.uiElements.
האם פקדי וידאו מותאמים נתמכים באמצעות HTML5 SDK?
לא, HTML5 SDK לא תומך באמצעי בקרה מותאמים.
אני רואה את ההודעה 'הפעולה נכשלה ב-'play' ב-'HTMLMediaElement': ניתן להפעיל ממשק API רק באמצעות תנועת משתמש, ביישום של HTML5. כיצד ניתן לתקן זאת?
במכשירים ניידים, צריך לקרוא לפונקציה adDisplayContainer.initialize() בעקבות פעולה של משתמש (כמו הקשה). אם השגיאה הזו מופיעה, סביר להניח שהיא תיקרא בהקשר שאינו ביוזמת המשתמש. חשוב לזכור שהיא חייבת להיות תוצאה ישירה של פעולת משתמש. לדוגמה, אם הגבתם לאירוע 'הקשה' על ידי הפעלת סרטון, ואז תשתמשו באירוע 'הפעלה' של נגן הווידאו כדי להפעיל את initialize(), ה-SDK יחזיר את השגיאה הזו. צריך להפעיל את initialize() בתור התוצאה של אירוע ההקשה עצמו.
כיצד אוכל להתמודד עם התמקדות המקלדת בקליקים על מודעות?
אם יש לך לחצנים לשליטה בנגן בנגן, אפשר לראות שהם כבר לא יפעלו בלחיצה על adDisplayContainer. הסיבה לכך היא שבעת הלחיצה על מודעה, מיקוד המקלדת מועבר ל-IMA iframe. כדי שהמיקוד במקלדת ימשיך להיות בנגן התוכן, יש להשתמש באירוע CLICK כדי להעביר את מיקוד המקלדת בחזרה למאגר הרצוי. לפרטים נוספים, קראו את קטע הקוד הבא: 
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });