HTML5 oyun reklamı (ReklamUp)HTML5 game ad (ReklamUp)

Bu sayfa neyi test eder: reklam alanında oynanan HTML5 oyun. Üstteki alan reklam sunucusunun demo_h5 birimidir (ReklamUp satırı oyunu, Google ve Prebid satırları 300x250 banner verir); alttaki, reklam scriptinin “oyun” türündeki reklam alanıdır. Oyunun hiçbir parçası okuyucu “Oyna”ya dokunana kadar yüklenmez.

What this page tests: an HTML5 game played in an ad placement. The upper placement is the ad server's demo_h5 unit (the ReklamUp line item serves the game, the Google and Prebid line items a 300x250 banner); the lower one is the ad script's “game” type of ad placement. No part of the game loads until the reader taps “Play” (“Oyna” in the game).

HTML5 oyun bir banner alanında (300x250) oynanır ve kendisi de reklam ister: seviyeler arasında bir geçiş reklamı (interstitial), kaçırılan seviyede ek hak için bir ödüllü reklam. Oyun bunları adBreak köprüsüyle (reklamup/ras-game-bridge.js, Google'ın H5 oyun API'si biçiminde) sayfadaki reklam scriptinden ister; reklama reklam sunucumuz karar verir: interstitial ve ödüllü reklam birimlerinin satır öğeleri, önce kendi kreatiflerimiz. Oyunun istekleri ve kararlar aşağıda, “Oyunun reklam istekleri” bölümünde görünür.

The HTML5 game is played in a banner placement (300x250) and asks for ads itself: an interstitial between levels, and a rewarded ad for an extra try after a missed level. The game asks the page's ad script for them through the adBreak bridge (reklamup/ras-game-bridge.js, in the format of Google's H5 games API); our ad server decides the ad: the line items of the interstitial and rewarded units, our own creatives first. The game's requests and the decisions show below, in “The game's ad requests”.

Test adımlarıTest steps

  1. İki alan da dolmalı: ReklamUp satırında oyunun kapak kartı (“Oyna”), diğer satırlarda 300x250 banner.Both placements should fill: the game's cover card (“Oyna”, play) on the ReklamUp line item, a 300x250 banner on the other line items.
  2. “Oyna”ya dokunun: oyun (reklamup/game.html, “Yıldız Topla”) alanın içinde açılmalı. Dokunmadan önce oyun dosyası istenmemeli (debug paneli / ağ sekmesi).Tap “Oyna” (play): the game (reklamup/game.html, “Yıldız Topla”, collect the stars) should open inside the placement. The game file must not be requested before the tap (debug panel / network tab).
  3. Oyunun üç seviyesi var (20 sn, hedef 5 / 8 / 12 yıldız). Bir seviyeyi bitirince oyun seviye arası reklam ister: geçiş reklamı ekranı kaplar, oyunun saati reklam boyunca durur. “Oyunun reklam istekleri” listesinde “seviye arası reklam istedi” ve altında interstitial biriminin Durum kutusu görünmeli.The game has three levels (20 s, target 5 / 8 / 12 stars). When you finish a level, the game asks for an ad between levels: the interstitial covers the screen and the game's clock stops during the ad. “The game's ad requests” list should show “asked for an ad between levels”, with the interstitial unit's Status box below it.
  4. Bir seviyeyi kaçırın: ödüllü reklam hazırsa oyun “Reklamı izle” teklifini gösterir; izlerseniz seviyeyi yeniden oynarsınız. Listede “ödüllü reklam sordu”, “oyuncu reklamı izlemeyi seçti” ve ödüllü reklamın Durum kutusu görünmeli.Miss a level: if a rewarded ad is ready, the game offers to “watch the ad”; if you watch it, you play the level again. The list should show “asked for a rewarded ad”, “the player chose to watch the rewarded ad” and the rewarded ad's Status box.
  5. Son seviyeyi bitirince oyun rasGame.complete() der (listede “oyun sonuna kadar oynandı”); oyun ödüllü bir kreatifse ödül bununla verilir.When you finish the last level, the game calls rasGame.complete() (the list says “the game was played to the end”); if the game is a rewarded creative, that is when the reward is granted.
  6. Her alanın üstündeki etiket, reklamı hangi kaynağın verdiğini yazar: ReklamUp, Google (örnek) ya da Prebid; dolmayanlar sırayla önüne yazılır (ör. “Google: dolmadı → Prebid: teklif yok → boş”). Aynı bilgi “Durum” bölümünde ve debug panelinde de var.The label above each placement says which source delivered the ad: ReklamUp, Google (sample) or Prebid; the sources that did not fill are listed before it, in order (e.g. “Google: not filled → Prebid: no bid → empty”). The same information is in the “Status” section and in the debug panel.
  7. ReklamUp satırı sayfa görüntülemelerinin yaklaşık yarısında adaydır: sayfayı birkaç kez yenileyin, kaynak değişmeli.The ReklamUp line item is a candidate on about half of the page views: reload the page a few times and the source should change.

Örnek yayıncı sayfasıSample publisher page

SporSport

Amatör lig sezonu renkli bir törenle başladıAmateur league season opens with a colourful ceremony

Örnek Haber · 3 dk okumaSample News · 3 min read

Reklam · HTML5 oyun (reklam sunucusu)Ad · HTML5 game (ad server)#ras-d-h5

Reklam scripti bekleniyor…Waiting for the ad script…

Reklam · HTML5 oyun (oyun reklam alanı)Ad · HTML5 game (game ad placement)#ras-demo-game

Reklam scripti bekleniyor…Waiting for the ad script…

Oyunun reklam istekleriThe game's ad requests

Oyundan gelen mesajlarMessages from the game

Oyun köprüsü (ras-game-bridge.js) her isteği sayfaya postMessage ile gönderir ({ras: "ras-game", cmd}); reklam scriptinin cevapları (beforeAd, adBreakDone …) yalnızca oyunun kendi çerçevesine gider, sayfa onları görmez. Sayfa bu mesajları yalnızca okur; reklamı reklam scripti gösterir.

The game bridge (ras-game-bridge.js) sends every request to the page with postMessage ({ras: "ras-game", cmd}); the ad script's answers (beforeAd, adBreakDone …) go only to the game's own frame, so the page does not see them. The page only reads these messages; the ad script shows the ad.

  1. Henüz mesaj yok: “Oyna”ya dokunun.No messages yet: tap “Oyna” (play).

Reklam sunucusunun kararlarıThe ad server's decisions

Seviye arası reklam (adBreak “next”) reklam scriptinin interstitial yerleşiminden, ek hak (adBreak “reward”) ödüllü reklam yerleşiminden gelir. O yerleşimlerin sayfa desenleri burada uygulanmaz (oyun nerede olursa olsun ister); sıklık sınırları uygulanır. Google'ın kendi geçiş reklamı oyun içinde kullanılmaz (Durum: “bu alana uyan kreatifi yok”).

The ad between levels (adBreak “next”) comes from the ad script's interstitial placement, the extra try (adBreak “reward”) from the rewarded placement. Those placements' page patterns do not apply here (the game asks wherever it is); frequency caps do. Google's own interstitial is not used inside the game (Status: “no creative fits this placement”).

Oyun henüz seviye arası reklam istemedi.The game has not asked for an ad between levels yet.

Oyun henüz ödüllü reklam istemedi.The game has not asked for a rewarded ad yet.

DurumStatus

KaynaklarSources

ReklamUp kendi kreatifimiz → Google (örnek) → Prebid

ReklamUp our own creative → Google (sample) → Prebid

    Satır öğeleriLine items

    Reklam sunucusundaki her birimin üç satır öğesi vardır, bu sırayla: ReklamUp (öncelik 8, sayfa görüntülemelerinin %50'sinde aday: sunum oranı), o aday olmadığında ya da dolmadığında Google (örnek) (öncelik 10, Google'ın herkese açık örnek etiketleri), o da dolmazsa Prebid (msft) (öncelik 12). Prebid tarafındaki msft test yerleşimleri şu an teklif vermiyor (“Member 9325 not enabled”); Google'ın da dolmadığı yerde alan boş kalır.

    Every unit on the ad server has three line items, in this order: ReklamUp (priority 8, a candidate on 50% of page views: serve rate), then, when it is not a candidate or does not fill, Google (sample) (priority 10, Google's public sample tags), and if that does not fill either, Prebid (msft) (priority 12). The msft test placements on the Prebid side currently do not bid (“Member 9325 not enabled”); where Google does not fill either, the placement stays empty.

    Etiketler sayfanın kendi kodundan gelir: reklam scripti her kararı window.__ads.served içinde ve bir ads:served olayıyla bildirir. Olaylar debug panelinde de görünür.

    The labels come from the page's own code: the ad script reports every decision in window.__ads.served and with an ads:served event. The events also show in the debug panel.