--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com.tr/dev/games/doc/en/sdk/sdk-adv.md - https://yandex.com.tr/dev/games/doc/hi/sdk/sdk-adv.md - https://yandex.com.tr/dev/games/doc/ko/sdk/sdk-adv.md - https://yandex.com.tr/dev/games/doc/ru/sdk/sdk-adv.md - https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-adv.md - https://yandex.com.tr/dev/games/doc/vi/sdk/sdk-adv.md - https://yandex.com.tr/dev/games/doc/zh/sdk/sdk-adv.md - href: tr/sdk/sdk-adv.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/games/doc/tr/llms.txt # Reklam Oyunlarınıza reklam blokları yerleştirerek gelir elde edebilirsiniz. Bunun için: 1. Reklam yerleştirme ile ilgili [özellikler ve önerileri](#recommendations) inceleyin. 1. SDK'yı kullanarak [reklam çağrısını](#settings) ayarlayın. 1. Geliştirici Konsolu'nda [monetizasyonu etkinleştirin](https://yandex.com.tr/dev/games/doc/tr/console/adv-monetization.md). ## Reklam yerleştirme ile ilgili özellikler ve öneriler {#recommendations} - 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](https://yandex.com.tr/dev/games/doc/tr/requirements/4/4.md) sayfasına bakın. - [Ödüllü video reklamın (rewarded video)](#rewarded-video) çağrı sıklığında herhangi bir sınırlama bulunmaz. - Tam ekran reklam bloğunun çağrı sıklığı [Yandex Oyunlar](https://yandex.com.tr/games/){.external} platformu tarafından yönetilir. {% note alert %} Yandex Reklam Ağı, kullanıcıların reklam bloklarına rastgele tıklamalarını reklam sahtekarlığının bir işareti olarak değerlendirir ve oyundaki reklam gelirini azaltır. Bunu önlemek için, kullanıcı oyunla aktif olarak etkileşimde bulunduğunda ve istemeden reklam bloğuna tıklayabileceği durumlarda reklam göstermeyin. Yanlış bir çağrı örneği: ```javascript setInterval(() => ysdk.adv.showFullscreenAdv(), 180000) ``` {% endnote %} ## Tam ekran reklam bloğu {#full-screen-block} 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() {#show-fullscreen-adv} Tam ekran reklam bloğunu çağırın. **Yöntem imzası** ```typescript showLineNumbers function showFullscreenAdv(callbacks?: { onOpen?: () => void; onClose?: (wasShown: boolean) => void; onError?: (error: object) => void; }) => void {} ``` `callbacks` parametresinde isteğe bağlı callback işlevleri aktarabilirsiniz: #| || **Callback işlevi** | **Açıklama** || || `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 {#full-screen-example} ```javascript showLineNumbers const ysdk = await YaGames.init(); ysdk.adv.showFullscreenAdv({ [callbacks](*key_callbacks): { [onOpen](*key_onOpen): () => console.log('Reklam açıldı.'), [onClose](*key_onClose): (wasShown) => console.log(wasShown ? 'Gösterildi ve kapatıldı.' : 'Gösterilmedi.'), [onError](*key_onError): (error) => console.log('Çağrı hatası.'), } }) ``` ## Ödüllü video reklam (rewarded video) {#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() {#show-rewarded-video} Ödüllü video reklamı çağırın. **Yöntem imzası** ```typescript showLineNumbers function showRewardedVideo(callbacks?: { onOpen?: () => void; onRewarded?: () => void; onClose?: (wasShown: boolean) => void; onError?: (error: object) => void; }) => void {} ``` `callbacks` parametresinde isteğe bağlı callback işlevleri aktarabilirsiniz: #| || **Callback işlevi** | **Açıklama** || || `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 {#rewarded-video-example} ```javascript showLineNumbers const ysdk = await YaGames.init(); ysdk.adv.showRewardedVideo({ [callbacks](*key_callbacks): { [onOpen](*key_onOpen): () => console.log('Reklam açıldı.'), [onRewarded](*key_onRewarded): () => console.log('Kullanıcı ödül aldı.'), [onClose](*key_onClose2): (wasShown) => console.log(wasShown ? 'Gösterildi ve kapatıldı.' : 'Gösterilmedi.'), [onError](*key_onError): (error) => console.log('Çağrı hatası.'), } }) ``` ## Sticky banner {#sticky-banner} Oyun sırasında gösterilen bir reklam bloğu. ### Sticky banner gösterimini etkinleştirme {#banner-on} 1. [Geliştirici Konsolu'nu](https://games.yandex.com/console){.external} açın ve **Advertising** sekmesine geçin. 1. **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 {#banner-adv} 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](https://games.yandex.com/console){.external} **Advertising** sekmesinde **Use the API to display a sticky-banner** seçeneğini etkinleştirin. #### ysdk.adv.getBannerAdvStatus() {#get-banner-adv-status} Sticky banner'ın mevcut durumunu alın. **Yöntem imzası** ```typescript showLineNumbers function getBannerAdvStatus(): Promise<{ stickyAdvIsShowing: boolean; reason?: 'ADV_IS_NOT_CONNECTED' | 'UNKNOWN'; }> {} ``` 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: #| || **Neden** | **Açıklama** || || `ADV_IS_NOT_CONNECTED` | Banner'lar bağlı değil. || || `UNKNOWN` | Yandex tarafında reklam görüntüleme hatası. || |# #### ysdk.adv.showBannerAdv() {#show-banner-adv} Sticky banner'ı gösterin. **Yöntem imzası** ```typescript showLineNumbers function showBannerAdv(): Promise<{ stickyAdvIsShowing: boolean; reason?: 'ADV_IS_NOT_CONNECTED' | 'UNKNOWN'; }> ``` Döndürülen değerler [ysdk.adv.getBannerAdvStatus()](#get-banner-adv-status) değerleriyle aynıdır. #### ysdk.adv.hideBannerAdv() {#hide-banner-adv} Sticky banner'ı gizleyin. **Yöntem imzası** ```typescript showLineNumbers function hideBannerAdv(): Promise<{ stickyAdvIsShowing: boolean; }> ``` Sticky banner'ın görüntülenme durumunu `stickyAdvIsShowing` döndürür. #### Örnek {#sticky-banner-example} ```javascript showLineNumbers const ysdk = await YaGames.init(); const { stickyAdvIsShowing , reason } = await ysdk.adv.getBannerAdvStatus(); if (stickyAdvIsShowing) { // Reklam gösteriliyor. } else if (reason) { // Reklam gösterilmiyor. console.log(reason); } else { ysdk.adv.showBannerAdv(); } ``` --- {% note info %} Destek ekibi, hazır oyunu Yandex Oyun platformuna yerleştirmenize yardımcı olur. Geliştirme ve test etme konularındaki uygulamalı sorulara ise diğer geliştiriciler [Discord Topluluğu](https://discord.com/invite/wU4p3whr4T){.external} yanıt verir. {% endnote %} Yandex Games SDK kullanırken sorunla karşılaşırsanız veya sorunuz varsa, lütfen destek ekibiyle iletişime geçin: Sohbete yaz [*key_callbacks]: `callbacks` — İsteğe bağlı callback işlevleri. Her reklam bloğu için ayrı ayrı ayarlanır. [*key_onOpen]: `onOpen` — Video reklamlar ekranda görüntülendiğinde çağrılır. [*key_onRewarded]: `onRewarded` — Video reklam görüntülemeleri 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. [*key_onClose]: `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` bağımsız değişkeni (tip: `boolean`) ile birlikte kullanılır. [*key_onClose2]: `onClose` — Video reklam kapatıldığında çağrılır. [*key_onError]: `onError` — Bir hata oluştuğunda çağrılır. Hata nesnesi callback işlevine aktarılır.