מבנה התיוג במוצרי 'AdSense לווידאו' ו-'AdSense למשחקים' שונה מאוד מזה של 'AdSense לתוכן'. נדרשים להם תג מסוג 'מודעות מדיה אינטראקטיביות' (IMA) והם מחזירים מודעות רק כשהקריאה להן מתבצעת באמצעות נגן וידאו או מפעיל משחקים המאפשר שילוב של ה-IMA SDK של Google ו/או התואם לתקני VAST או VPAID (לדוגמה, מתאם ה-IMA).
בדרך כלל אפשר ליצור את התגים האלה באמצעות מחולל התגים של AdSense לווידאו. בהמשך תוכל למצוא רשימה מקיפה של קריטריונים שתוכל להגדיר בתגים האלה של מודעות. על מנת שתג 'AdSense לווידאו' יציג מודעות, נדרשים רק כמה פרמטרים, אך תוכל להגיע לתגובות הרצויות של מודעות על-ידי הוספה של פרמטרים אופציונליים, כמו מזהי הערוצים, משך הזמן המקסימלי/המינימלי של מודעה, שפה וכו'.
| הפרמטר של תגי IMA למודעות | פרמטר נדרש |
|---|---|
| ad_type | כן |
| client | כן |
| description_url | כן - חייב להיות מקודד בכתובת האתר |
| channel | לא - אם זמין, מומלץ להשתמש בו |
| adsafe | לא - מומלץ |
| videoad_start_delay | לא - מומלץ |
| hl | לא - מומלץ |
| max_ad_duration | לא - מומלץ |
| min_ad_duration | לא - מומלץ |
| sdmax | לא - מומלץ |
| adtest | לא |
| cust_age | לא |
| cust_gender | לא |
| host | לא |
| h_ch | לא |
| overlay | לא |
כתובת אתר הבסיס
כתובת האתר הבאה מהווה את הבסיס לכל פרמטרי השאילתות המתוארים בהמשך:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(מחרוזת) מציין את סוג המודעה הרצויה. יש לחבר בין כל מרכיבי הפרמטר באמצעות קו תחתון (‘_’).
ערכים
- video: כל מודעות הווידאו: מקביל ל-standardvideo_skippablevideo_bumpervideo.
- skippablevideo: רק מודעות וידאו שניתן לדלג עליהן. ייתכן שנדרשות הרשאות נוספות של יצרן תוכן כדי לקבל מודעות שניתן לדלג עליהן.
- bumpervideo: מאפשר להציג מודעות וידאו באורך שש שניות שלא ניתן לדלג עליהן.
- standardvideo: רק מודעות וידאו שלא ניתן לדלג עליהן.
- image: מאפשר הצגה של מודעות תמונה שמתאימות לגודל הלא-לינארי של המיקום.
- text: מאפשר הצגה של מודעות טקסט.
דוגמאות
- &ad_type=video_text_image
- מאפשר הצגת כל הפורמטים.
- &ad_type=video_text
- מאפשר הצגת מודעות טקסט ומודעות בפורמט וידאו.
- &ad_type=standardvideo_image
- מאפשר הצגת מודעות וידאו ומודעות תמונה רגילות בלבד, שלא ניתן לדלג עליהן.
client
(מחרוזת) מזהה נכס האינטרנט של בעל האתר.
דוגמה: &client=ca-video-afvtest
description_url
(מחרוזת) כתובת אתר מקודדת מלאה של דף HTML שמתאר את הסרטון. ניתן ליצור את הערך description_url באופן דינמי באמצעות שפת התכנות שבצד השרת שלך, או באופן ידני באמצעות כלי מקוון לקידוד כתובות אתרים.
דוגמה: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
דוגמה לכתובת אתר
כתובת האתר בדוגמה הבאה מכילה את הפרמטרים המינימליים הנדרשים. https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2
היא מבקשת מודעות וידאו בשביל יצרן התוכן, ca-video-afvtest, עם כתובת אתר לתיאור: http:// myurl.com/page?key=value&key2=value2
channel
(מחרוזת) רשימת ערוצים (המופרדים באמצעות סימן החיבור) המשמשים למיקוד ולדיווח ב-AdSense. בכל בקשת מודעה ניתן להעביר עד חמישה ערוצים.
דוגמה: &channel=mychannel+otherchannel+targetingchannel
adsafe
(מחרוזת) קובע את ההגדרה המשמשת לסינון המודעות המוצגות. ברירת המחדל היא "high".
ערכים:
- high --(ברירת מחדל) מחזיר מודעות המתאימות לכל המשפחה. אי הצגת תוכן שאינו לכל המשפחה או תוכן מיני למבוגרים.
- medium --מחזיר מודעות המתאימות לכל המשפחה ומודעות שאינן מתאימות לכל המשפחה (כגון מודעות של הימורים או תרופות מרשם). אינו מחזיר מודעות בעלות תוכן מיני.
דוגמה: &adsafe=high
adtest
(מחרוזת) מציין האם מדובר ביישום למטרות בדיקה. ערכים אפשריים הם "on" (מופעל) או "off" (מושבת). אם מוגדר ל-"on", הופעות וקליקים לא יתועדו בחשבון AdSense לווידאו. חובה להשתמש בפרמטר הזה במהלך בדיקה. אם הפרמטר לא הוגדר, ברירת המחדל היא "off".
ערכים:
- off --(ברירת מחדל) חיוב רגיל לכל המודעות. יש להשתמש בהגדרה זו בגרסת הייצור.
- on --הגדרה זו מבטיחה שלא יתועדו הופעות או קליקים של מודעות במהלך בדיקה.
דוגמה: &adtest=on
videoad_start_delay
(מספר שלם) מספר אלפיות השנייה שאחריהן הסרטון יופעל במודעה. ברירת המחדל היא ערך של מודעה באמצע סרטון, או ספציפית, "1".
ערכים:
- 1- --מציין מודעה בסוף סרטון שתוצג בסוף התוכן
- 0 --מציין מודעה לפני סרטון שתוצג לפני הפעלת התוכן
- כל מספר שלם חיובי --מציין מודעה באמצע סרטון שתוצג לאחר הפעלת התוכן במשך מספר אלפיות השנייה שצוין.
דוגמה:
- &videoad_start_delay=-1 --מודעה בסוף סרטון.
- &videoad_start_delay=15000 --המודעה תתחיל לפעול 15 שניות אחרי הפעלת התוכן.
cust_age
(מספר שלם) מציין את גיל המשתמש. ניתן לציין גיל מדויק וכן קבוצת גילאים המוגדרת ב-com.google.ads.ima.api.Demographics.
דוגמה:
- &cust_age=1001 --גילאים 18 עד 24
- &cust_age=38 --גיל 38 בדיוק
cust_gender
(מספר שלם) מציין את מגדר המשתמש כפי שמוגדר ב-com.google.ads.ima.api.Demographics.
ערכים:
- 1 --גבר
- 2 -- אישה
דוגמה:
- &cust_gender=1 --גבר
- &cust_gender=2 --אישה
host
(מחרוזת) מזהה המארח שישמש לחלוקת הכנסות בין שלושה גורמים.
דוגמה: &host=ca-host-test --ההכנסות מתחלקות עם מארח זה.
h_ch
(מחרוזת) רשימת מחרוזות (המופרדות באמצעות סימן החיבור) המייצגות את מזהי ערוץ הדיווח/המיקוד של AdSense עבור המארח.
דוגמה: &h_ch=channel1+channel2+channel3 --מדווח על הערוצים הנוספים האלו וממקד אליהם בשביל המארח.
ht_id
(מספר) מזהה שכבה המשמש לציון רמת חלוקת ההכנסות בין יצרן התוכן למארח.
דוגמה: &ht_id=2 --מארח בשכבה 2.
hl
(מחרוזת) קוד שפה המשמש לבקשת מודעות בשפה שצוינה. הקוד יכול להיות בפורמט ISO 639-1 (שתי אותיות) או בפורמט ISO 639-2 (שלוש אותיות). רשימת קודים חוקיים.
דוגמה:
- &hl=en --אנגלית.
- &hl=es --ספרדית
max_ad_duration
(מספר שלם) מציין את משך הסרטון המקסימלי שיש להחזיר, באלפיות שנייה. אם ערך זה לא הוגדר, ברירת המחדל היא 100 שניות.
דוגמה: &max_ad_duration=30000 --משך הזמן המקסימלי של מודעה שלא ניתן לדלג עליה יהיה 30 שניות.
min_ad_duration
(מספר שלם) מציין את המשך המינימלי של סרטון, באלפיות שנייה. אם ערך זה לא הוגדר, ברירת המחדל היא 0 שניות.
דוגמה:
- &min_ad_duration=15000 --משך המודעה שהוחזרה שלא ניתן לדלג עליה חייב להיות 15 שניות או יותר.
- &min_ad_duration=0 --משך המודעה יוגבל רק על ידי הערך max_ad_duration.
sdmax
(מספר שלם) מציין את משך הזמן המקסימלי של סרטון למודעות שניתן לדלג עליהן, באלפיות שנייה. אם הערך לא הוגדר, ברירת המחדל היא ללא הגבלה.
דוגמה: &sdmax=120000 --משך המודעה שהוחזרה ושניתן לדלג עליה לא יחרוג משתי דקות.
overlay
(מספר שלם) משמש להגבלת הגודל של שכבת-העל המבוקשת, לשכבות-על לא-לינאריות בשליש התחתון בלבד. כברירת מחדל, לא מוגדרת הגבלה.
דוגמה:
- &overlay=1 --רק גדלים של שכבות-על בשליש התחתון יהיו כשירים בבקשת המודעה. לא יישלחו בקשות לשכבות-על במיקום מודעה מלא.
- &overlay=0 --ערך ברירת המחדל, שאינו מגדיר הגבלה כלשהי על הגדלים של שכבות-על. הגדלים של שכבות-העל יוצגו על סמך AdsRequest.nonLinearAdSlotWidth ועל סמך adsRequest.nonLinearAdSlotHeight.