عرض إعلان بيني للعبة H5
يعرض هذا المثال إعلانًا بينيًا للعبة باستخدام مكتبة "علامة الناشر من Google". (GPT) الإعلانات البينية للألعاب هي إعلانات بملء الصفحة تديرها "شبكة Google الإعلانية"، وتعرضها للمستخدمين الذين يلعبون ألعابًا على الويب استنادًا إلى عامل تشغيل يدوي. لمزيد من المعلومات عن الإعلانات البينية لألعاب الفيديو، يُرجى الاطّلاع على مقالة عرض إعلان بيني لألعاب H5.
لعرض الإعلانات البينية في الألعاب والتفاعل معها، استخدِم أحداث GPT التالية:
| الحدث | يتم تشغيله عند... |
|---|---|
GamingInterstitialSlotReady |
إعلان بيني للعبة جاهز للعرض على المستخدم. لعرض الإعلان البيني، استخدِم makeGameManualInterstitialVisible() في عنصر الحدث المقدَّم. |
GamingInterstitialSlotClosed |
أغلق المستخدم إعلانًا بينيًا معروضًا سابقًا للعبة. استخدِم هذا الحدث لتشغيل منطق مخصّص عند إغلاق إعلان بيني للعبة. |
بنية اللعبة
يمكن عرض الإعلانات البينية في الألعاب إما بملء الشاشة أو داخل إطار لعبتك، وذلك حسب بنية لعبتك. لمزيد من التفاصيل، يُرجى الاطّلاع على هياكل ألعاب HTML5.
يفترض نموذج التنفيذ أنّ لعبة H5 يتم عرضها مباشرةً في النافذة العلوية باستخدام بنية ملء الشاشة. في هذا السيناريو، يتم أيضًا عرض الإعلان البيني للألعاب بملء الشاشة.
ومع ذلك، يعمل هذا الرمز البرمجي نفسه أيضًا عند وضعه داخل إطار فرعي باستخدام بنية 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()قيمة فارغة. يجب التحقّق من هذه الحالة للتأكّد من عدم تنفيذ أي عمل غير ضروري.لا تطلب الإعلانات البينية للألعاب إلا على الصفحات أو البيئات التي تريد أن يظهر فيها إعلان بيني. تكون الإعلانات البينية للألعاب مؤهَّلة لعرضها على أجهزة الكمبيوتر المكتبي والأجهزة اللوحية والأجهزة الجوّالة.
تُنشئ الإعلانات البينية في الألعاب خانة إعلان خاصة بها. على عكس الأنواع الأخرى من الإعلانات، ليس من الضروري تحديد
<div>للإعلانات البينية في الألعاب. تنشئ هذه الإعلانات حاويتها الخاصة وتُدرجها تلقائيًا في الصفحة عند ملء إعلان.يمكن استخدام الإعلانات البينية في الألعاب لمرة واحدة فقط. لا يمكنك إعادة تحميل خانة إعلان متداخل في ألعاب الفيديو. بدلاً من ذلك، عليك إلغاء حجز الفتحة وإعادة إنشائها، كما هو موضّح في نموذج التنفيذ.
تفرض الإعلانات البينية في الألعاب حدًا أقصى ثابتًا لعدد مرّات الظهور. ويمنع هذا الحدّ الأقصى حدث
gamingInterstitialSlotReadyمن الظهور أكثر من مرّة كل 120 ثانية.في حال استخدام بنية الإعلان الأحادي الطلب (SRA) على صفحة تتضمّن عدة مساحات إعلانية، لا تستخدِم
display()إلى أن يتم إنشاء divs للشرائح الإعلانية الثابتة. كما هو موضح في أفضل الممارسات المتعلّقة بالإعلانات، يطلب أول طلب إلىdisplay()كل خانة إعلان تم تحديدها قبل هذه النقطة. على الرغم من أنّ أماكن الإعلانات البينية في الألعاب لا تتطلّب<div>محدّدًا مسبقًا، فإنّ أماكن الإعلانات الثابتة تتطلّب ذلك. يمكن أن يؤدي استدعاءdisplay()قبل ظهور هذه العناصر على الصفحة إلى إرسال إشارات ذات جودة أقل. ننصحك بتأخير المكالمة الأولية إلى ما بعد تحديد المقاعد الثابتة.