يمكنك استخدام هذا الدليل لمعرفة كيفية الدمج مع حزمة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية من Google لعرض الإعلانات على ألعاب HTML 5 على الويب باستخدام AdSense.
نظرة عامة على الإعداد الفني
يتم تشغيل AdSense للألعاب باستخدام أداة تطوير البرامج لإعلانات الوسائط التفاعلية من Google (أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية). وتسمح لك أداة تطوير البرامج (SDK) بطلب إعلانات AdSense من خلال JavaScript حتى يتم دمج المحتوى والإعلانات بشكلٍ أوثق.
لطلب الإعلانات وعرضها من خلال حزمة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية، عليك إعداد طلب إعلان وتحميل الإعلان الناتج وتشغيله في الوقت المناسب. اختبِر عملية الدمج باستخدام الرقم التعريفي التلقائي للناشر ca-games-pub-4968145218643279.
تجدر الإشارة إلى أنه يجب تزويد مدير الحساب بمثال على عملية الدمج قبل أن يُسمح لك بنشر الإعلانات على مواقعك الإلكترونية.
هناك خياران لإجراء الدمج، وهما بسيط أو متقدم.
الدمج البسيط
يُعدّ خيار الدمج البسيط أسهل طريقة لدمج AdSense للألعاب مع ألعاب HTML5. ويوفر هذا الخيار حلاً سريع التنفيذ يوفر جميع الميزات وأشكال الإعلانات المتاحة من خلال AdSense للألعاب.
بالنسبة إلى الناشرين الذين يتطلعون إلى استخدام خيار الدمج البسيط هذا، يمكنك تسجيل اهتمامك.
الدمج المتقدِّم
بالنسبة إلى الناشرين الذين يبحثون عن دمج مخصّص أكثر تطورًا، يجب أن تُنفَّذ الأداة الكاملة لتطوير برامج HTML5 لإعلانات الوسائط التفاعلية مع ألعاب HTML5. يوفّر هذا الخيار مرونة إضافية مثل ميزات معينة متاحة من خلال "مدير إعلانات Google"، ولكن تجدر الإشارة أيضًا إلى أن هذا الخيار يجلب مزيدًا من التعقيد.
بدء استخدام الدمج المتقدّم
للبدء، يُرجى دمج حزمة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية مع لعبتك.
- إعداد دمج أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية
تابع الإرشادات الموضَّحة على موقع Google Developers لدمج أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية مع لعبتك. هناك خطوات للبدء، إلى جانب رمز نموذجي قابل للتنزيل ومرجع كامل لواجهة برمجة التطبيقات من أجل تقديم المساعدة.
- إعداد حاوية الإعلان (
AdDisplayContainer)نظرًا لأن أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية تقدم خدمات لكلٍ من ناشري الفيديو والألعاب، يمكن تهيئة العنصر
AdDisplayContainerبعدة طرق.عند تهيئة العنصر
AdDisplayContainerللاستخدام مع AdSense للألعاب، ما عليك سوى التمرير ببساطة في المرجع للوصول إلى العنصر div الذي سيتضمن الإعلان.مثال:
var adDisplayContainer = new google.ima.AdDisplayContainer(document.getElementById('adContainer')); - ضبط طلب الإعلان (
AdsRequest)أثناء إنشاء العنصر
AdsRequest، يجب التأكد من ضبط المعلَّمات والخصائص ذات الصلة بطريقة صحيحة بحيث يتم عرض الإعلانات بطريقة سليمة.مثال:
// طلب إعلانات AdSense للألعاب.
var adsRequest = new google.ima.AdsRequest();
// Setup AdSense for games ad tag
adsRequest.adTagUrl = 'https://googleads.g.doubleclick.net/pagead/ads?ad_type=video_image_text&client=ca-games-pub-4968145218643279&videoad_start_delay=0&description_url=http%3A%2F%2Fwww.google.com&max_ad_duration=20000&adtest=on';
// Force image/text ads to render with Full-Slot UI
adsRequest.forceNonLinearFullSlot = true;
// حدِّد أحجام الخانات الخطية وغير الخطية.
adsRequest.linearAdSlotWidth = {your_game_width};
adsRequest.linearAdSlotHeight = {your_game_height};
adsRequest.nonLinearAdSlotWidth = {your_game_width};
adsRequest.nonLinearAdSlotHeight = {your_game_height}; - الاطلاع على الأحداث ذات الصلة وإنشاء استدعاءات
من الضروري الاطلاع على الأحداث التي تُطلَق من خلال حزمة تطوير البرامج لإعلانات الوسائط التفاعلية بحيث يمكنك معرفة متى تُوقِف عرض الإعلان وتسمح لمستخدميك بالاستمرار في تشغيل لعبتك.
يمكنك الاطلاع أدناه على بعض أحداث الإعلانات التي يتم استخدامها بصورة شائعة لتحديد موضع الإعلانات في محتوى لعبتك. على سبيل المثال، يمكنك الاطلاع على حدث
COMPLETEلمعرفة موعد اكتمال تشغيل الإعلان، لتتمكن حينئذٍ من عرض محتوى لعبتك للمستخدمين. تتوفر قائمة كاملة من أحداث الإعلانات في مرجع واجهة برمجة التطبيقات.اسم الحدث الوصف AdEvent.Type.CLICKيتم الإطلاق عند النقر على الإعلان. AdEvent.Type.COMPLETEيتم الإطلاق عند اكتمال تشغيل الإعلان. AdEvent.Type.LOADEDيتم الإطلاق عند توفر بيانات الإعلان. AdEvent.Type.SKIPPEDيتم الإطلاق عندما يتخطى المستخدم الإعلان. AdEvent.Type.STARTيتم الإطلاق عند بدء تشغيل الإعلان. AdEvent.Type.USER_CLOSEيتم الإطلاق عندما يغلق المستخدم الإعلان. AdErrorEvent.Type.AD_ERRORيتم الإطلاق عند حدوث خطأ بالإعلان.
هناك العديد من أنواع أخطاء الإعلانات المختلفة التي يمكن أن تحدث. وتشمل الأمثلة تعذُّر تحميل مادة عرض الوسائط الإعلانية، أو الاستجابات الفارغة للإعلانات التي تُعرَض بناءً على طلبات الإعلانات؛ مع العلم بأنه تتوفر قائمة بالأخطاء المحتملة في مرجع واجهة برمجة التطبيقات.
