تستخدِم إعلانات ألعاب H5 (إصدار تجريبي) رمز AdSense إلى جانب رمز إضافي مطلوب لإعداد وظائف H5 Ad Placement API. وتتوفر لك أيضًا بعض معلّمات رمز AdSense الاختيارية لضبط الإعدادات الإضافية.
كيفية وضع الرمز
- انسخ الرمز الموضح أدناه:
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"></script>
<script>window.adsbygoogle = window.adsbygoogle || []; var adBreak = adConfig = function(o) {adsbygoogle.push(o);} </script>ملاحظة: تأكد من نسخ جميع الرموز بما في ذلك الرمز الإضافي الذي يعد الدالتينadBrack()وadConfig()وإلا لن تعمل إعلاناتك. - في الرمز، استبدل
"ca-pub-1234567890123456"بالرقم التعريفي للناشر. تعرّف على كيفية العثور على الرقم التعريفي للناشر. - إذا تم تشغيل لعبتك في تطبيق للأجهزة الجوّالة، ستحتاج إلى تحديد معلَمتين إضافيتين على النحو التالي:
بعد
data-ad-client="ca-pub-1234567890123456"، أضِف:data-admob-interstitial-slot="ca-app-pub-1234567890123456/11111111"data-admob-rewarded-slot="ca-app-pub-1234567890123456/22222222"
تُستخدم المعلمة
data-admob-Interstitial-slotلطلب الإعلانات البينية، بينما يتم استخدامdata-admob-sponsored-slotلطلب الإعلانات بمكافأة. يجب تحديد لعبة واحدة على الأقل إذا كانت لعبتك تعرض إعلانات في تطبيق للأجهزة الجوّالة. تعرَّف على مزيد من المعلومات عن إنشاء الوحدات الإعلانية البينية والوحدات الإعلانية بمكافأة في AdMob.إذا لم يكن لديك حساب في AdMob حتى الآن، انتقل إلى Google AdMob لإنشاء حساب.
- ضع الرمز بين العلامتين
<head>و</head>للصفحة التي تتم استضافة لعبتك بها.ملاحظة: بغض النظر عن كيفية توزيع لعبتك (على سبيل المثال، في حالة تضمينها مباشرةً في صفحة أو إطار iframe في موقع آخر أو جزء من موقعك) يجب وضع الرمز دائمًا في الصفحة التي تحتوي على لعبتك.
مثال لصفحة لعبة مع رمز AdSense وإضافة رمز إضافي
| مثال على الرمز | الوصف |
|---|---|
| yourdomain.com/games/mygame | الصفحة التي تتم استضافة لعبتك بها |
<head> |
|
<script async |
هذا القسم هو رمز AdSense. |
<script>window.adsbygoogle = |
يبدأ هذا القسم بإعداد H5 Ad Placement API. |
</head>
<body> |
|
<canvas id="game_canvas" |
هذا القسم هو منطق ألعابك. |
</body> |
أوصاف معلمات رمز AdSense
يمكنك استخدام معلمات رمز AdSense هذه لضبط إعدادات مختلفة لإعلانات الألعاب. المعلمة data-ad-client مطلوبة ولكن جميع المعلمات الأخرى اختيارية.
| المعلمة | الوصف والأمثلة |
|---|---|
data-ad-client |
مطلوب
الرقم التعريفي للناشر ورمز الناشر. مثال:
|
data-ad-host |
اختياري
إذا كنت تشارك أرباحك مع نظام أساسي مضيف، استخدم هذه المعلمة لتحديد النظام الأساسي المضيف. مثال:
|
data-admob-interstitial-slot |
اختياري
إذا كانت لعبتك تعمل في تطبيق للأجهزة الجوّالة، استخدِم هذه المعلمة لطلب إعلانات بينية. مثال:
|
data-admob-rewarded-slot |
اختياري
إذا كانت لعبتك تعمل في تطبيق للأجهزة الجوّالة، استخدِم هذه المعلمة لطلب إعلانات بمكافأة. مثال:
|
data-ad-channel |
اختياري
يمكنك تضمين معرّف قناة مخصصة لتتبع أداء إعلاناتك. مثال:
|
data-adbreak-test |
اختياري
استخدم هذه المعلمة لتفعيل وضع الاختبار. وهذا يتيح لك اختبار المواضع باستخدام الإعلانات المزيفة. مثال:
|
data-tag-for-child-directed-treatment |
اختياري
استخدم هذه المعلمة إذا كنت تريد وضع علامة على طلبات الإعلان للتعامل معها باعتبارها موجّهة إلى الأطفال. لمزيد من المعلومات، راجع: وضع علامة على موقع أو طلب إعلان للتعامل مع الموقع باعتباره موجّهًا للأطفال. مثال:
|
data-tag-for-under-age-of-consent |
اختياري
استخدِم هذه المعلّمة إذا كنت تريد وضع علامات على طلبات إعلانك في المنطقة الاقتصادية الأوروبية وسويسرا والمملكة المتحدة للتعامل مع المعالجة المحدودة للبيانات. ولمزيد من المعلومات، اطّلِع على: وضع علامة على طلب الإعلان للمستخدمين الذين تقل أعمارهم عن سن الرشد (TFUA) في المنطقة الاقتصادية الأوروبية والمملكة المتحدة. مثال:
|
data-ad-frequency-hint |
اختياري
الحد الأدنى لمتوسط الفترة الزمنية بين الإعلانات بالثواني. إذا كانت هذه القيمة هي "120 ثانية"، لن يتم عرض الإعلانات أكثر من مرة كل دقيقتين في المتوسط. لاحظ أن هذا تلميح يمكن تجاهله أو إلغائه بواسطة عنصر تحكم الخادم في المستقبل. مثال:
|