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. Geliştirici Konsolu'nda monetizasyonu 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)

Tam ekran reklam bloğu

Uygulamayı tamamen kapatan 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ğu.

ysdk.adv.showFullscreenAdv()

Tam ekran reklam bloğunu çağırı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:

Ö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)

Kullanıcının izleme karşılığında ödül (örneğin oyun içi para birimi) aldığı video reklamlı bir blok.

ysdk.adv.showRewardedVideo()

Ödüllü video reklamı çağırı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:

Ö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

Oyun sırasında gösterilen bir reklam bloğu.

Sticky banner gösterimini etkinleştirme

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 Geliştirici Konsolu'nda Advertising sekmesinde 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:

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: