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