מבנה התיוג במוצרי 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 | לא |
כתובת אתר הבסיס
כתובת האתר הבאה היא הבסיס לכל הפרמטרים של שאילתות המתוארים בהמשך:
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-games-pub-4968145218643279
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 --אורך המודעה שניתן לדלג עליה אשר הוחזרה לא יחרוג משתי דקות.
