Bu makalede, Google Yayıncı Etiketi (GPT) kitaplığı kullanılarak H5 oyun geçiş reklamının nasıl gösterileceğini açıklayan notlar ve örnekler verilmektedir. Oyun geçiş reklamları, web sayfalarında çalışan oyunlarda manuel tetikleyici aracılığıyla kullanıcılara gösterilen ve GPT tarafından yönetilen tam sayfa reklamlardır.
Aşağıdaki GPT etkinlikleri, oyun geçiş reklamlarını göstermek ve bu reklamlarla etkileşimde bulunmak için kullanılır:
| Etkinlik | Tetiklenme zamanı... |
|---|---|
|
|
Oyun geçiş reklamı alanı gösterilmeye hazır. Geçiş reklamını görüntülemek için sağlanan etkinlik nesnesinde |
|
|
Gösterilen bir oyun geçiş reklamı alanı artık kapalı. Oyun geçiş reklamı kapatıldığında özel mantığı yürütmek için kullanılır. |
Oyun geçiş reklamı, oyunun nasıl görüntülendiğine bağlı olarak tam ekran veya oyun çerçevesi içinde oluşturulabilir. H5 Oyunlarında Gösterilen Reklam yapıları hakkında daha fazla bilgi
Aşağıdaki örnek kodda, H5 oyununun doğrudan sayfayla aynı üst çerçeveye yerleştirildiği varsayılır ("Tam Ekran" yapısı kullanılır). Bu durumda, oyun geçiş reklamı da tam ekran olarak oluşturulur.
Bununla birlikte, bu kod "iFrame/WebView" yapısı kullanılarak bir alt çerçevenin içine yerleştirildiğinde de çalışır. Oyun geçiş reklamını H5 oyun tuvaliyle sınırlamak için oyunun bir iFrame'e yerleştirilmesi gerekir.
Örnek
<!doctype html>
<html>
<head>
<!-- Buradaki Google Yayıncı Etiketi (varsa) yalnızca H5 oyununun dışında reklam yayınlamaktan sorumludur. -->
<title>Bu örnek H5 oyununun sayfası</title>
<!-- <head> içeriğinizi buraya ekleyin. -->
</head>
<body>
<span id="example-text">Örnek H5 oyunu</span>
<iframe src="https://www.example-game.com" title="Örnek oyun" allow="autoplay">
<!-- Örnek kod burada sunulur. Bu çerçevede yüklenen Google Yayıncı Etiketi yalnızca H5 oyununda kullanılır. -->
</iframe>
</body>
</html>
Kullanım notları
- GPT, en iyi kullanıcı deneyimini sağlamak için yalnızca biçimi düzgün şekilde destekleyen sayfalarda oyun geçiş reklamları ister. Bu nedenle
defineOutOfPageSlot(), null döndürebilir. Yalnızca geçiş reklamının görünmesini istediğiniz sayfalarda veya ortamlarda oyun geçiş reklamları isteyin. Oyun geçiş reklamları; masaüstü, tablet ve mobil cihazlarda yayınlanmaya uygundur. - Geçiş reklamı,
makeGameManualInterstitialVisiblemakeGameManualInterstitialVisibleişlevini çağırdığınızda görünür. - Oyun geçiş reklamlarının sabit bir sıklık sınırı vardır. Bu,
gameManualInterstitialSlotReadyetkinliğinin her 120 saniyede bir defadan fazla tetiklenmesini engeller.
Koşullar ve öneriler
- Yayıncıların, oyun dışı envanterde H5 oyun geçiş reklamı kullanmasına izin verilmez. Yayıncılar bu biçimi uygulayarak bu koşulu otomatik olarak kabul eder. Google Yayıncı Politikaları ve Google Ad Manager İş Ortağı Kuralları'na da uyulmalıdır.
- Google, yayıncıları herhangi bir zamanda onaylama veya onaylamama hakkını saklı tutar. İhlalde bulunduğu tespit edilen yayıncılar, izin verilenler listesinden çıkarılır.
- Oyun geçiş reklamları kendi reklam alanlarını oluşturur. Diğer reklam türlerinin aksine, oyun geçiş reklamları için bir <div> öğesi tanımlamaya gerek yoktur. Bu reklamlar, bir reklam yüklendiğinde kendi kapsayıcılarını otomatik olarak oluşturup sayfaya ekler.
- Birden fazla alan içeren sayfada tekli istek mimarisi (SRA) kullanıyorsanız statik reklam alanı div'leri oluşturulana kadar
display()çağırmayın. Google Ads En İyi Uygulamaları bölümünde açıklandığı gibi,display()işlevine yapılan ilk çağrı bu noktadan önce tanımlanmış her reklam alanını ister. Oyun geçiş reklamı alanları için önceden tanımlanmış bir <div> gerekmese de statik reklam alanları için gerekir. Bu öğeler sayfaya eklenmeden öncedisplay()çağrısı yapmak, sinyallerin kalitesinin düşmesine neden olabilir. Bu nedenle, ilk çağrıyı statik alanlar tanımlanana kadar ertelemeniz önerilir. - Manuel geçiş reklamlarını trafiğe eklemek için standart web geçiş reklamlarıyla aynı reklam birimi ve satır öğesi kurulumu gerekir.
Başlayın
- Etiketleme
googletag.defineOutOfPageSlot()yöntemini kullanarak bir GPT alanı oluşturun ve OutOfPage biçiminigoogletag.defineOutOfPageSlot()olarak ayarlayın.
H5 oyun geçiş reklamı için GPT teknik geliştirici kılavuzuna bakın.- Alan tanımlandıktan sonra
gameManualInterstitialSlotReadyetkinliğini dinleyen bir etkinlik işleyici ekleyin. Reklamı görüntülemek için etkinlik işleyici geri arama işlevinde, sağlanan etkinlik nesnesindenmakeGameManualInterstitialVisible()yöntemini çağırın. - Diğer tüm statik reklam alanlarını beyan ettikten sonra
googletag.displayçağrısı, oyun geçiş reklamı alanının doldurulması için bir istek tetikler.
Örnek
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Oyun Manuel Geçiş Reklamı Örneği</title>
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script>
window.googletag = window.googletag || { cmd: [] };
let gameManualInterstitialSlot;
googletag.cmd.push(function () {
// Oyun manuel geçiş reklamı alanı tanımlayın.
defineGameManualInterstitialSlot();
// Statik reklam alanlarını tanımlayın.
staticSlot = googletag.defineSlot(
'/6355419/Travel/Europe', [100, 100], 'static-ad-1')
.addService(googletag.pubads());
// SRA ve hizmetleri etkinleştirin.
googletag.pubads().enableSingleRequest();
googletag.enableServices();
});
function defineGameManualInterstitialSlot() {
gameManualInterstitialSlot = googletag.defineOutOfPageSlot(
'/6355419/Travel/Europe/France/Paris',
googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL);
// Sayfa veya cihaz geçiş reklamlarını desteklemiyorsa alan null değerini döndürür.
if (gameManualInterstitialSlot) {
gameManualInterstitialSlot.addService(googletag.pubads());
printStatus('Waiting for interstitial to be ready...');
// Geçiş reklamı yüklendikten sonra tıklama işleyiciyi kaydetmek için etkinlik işleyici ekleyin.
// Bu etkinlik etkinleşmezse yerel depolama alanını temizleyip sayfayı yenilemeyi
// deneyin.
googletag.pubads().addEventListener('gameManualInterstitialSlotReady',
(slotReadyEvent) => {
if (gameManualInterstitialSlot === slotReadyEvent.slot) {
printStatus('Interstitial is ready.');
const button = document.getElementById('trigger');
button.style.display = 'block';
button.addEventListener('click', () => {
slotReadyEvent.makeGameManualInterstitialVisible();
printStatus('Interstitial is active.');
}, { once: true });
}
});
googletag.pubads().addEventListener('gameManualInterstitialSlotClosed',
resumeGame);
}
}
function resumeGame() {
document.getElementById('trigger').style.display = 'none';
// Oyun manuel geçiş reklamı alanları tek kullanımlıktır, bu nedenle eski alanı kaldırıp yeni bir tane oluşturun.
googletag.destroySlots([gameManualInterstitialSlot]);
defineGameManualInterstitialSlot();
googletag.display(gameManualInterstitialSlot);
}
function printStatus(status) {
document.getElementById('status').innerText = status;
}
</script>
<style>
button {
display: none;
}
div.content {
position: fixed;
top: 50%;
}
</style>
</head>
<body>
<div id="static-ad-1" style="width: 100px; height: 100px;"></div>
<div class="content">
<span id="status">Oyun manuel geçiş reklamı bu sayfada desteklenmiyor.</span>
<p>
<button id="trigger">GEÇİŞ REKLAMINI TETİKLE</button>
</p>
</div>
<script>
googletag.cmd.push(function () {
// İlk görüntüleme çağrısının statik reklam alanı div'leri tanımlandıktan sonra
// geldiğinden emin olun.
googletag.display(staticSlot);
});
</script>
</body>
</html>
Trafik işlemleri
- Yeni bir reklam birimi oluşturun veya mevcut bir reklam birimini yeniden kullanın. Reklam birimi boyutu olarak 320x480, 300x250 ve 336x280'i seçin.
- Satır öğeleri oluşturun. Kullanım alanınıza göre uygun satır öğesi ayarlarını seçin:
| Satır öğesi ayarları | ||||
|---|---|---|---|---|
| Kullanım alanı | Reklam türü | Satır öğesi türü | Beklenen reklam öğeleri | Hedefleme > Envanter |
| Rezervasyon görüntülü reklamı yayınlamak için | Görüntülü |
|
320x480, 300x250 veya 336x280 |
Önceki adımda oluşturulan veya seçilen reklam birimi |
| Rezerve edilmemiş bir reklam yayınlamak için | Görüntülü |
|
||
| Rezervasyon esaslı video reklam (ör. VAST etiketi veya MP4) yayınlamak için | Video veya işitsel |
|
300x250v veya 320x480v | |
| Dolgu/herkesin katılabileceği açık artırma reklamları yayınlamak için | Görüntülü | Ad Exchange | Tüm istenen boyutlar | |