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

למה לא מוצגות לי מודעות לכל הפורמטים?
תגי המודעות לבדיקה מוגדרים כך שיחזירו תמיד מודעות עבור בקשות חוקיות. הדבר שנועדו להקל על השילוב וכדי שיהיה קל יותר לבדוק את האופן שבו הנגן מבקש ומציג מודעות. עם זאת, מודעות לא תמיד זמינות בכל לפורמט של האתר, החשבון או יחידת המודעות שלך. אם השילוב פועל מתאימה לתג הבדיקה אבל לא לתג שלך, ייתכן שהסיבה היא הבאים:
  • שאתם מציגים לסביבה שלכם סרטונים בפורמט שאינו נתמך. לדוגמה, אתם מציגים רק מודעות HTML5 ב-iOS או ב-Android.
  • אם אתם משתמשים ב-Ad Manager, ייתכן שמזהה בעל האתר שלכם לא כולל מודעות שמטורגטות אל בשלב הזה. כמו כן, צריך לוודא שאישרת את המודעות הרלוונטיות נכסי קריאייטיב ב-Ad Manager.
  • אם אתם משתמשים ב-AdSense, הקריטריונים לטירגוט לאתר או לדף הבדיקה שלכם לא מכילים מודעות פעילות. הסיבה הנפוצה ביותר היא השימוש באתרים פרטיים ולא נסרקו.
  • אם משתמשים ב'ניהול שותפי רשת של Ad Exchange' וגם 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 pixelpixel.gif מוחזרת בתוך בלוק HTML עוגן, צריך לבדוק את הטירגוט ב-Ad Manager.
אני רוצה לבקש מודעות עם אותו תג יותר מפעם אחת, אבל מוצגות לי מודעות רק בפעם הראשונה בקשה. איך אפשר לפתור את הבעיה הזאת?
כשמבקשים מודעות יותר מפעם אחת, צריך ליידע את שרת המודעות שמדובר בבקשות לגיטימיות, ולא בכפילויות מקריים. ה-SDK עושה זאת באמצעות שתי קריאות מהירות ל-API:
  1. קוראים לפונקציה destroy() במכונה של AdsManager. פעולה זו מונעת הפעלה של מודעות בסוף הסרטון כאשר מבצעים את הקריאה הבאה: contentComplete() קיבלת AdsManager חדש כשתשלחו את הבקשה הבאה.
  2. התקשרות אל contentComplete() במכשיר AdsLoader שלך מכונה. הפעולה הזו מאפסת את ה-SDK כך שהבקשה החדשה להצגת מודעה לא תיראה כמו כפילות של הפריט הקודם.
אחרי ביצוע שתי השיחות שצוינו למעלה, אפשר להתקשר למספר requestAds() במספר את המופע של AdsLoader כדי להפעיל עוד קבוצה של מודעות סרטון חדש.
איך אפשר לבקש מודעות AdSense בשכבת-על ובמיקום מלא באמצעות IMA SDK?

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

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