מודעות למשחקי H5 (בטא)

הוספה של קוד AdSense לדף המשחק

מודעות במשחקי H5 (בטא) משתמשות בקוד AdSense ובקוד נוסף הדרוש כדי להפעיל את הפונקציות של ה-H5 Ad Placement API. קיימים גם כמה פרמטרים אופציונליים של קוד AdSense הזמינים לקביעת הגדרות נוספות.

איך מציבים את הקוד

מעתיקים את הקוד הבא:
‎<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"></script>
‎ ‎<script>window.adsbygoogle = window.adsbygoogle || []; var adBreak = adConfig = function(o) {adsbygoogle.push(o);} </script>‎

הערה: כדי שהמודעות יפעלו, חיוני להעתיק את הקוד המלא, כולל הקוד הנוסף שמפעיל את הפונקציות dBreak()‎ ו-adConfig()‎.
בקוד שבאתר, מחליפים את "ca-pub-1234567890123456" במזהה בעל האתר. בקישור הבא מוסבר איך למצוא את מזהה בעל האתר.
אם המשחק שלכם פועל באפליקציה לנייד, אתם צריכים לציין שני פרמטרים נוספים כך:
אחרי הפרמטר data-ad-client="ca-pub-1234567890123456"‎ מוסיפים:
- ‎data-admob-Interstitial-slot="ca-app-pub-1234567890123456/11111111"‎‎
- ‎data-admob-rewarded-slot="ca-app-pub-1234567890123456/22222222"‎
הפרמטר data-admob-interstitial-slot משמש לשליחת בקשות למודעות מעברון, והפרמטר data-admob-rewarded-slot משמש לשליחת בקשות למודעות מתגמלות. צריך לציין לפחות אחד מהפרמטרים האלה אם רוצים שיוצגו מודעות במשחק באפליקציה לנייד. מידע נוסף על יצירת יחידות של מודעות מעברון ויחידות מודעות מתגמלות ב-AdMob.

אם עדיין אין לכם חשבון AdMob, תוכלו ליצור חשבון ב-Google AdMob.
מוסיפים את הקוד בין התג <head> לתג ‎</head>‎ בדף שבו מתארח המשחק.
הערה: ללא קשר לאופן ההפצה של המשחק (למשל, אם אתם מטמיעים אותו ישירות בדף או יוצרים iframe שלו באתר אחר או בחלק כלשהו באתר שלכם), עליכם תמיד למקם את הקוד בדף שמכיל את המשחק.

דף משחק לדוגמה עם קוד AdSense והקוד הנוסף

קוד לדוגמה	תיאור
yourdomain.com/games/mygame	הדף שבו מתארח המשחק
`<head>`
`‎<script async ‎ src="https://pagead2.googlesyndication.com ‎ ‎/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"> ‎ ‎</script>‎`	קטע זה הוא קוד AdSense.
`‎<script>window.adsbygoogle =‎ ‎window.adsbygoogle \|\| [];‎ ‎var adBreak = adConfig = function(o) {adsbygoogle.push(o);}‎ ‎</script>‎`	קטע זה מפעיל את ה-H5 Ad Placement API.
`‎</head>‎` `<body>`
`‎<canvas id="game_canvas"‎ ‎width="100%" height="100%">‎ ‎<script src="game.js"><script>‎`	הקטע הזה הוא לוגיקת המשחק.
`‎</body>‎`

תיאורים של פרמטרי AdSense

ניתן להשתמש בפרמטרים האלה של AdSense לקביעת הגדרות שונות עבור מודעות המשחק. הפרמטר data-ad-client נדרש, אבל כל הפרמטרים האחרים הם אופציונליים.

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

פרמטר	תיאור ודוגמאות
`data-ad-client`	חובה מזהה בעל האתר וקוד בעל האתר. דוגמה: `data-ad-client="ca-pub-1234567890123456"‎`
`data-ad-host`	אופציונלי אם אתם חולקים את ההכנסות עם פלטפורמת מארח, תוכלו להשתמש בפרמטר הזה כדי לציין את פלטפורמת המארח. דוגמה: `‎data-ad-host="ca-host-pub-123"‎`
`data-admob-interstitial-slot`	אופציונלי אם המשחק פועל באפליקציה לנייד, תוכלו להשתמש בפרמטר הזה כדי לשלוח בקשה למודעות מעברון. דוגמה: `data-ad-host="ca-app-pub-1234567890123456/456"‎`
`data-admob-rewarded-slot`	אופציונלי אם המשחק שלכם פועל באפליקציה לנייד, תוכלו להשתמש בפרמטר הזה כדי לשלוח בקשה למודעות מתגמלות. דוגמה: `data-ad-host="ca-app-pub-1234567890123456/789"‎`
`data-ad-channel`	אופציונלי כדי לעקוב אחרי הביצועים של המודעות, תוכלו לכלול מזהה ערוץ מותאם אישית. דוגמה: `‎data-ad-channel="1234"‎`
`data-adbreak-test`	אופציונלי השתמשו בפרמטר הזה כדי להפעיל את מצב הבדיקה. בעזרת הפרמטר הזה תוכלו לבדוק את המיקומים באמצעות מודעות מזויפות. דוגמה: `data-adbreak-test="on"‎`
`data-tag-for-child-directed-treatment`	אופציונלי השתמשו בפרמטר הזה אם רוצים לתייג בקשות למודעות בתג תוכן לילדים. למידע נוסף, עיינו במאמר תיוג של אתר או בקשה למודעה בתג התאמה לילדים. דוגמה: `data-tag-for-child-directed-treatment="1"‎`
`data-tag-for-under-age-of-consent`	אופציונלי השתמשו בפרמטר הזה כדי לתייג בקשות להצגת מודעות למשתמשים באזור הכלכלי האירופי (EEA), בשווייץ ובבריטניה כך שהן יטופלו במצב עיבוד נתונים מוגבל (RDP). מידע נוסף מפורט במאמר תיוג בקשה להצגת מודעה למשתמשים ב-EEA ובבריטניה שעוד לא הגיעו לגיל ההסכמה (TFUA). דוגמה: `data-tag-for-under-age-of-consent="1"‎`
`data-ad-fre-uency-hint`	אופציונלי מרווח הזמן הממוצע המינימלי בין מודעות, כשהוא מצוין בשניות. אם הערך הוא "120s", המודעות יוצגו בתדירות של עד פעם אחת בכל שתי דקות בממוצע. הערה: ייתכן שבעתיד בקרת שרת תתעלם מהרמז הזה או תעקוף אותו. דוגמה: `data-ad-fre-uency-hint="120s"‎`

האם המידע הועיל?

איך נוכל לשפר את המאמר?