Показ межстраничной игровой рекламы H5

В этом примере показано игровое межстраничное объявление с использованием библиотеки тегов издателя Google (GPT). Межстраничные игровые объявления – это полностраничные объявления, управляемые GPT, которые вы показываете пользователям, играющим в веб-игры, с помощью триггера вручную. Дополнительную информацию об игровых межстраничных объявлениях см. в разделе «Показ межстраничных игровых объявлений H5» .

Для отображения межстраничной игровой рекламы и взаимодействия с ней используйте следующие события GPT:

Событие Уволен, когда...
GamingInterstitialSlotReady Игровая межстраничная реклама готова к показу пользователю.

Чтобы отобразить вставку, вызовите makeGameManualInterstitialVisible() для предоставленного объекта события.
GamingInterstitialSlotClosed Пользователь закрыл ранее показанное игровое межстраничное объявление.

Используйте это событие для запуска пользовательской логики при закрытии игрового межстраничного объявления.

Игровые структуры

Межстраничные игровые объявления могут отображаться либо в полноэкранном режиме, либо внутри рамки игры, в зависимости от структуры вашей игры. Подробнее см. в разделе «Игровые структуры H5» .

В примере реализации предполагается, что игра H5 отображается непосредственно в самом верхнем окне, используя структуру Fullscreen . В этом сценарии игровая межстраничная реклама также отображается в полноэкранном режиме.

Однако этот же код работает и при размещении внутри дочернего фрейма с использованием структуры 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) на странице с несколькими рекламными местами, не вызывайте display() до тех пор, пока не будут созданы статические разделы рекламных мест. Как поясняется в разделе «Рекомендации по рекламе» , первый вызов display() запрашивает каждое рекламное место, определенное до этого момента. Хотя игровые межстраничные рекламные места не требуют предопределенного <div> , статические рекламные места требуют этого. Вызов display() до того, как эти элементы появятся на странице, может привести к снижению качества сигналов. Мы рекомендуем отложить первоначальный вызов до тех пор, пока не будут определены статические слоты.

Пример реализации

Посмотреть демо