Reklam

Oyunlarınıza reklam blokları yerleştirerek gelir elde edebilirsiniz. Bunun için:

1. Reklam yerleştirme ile ilgili özellikler ve önerileri inceleyin.
2. SDK'yı kullanarak reklam çağrısını ayarlayın.
3. Yandex Oyun Konsolu'nda parasallaştırmayı etkinleştirin.

Reklam yerleştirme ile ilgili özellikler ve öneriler

• Reklam çağrısını öyle bir şekilde yerleştirin ki kullanıcı bunun, oyunun bir parçası değil, bir reklam bloğu olduğunu anlasın.
• Reklamı kullanıcı eylemi sonrasında veya seviye geçişi 5 dakikadan uzun sürüyorsa zamanlayıcı ile göstermeniz önerilir. Ayrıntılar için Reklam yerleşimi sayfasına bakın.
• Ödüllü video reklamın (rewarded video) çağrı sıklığında herhangi bir sınırlama bulunmaz.
• Tam ekran reklam bloğunun çağrı sıklığı Yandex Oyunlar platformu tarafından yönetilir.

setInterval(() => ysdk.adv.showFullscreenAdv(), 180000)

Reklam çağrı ayarı

Tam ekran reklam bloğu

Tam ekran reklam bloğu, uygulamayı tamamen kaplayan ve kullanıcının bir bilgi talep etmesi (örneğin, oyunun bir sonraki seviyesine geçerken) ile bu bilgiyi alması arasında gösterilen reklam bloğudur.

Reklamı çağırmak için ysdk.adv.showFullscreenAdv() yöntemini kullanın.

Yöntem imzası:

1function showFullscreenAdv(callbacks?: {
2    onOpen?: () => void;
3    onClose?: (wasShown: boolean) => void;
4    onError?: (error: object) => void;
5}) => void {}

callbacks parametresinde isteğe bağlı callback işlevleri aktarabilirsiniz:

• onOpen — reklam başarıyla açıldığında çağrılır.
• onClose — reklam kapatıldığında, bir hatadan sonra ve ayrıca çok sık çağrıldığı için reklam açılmadığında çağrılır. Reklamın gösterilip gösterilmediğini öğrenebileceğiniz wasShown argümanı (tip boolean) ile birlikte kullanılır.
• onError — bir hata oluştuğunda çağrılır. Hata nesnesi callback işlevine aktarılır.

Örnek

 1const ysdk = await YaGames.init();
 2
 3ysdk.adv.showFullscreenAdv({
 4    callbacks: {
 5        onOpen: () => console.log('Reklam açıldı.'),
 6        onClose: (wasShown) => console.log(wasShown ? 'Gösterildi ve kapatıldı.' : 'Gösterilmedi.'),
 7        onError: (error) => console.log('Çağrı hatası.'),
 8    }
 9})

Ödüllü video reklam (rewarded video)

Ödüllü video, kullanıcının izleme karşılığında ödül (örneğin oyun içi para birimi) aldığı video reklamlı bir bloktur.

Reklamı çağırmak için ysdk.adv.showRewardedVideo() yöntemini kullanın.

Yöntem imzası:

1function showRewardedVideo(callbacks?: {
2    onOpen?: () => void;
3    onRewarded?: () => void;
4    onClose?: (wasShown: boolean) => void;
5    onError?: (error: object) => void;
6}) => void {}

callbacks parametresinde isteğe bağlı callback işlevleri aktarabilirsiniz:

• onOpen — video reklam ekranda görüntülendiğinde çağrılır.
• onRewarded — video reklam görüntülemesi sayıldığında çağrılır. Bu işlevde kullanıcının görüntülemeden sonra ne ödül alacağını belirtin.
• onClose — video reklam kapatıldığında çağrılır.
• onError — bir hata oluştuğunda çağrılır. Hata nesnesi callback işlevine aktarılır.

Örnek

 1const ysdk = await YaGames.init();
 2
 3ysdk.adv.showRewardedVideo({
 4    callbacks: {
 5        onOpen: () => console.log('Reklam açıldı.'),
 6        onRewarded: () => console.log('Kullanıcı ödül aldı.'),
 7        onClose: (wasShown) => console.log(wasShown ? 'Gösterildi ve kapatıldı.' : 'Gösterilmedi.'),
 8        onError: (error) => console.log('Çağrı hatası.'),
 9    }
10})

Sticky banner gösterimini etkinleştirme

Sticky banner, oyun sırasında gösterilen bir reklam bloğudur. Sticky banner gösterimini etkinleştirmek için:

1. Geliştirici Konsolu'nu açın ve Advertising sekmesine geçin.
2. Sticky banners bloğunda, banner'ların görüntülenmesini ayarlayın:
   • Mobil cihazlar için:
     • Sticky banner in portrait orientation — At the bottom veya At the top konumunu seçin.
     • Sticky banner in landscape orientation — At the bottom, At the top veya On the right konumunu seçin.
   • Bilgisayarlar için — Sticky banner on the desktop seçeneğini etkinleştirin. Banner sağ tarafta gösterilecektir.

Sticky banner gösterimini yönetme

Varsayılan olarak, sticky banner oyun başlangıcında görünür ve tüm oturum boyunca görüntülenir. SDK yöntemleriyle sticky banner gösterimini yönetmek için Use the API to display a sticky-banner seçeneğini etkinleştirin.

ysdk.adv.getBannerAdvStatus()

Sticky banner'ın mevcut durumunu alın.

Yöntem imzası:

1function getBannerAdvStatus(): Promise<{
2    stickyAdvIsShowing: boolean;
3    reason?: 'ADV_IS_NOT_CONNECTED' | 'UNKNOWN';
4}> {}

Sticky banner'ın görüntülenme durumunu stickyAdvIsShowing döndürür. Banner gösterilmiyorsa, banner'ın bulunmamasının nedenini belirten isteğe bağlı reason alanını da döndürür:

• ADV_IS_NOT_CONNECTED — banner'lar bağlı değil.
• UNKNOWN — Yandex tarafında reklam görüntüleme hatası.

ysdk.adv.showBannerAdv()

Sticky banner'ı gösterin.

Yöntem imzası:

1function showBannerAdv(): Promise<{
2    stickyAdvIsShowing: boolean;
3    reason?: 'ADV_IS_NOT_CONNECTED' | 'UNKNOWN';
4}>

Döndürülen değerler ysdk.adv.getBannerAdvStatus() değerleriyle aynıdır.

ysdk.adv.hideBannerAdv()

Sticky banner'ı gizleyin.

Yöntem imzası:

1function hideBannerAdv(): Promise<{
2    stickyAdvIsShowing: boolean;
3}>

Sticky banner'ın görüntülenme durumunu stickyAdvIsShowing döndürür.

Örnek

 1const ysdk = await YaGames.init();
 2
 3const { stickyAdvIsShowing , reason } = await ysdk.adv.getBannerAdvStatus();
 4
 5if (stickyAdvIsShowing) {
 6    // Reklam gösteriliyor.
 7} else if (reason) {
 8    // Reklam gösterilmiyor.
 9    console.log(reason);
10} else {
11    ysdk.adv.showBannerAdv();
12}

Yandex Games SDK kullanırken sorunla karşılaşırsanız veya sorunuz varsa, lütfen destek ekibiyle iletişime geçin: