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

В этом примере отображается игровая межстраничная реклама с использованием библиотеки Google Publisher Tag (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 срабатывать чаще, чем раз в 30 секунд.

  • При использовании архитектуры с одним запросом (SRA) на странице с несколькими слотами не вызывайте display() , пока не будут созданы статические div-ы рекламных слотов. Как объясняется в Ads Best Practices , первый вызов display() запрашивает каждый рекламный слот, определенный до этого момента. Хотя игровые межстраничные слоты не требуют предопределенного <div> , статические рекламные слоты требуют. Вызов display() до того, как эти элементы появятся на странице, может привести к снижению качества сигналов. Мы рекомендуем отложить первоначальный вызов до тех пор, пока не будут определены статические слоты.

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

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

JavaScript

Загрузка...

Машинопись

Загрузка...