تبلیغ بین‌المللی بازی H5 را نمایش دهید

این مثال با استفاده از کتابخانه Google Publisher Tag (GPT) یک تبلیغ بین‌المللی بازی را نشان می‌دهد. بینابینی‌های بازی، تبلیغات تمام‌صفحه‌ای با مدیریت GPT هستند که به کاربرانی که بازی‌های مبتنی بر وب را بر اساس یک راه‌انداز دستی بازی می‌کنند، نمایش می‌دهید. برای کسب اطلاعات بیشتر در مورد فایل‌های بین‌افزاری بازی، به نمایش یک تبلیغ بین‌اولی بازی H5 مراجعه کنید.

برای نمایش و تعامل با تبلیغات بینابینی بازی، از رویدادهای GPT زیر استفاده کنید:

رویداد اخراج زمانی که ...
GamingInterstitialSlotReady یک تبلیغ بینابینی بازی آماده نمایش به کاربر است.

برای نمایش interstitial، 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() ممکن است null برگرداند. شما باید این مورد را بررسی کنید تا مطمئن شوید که هیچ کار غیر ضروری انجام نمی دهید.

  • فقط در صفحه‌ها یا محیط‌هایی که می‌خواهید یک محتوای بینابینی نمایش داده شود، آگهی‌های بینابینی بازی را درخواست کنید. تبلیغات بین‌المللی بازی واجد شرایط ارائه به دسک‌تاپ، رایانه لوحی و دستگاه‌های تلفن همراه است.

  • تبلیغات بینابینی بازی جایگاه تبلیغاتی خود را ایجاد می کند. بر خلاف سایر انواع تبلیغات، نیازی به تعریف <div> برای تبلیغات بینابینی بازی نیست. این تبلیغات به طور خودکار ظرف خود را در هنگام پر شدن یک آگهی ایجاد و در صفحه قرار می دهند.

  • تبلیغات بینابینی بازی یکبار مصرف هستند. نمی‌توانید جایگاه آگهی بین‌المللی بازی را بازخوانی کنید. در عوض، همانطور که در اجرای نمونه نشان داده شده است، باید اسلات را از بین ببرید و دوباره آن را ایجاد کنید.

  • تبلیغات بینابینی بازی محدودیت فرکانس ثابتی دارند. درپوش فرکانس از پخش بیش از یک بار رویداد gamingInterstitialSlotReady در هر 120 ثانیه جلوگیری می کند.

  • اگر از معماری تک درخواستی (SRA) در صفحه‌ای با اسلات‌های متعدد استفاده می‌کنید، تا زمانی که div‌های اسلات تبلیغاتی ایستا ایجاد نشده‌اند، display() را فراخوانی نکنید. همانطور که در Ads Best Practices توضیح داده شد، اولین فراخوانی برای display() هر جایگاه تبلیغاتی را که قبل از آن نقطه تعریف شده بود درخواست می کند. اگرچه اسلات های بینابینی بازی به یک <div> از پیش تعریف شده نیاز ندارد، اما اسلات های تبلیغاتی ایستا به آن نیاز دارند. فراخوانی display() قبل از حضور این عناصر در صفحه می تواند منجر به سیگنال های با کیفیت پایین تر شود. توصیه می‌کنیم تماس اولیه را تا زمانی که شکاف‌های ثابت تعریف شده‌اند به تأخیر بیندازید.

اجرای نمونه

نمایش نسخه ی نمایشی