מודעות במשחקי 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 |
הקטע הזה הוא קוד AdSense. |
<script>window.adsbygoogle = |
הקטע הזה מפעיל את ה-H5 Ad Placement API. |
</head>
<body> |
|
<canvas id="game_canvas" |
הקטע הזה הוא לוגיקת המשחק. |
</body> |
תיאורי פרמטרים של קוד AdSense
אפשר להשתמש בפרמטרים של קוד AdSense כדי לקבוע הגדרות שונות למודעות משחקים. הפרמטר data-ad-client נדרש, אבל כל הפרמטרים האחרים הם אופציונליים.
| פרמטר | תיאור ודוגמאות |
|---|---|
data-ad-client |
חובה
מזהה בעל האתר וקוד בעל האתר. דוגמה:
|
data-ad-host |
אופציונלי
אם אתם חולקים את ההכנסות עם פלטפורמת מארח, תוכלו להשתמש בפרמטר הזה כדי לציין את פלטפורמת המארח. דוגמה:
|
data-admob-interstitial-slot |
אופציונלי
אם המשחק פועל באפליקציה לנייד, תוכלו להשתמש בפרמטר הזה כדי לשלוח בקשה למודעות מעברון. דוגמה:
|
data-admob-rewarded-slot |
אופציונלי
אם המשחק שלכם פועל באפליקציה לנייד, תוכלו להשתמש בפרמטר הזה כדי לשלוח בקשה למודעות מתגמלות. דוגמה:
|
data-ad-channel |
אופציונלי
כדי לעקוב אחרי הביצועים של המודעות, תוכלו לכלול מזהה ערוץ מותאם אישית. דוגמה:
|
data-adbreak-test |
אופציונלי
השתמשו בפרמטר הזה כדי להפעיל את מצב הבדיקה. בעזרת הפרמטר הזה תוכלו לבדוק את המיקומים באמצעות מודעות-דמה. דוגמה:
|
data-tag-for-child-directed-treatment |
אופציונלי
צריך להשתמש בפרמטר הזה אם רוצים לתייג בקשות להצגת מודעות בתג התאמה לילדים (TFCD). מידע נוסף זמין במאמר תיוג אתר או בקשה להצגת מודעה בתג התאמה לילדים. דוגמה:
|
data-tag-for-under-age-of-consent |
אופציונלי
צריך להשתמש בפרמטר הזה כדי לתייג בקשות להצגת מודעות למשתמשים באזור הכלכלי האירופי (EEA), בשווייץ ובבריטניה כך שיופעל בהן עיבוד נתונים מוגבל (RDP). מידע נוסף מפורט במאמר תיוג בקשה להצגת מודעה למשתמשים ב-EEA ובבריטניה בתג 'מתחת לגיל ההסכמה' (TFUA). דוגמה:
|
data-ad-fre-uency-hint |
אופציונלי
מרווח הזמן הממוצע המינימלי בין מודעות, כשהוא מצוין בשניות. אם הערך הוא "120s", המודעות יוצגו בתדירות של עד פעם אחת בכל שתי דקות בממוצע. הערה: ייתכן שבעתיד אמצעי הבקרה בשרת יתעלמו מההנחיה הזו או יעקפו אותה. דוגמה:
|