تستخدِم "إعلانات ألعاب 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 ثانية"، لن يتم عرض الإعلانات أكثر من مرة كل دقيقتين في المتوسط. لاحظ أن هذا تلميح يمكن تجاهله أو إلغائه بواسطة عنصر تحكم الخادم في المستقبل. مثال:
|