הצגת מודעת מעברון במשחק 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יותר מפעם אחת בכל 30 שניות.אם משתמשים בארכיטקטורה של בקשה יחידה (SRA) בדף עם כמה משבצות, לא צריך לבצע קריאה ל-
display()עד שייווצרו divs של מיקומי מודעות סטטיים. כפי שמוסבר במאמר שיטות מומלצות ל-Google Ads, הקריאה הראשונה ל-display()מבקשת את כל מיקומי המודעות שהוגדרו לפני הנקודה הזו. למרות שלא צריך להגדיר<div>מראש כדי להציג מודעות מעברון במשחקים, צריך להגדיר<div>כדי להציג מודעות סטטיות. קריאה ל-display()לפני שהרכיבים האלה מופיעים בדף עלולה לגרום לקבלת אותות באיכות נמוכה יותר. מומלץ לדחות את הקריאה הראשונית עד אחרי הגדרת משבצות סטטיות.