הצגת מודעת מעברון במשחק H5
בדוגמה הזו מוצגת מודעת מעברון בנושא משחקים באמצעות הספרייה של Google Publisher Tag (GPT). מודעות מעברון למשחקים הן מודעות במסך מלא בניהול GPT שמוצגות למשתמשים שמשחקים במשחקים מבוססי-אינטרנט על סמך הפעלה ידנית. למידע נוסף על מודעות מעברון במשחקים, ראו הצגת מודעה מעברון במשחק H5.
כדי להציג מודעות מעברון בנושאי משחקים ולנהל איתן אינטראקציה, צריך להשתמש באירועי ה-GPT הבאים:
| אירוע | מופעל כאשר... |
|---|---|
GamingInterstitialSlotReady |
מודעת מעברון למשחקים מוכנה להצגה למשתמש. כדי להציג את מודעת המעברון, צריך להפעיל את makeGameManualInterstitialVisible() באובייקט האירוע שסופק. |
GamingInterstitialSlotClosed |
המשתמש סגר מודעת מעברון שפורסמה בעבר בנושא משחקים. אפשר להשתמש באירוע הזה כדי להריץ לוגיקה מותאמת אישית בכל פעם שמודעת מעברון בנושא משחקים נסגרת. |
מבנים במשחק
מודעות מעברון במשחקים יכולות להופיע במסך מלא או בתוך המסגרת של המשחק, בהתאם למבנה של המשחק. מידע נוסף זמין במאמר מבנים של משחקים ב-H5.
בהטמעה לדוגמה, ההנחה היא שמשחק ה-H5 ייגרם ישירות בחלון העליון, באמצעות המבנה Fullscreen. בתרחיש הזה, גם המעברון של המשחק מוצג במסך מלא.
עם זאת, אותו קוד פועל גם כשהוא ממוקם בתוך מסגרת צאצא, באמצעות המבנה iFrame/WebView. כדי להגביל את המודעה המעברון במשחק לבד הציור של המשחק ב-H5, צריך להציב את המשחק ב-iFrame, כמו בדוגמה הבאה:
<!doctype html>
<html>
<head>
<!-- The Google Publisher Tag here, if any, will only be responsible for serving ads outside of the H5 game. -->
<title>Page for this example H5 game</title>
<!-- Your <head> content here. -->
</head>
<body>
<span id="example-text">Example H5 game</span>
<!-- Sample code is served here. The Google Publisher Tag loaded in this frame will only be used within the H5 game. -->
<iframe src="https://www.example.com" title="Example game" allow="autoplay"></iframe>
</body>
</html>
הערות לגבי שימוש
כדי להבטיח חוויית משתמש אופטימלית, מערכת GPT מבקשת להציג מודעות מעברון בנושאי משחקים רק בדפים שתומכים בפורמט בצורה תקינה. עקב ההגבלה הזו,
defineOutOfPageSlot()עשוי להחזיר null. חשוב לבדוק את האפשרות הזו כדי לוודא שאתם לא מבצעים עבודה מיותרת.צריך לבקש מודעות מעברון במשחקים רק בדפים או בסביבות שבהם רוצים שהמודעה תופיע. מודעות מעברון למשחקים עומדות בדרישות להצגה במחשבים, בטאבלטים ובניידים.
מודעות מעברון במשחקים יוצרות מיקום מודעה משלהם. בניגוד לסוגים אחרים של מודעות, אין צורך להגדיר
<div>למודעות מעברון במשחקים. המודעות האלה יוצרות ומוסיפות באופן אוטומטי מאגר משלהם לדף כשמודעה מתמלאת.מודעות מעברון במשחקים הן לשימוש חד-פעמי. לא ניתן לרענן מיקום של מודעה מעברון בגיימינג. במקום זאת, צריך למחוק את ה-slot וליצור אותו מחדש, כפי שמתואר בהטמעה לדוגמה.
למודעות מעברון במשחקים יש מכסת תדירות קבועה. מכסת התדירות מונעת הפעלה של האירוע
gamingInterstitialSlotReadyיותר מפעם אחת בכל 120 שניות.אם משתמשים בארכיטקטורה של בקשה יחידה (SRA) בדף עם כמה משבצות, לא צריך לבצע קריאה ל-
display()עד שייווצרו divs של מיקומי מודעות סטטיים. כפי שמוסבר במאמר שיטות מומלצות ל-Google Ads, הקריאה הראשונה ל-display()מבקשת את כל משבצות המודעות שהוגדרו לפני הנקודה הזו. למרות שלא צריך להגדיר<div>מראש כדי להציג מודעות מעברון במשחקים, צריך להגדיר<div>כדי להציג מודעות סטטיות. קריאה ל-display()לפני שהרכיבים האלה מופיעים בדף עלולה לגרום לקבלת אותות באיכות נמוכה יותר. מומלץ לדחות את הקריאה הראשונית עד אחרי הגדרת משבצות סטטיות.