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.
Bu sayfada
- Koşullar ve öneriler
- Etiketlemeye başlama
- Trafik işlemleri
- Trafik işlemleri video serisi: H5 oyun geçiş reklamları | H5 oyunları için ödüllü reklamlar
- Raporlama
Koşullar ve öneriler
- Yayıncıların, oyun dışı envanterde H5 oyun geçiş reklamı kullanmasına izin verilmez. Bu biçimi uygulayan yayıncılar, bu koşulu otomatik olarak kabul etmiş olur. Google Yayıncı Politikaları ve Google Ad Manager İş Ortağı Kuralları'na da uyulmalıdır.
- Google, herhangi bir zamanda yayıncıları onaylama veya onaylamama hakkını saklı tutar. İhlalde bulunduğu tespit edilen yayıncılar daha sonra 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 içi geçiş reklamı alanları için önceden tanımlanmış bir <div> gerekmezken statik reklam alanları için gerekir. Bu öğeler sayfada bulunmadan ö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ında olduğu gibi aynı reklam birimi ve satır öğesi kurulumu gerekir.
Etiketlemeye başlama
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ı bildirdikten 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 alan 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>
GPT etkinlikleri
Oyun geçiş reklamlarını göstermek ve bunlarla etkileşimde bulunmak için aşağıdaki GPT etkinlikleri 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 kod, H5 oyununun doğrudan sayfayla aynı üst çerçeveye yerleştirildiğini (tam ekran yapısı kullanılarak) varsayar. 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>
<!-- Burada varsa Google Yayıncı Etiketi, yalnızca H5 oyununun dışında reklam yayınlamaktan sorumlu olacaktır. -->
<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>
GPT 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 bir 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ı,
gameManualInterstitialSlotReady etkinliğindenmakeGameManualInterstitialVisibleiş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 30 saniyede bir defadan fazla tetiklenmesini engeller.
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 |
| Ayrılmamış 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 | |
Trafik işlemleri video serisi: H5 oyun geçiş reklamlarını kullanmaya başlayın
H5 oyun geçiş reklamlarını kullanmaya başlamanıza yardımcı olacak bu iki bölümlük serideki videoları izleyin.
| 1. Bölüm: Ad Manager'da H5 oyun geçiş reklamları |
| H5 Gaming Interstitial Ads on Ad Manager |
| 2. Bölüm: Ad Manager'da H5 oyunları için ödüllü reklamlar |
| Rewarded Ads for H5 Gaming on Ad Manager |