--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com.tr/dev/games/doc/en/sdk/defold/adv.md - https://yandex.com.tr/dev/games/doc/hi/sdk/defold/adv.md - https://yandex.com.tr/dev/games/doc/ko/sdk/defold/adv.md - https://yandex.com.tr/dev/games/doc/ru/sdk/defold/adv.md - https://yandex.com.tr/dev/games/doc/tr/sdk/defold/adv.md - https://yandex.com.tr/dev/games/doc/vi/sdk/defold/adv.md - https://yandex.com.tr/dev/games/doc/zh/sdk/defold/adv.md - href: tr/sdk/defold/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 # Reklamlarla çalışma 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ı ayarlayın. 1. Yandex Games geliştirici konsolunda [Parasallaşmayı 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. - Oyuna reklam eklenmesi önerilen yerler: Oyuna başlamadan önce, bir sonraki seviyeye geçerken, oyun kaybedildikten sonra. - [Ödüllü video reklamın (rewarded video)](#rewarded-video)'ın çağrı sıklığında herhangi bir sınırlama bulunmaz. - Tam ekran reklam bloğunun çağrı sıklığı [Yandex Games](https://yandex.com.tr/games/){.external} platformu tarafından yönetilir. {% note alert %} Yandex Advertising Network, 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ının oyun devam ederken istemeden bir reklam bloğuna tıklayabileceği reklamların görüntülenmesine izin vermeyin. {% endnote %} ## Reklam çağrı ayarı {#settings} ### Tam ekran reklam bloğu {#full-screen-block} Tam ekran reklam bloğu, uygulamanın arka planını tamamen kaplayan ve kullanıcının sorgu gönderdiği (örneğin, oyunun bir sonraki seviyesine geçerken) ve yanıtını aldığı zaman arasında gösterilen reklam bloklarıdır. Reklamı çağırmak için `ysdk.adv.show_fullscreen_adv()` yöntemini kullanın. ```lua ysdk.adv.show_fullscreen_adv(callbacks: table) ``` `callbacks: table` — isteğe bağlı callback işlevleri. Her reklam bloğu için ayrı ayrı ayarlanır. - `on_close` — 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. - `on_open` — reklam başarıyla açıldığında çağrılır. - `on_error` — bir hata oluştuğunda çağrılır. Hata nesnesi callback işlevine aktarılır. - `on_offline` — ağ bağlantısı kesildiğinde (çevrimdışı moda geçildiğinde) çağrılır. #### Örnek {#full-screen-example} ```lua showLineNumbers ysdk.adv.show_fullscreen_adv({ on_close = function (self, was_shown) -- Reklam kapatıldığında yapılacak işlem. end, on_error = function (self, error) -- Hata durumunda yapılacak işlem. end }) ``` ### Ödüllü video reklam (rewarded video) {#rewarded-video} Ödül videolar, oyunlardan para kazanmak için kullanılan video reklamları içeren bloklardır. Kullanıcı, videoyu izlediği için bir ödül veya oyun içi para birimi alır. Reklamı çağırmak için `ysdk.adv.show_rewarded_video()` yöntemini kullanın. ```lua ysdk.adv.show_rewarded_video(callbacks: table) ``` `callbacks: table` — isteğe bağlı callback işlevleri. Her reklam bloğu için ayrı ayrı ayarlanır. - `on_close` — bir video reklam kapatılırken çağrılır. - `on_open` — video reklamlar ekranda görüntülendiğinde çağrılır. - `on_error` — bir hata oluştuğunda çağrılır. Hata nesnesi callback işlevine aktarılır. - `on_rewarded` — 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. #### Örnek {#rewarded-video-example} ```lua showLineNumbers ysdk.adv.show_rewarded_video({ on_open = function (self) print("Video ad open") end, on_close = function (self) print("Rewarded!") end, on_rewarded = function (self) print("Video ad closed.") end, on_error = function (self, error) print("Error while open video ad: " .. error) end }) ``` ### Sticky banner {#sticky-banner} [Sticky banner](*key_sticky) gösterimlerini etkinleştirmek için: 1. Geliştirici konsolunu 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** yönünü seçin, - **Sticky banner in landscape orientation**: **At the bottom**, **At the top** veya **On the right** yönünü seçin. - Bilgisayarlar için: **Sticky banner on the desktop** seçeneğini etkinleştirin. Banner sağ tarafta gösterilecektir. Varsayılan olarak, sticky banner oyun başlangıcında görünür ve tüm oturum boyunca görüntülenir. Banner'ın ne zaman gösterileceğini ayarlamak için: 1. **Sticky banners** bloğunda, **Use the API to display a sticky-banner** seçeneğini etkinleştirin. 1. Aşağıdaki yöntemleri kullanarak banner'ların görüntülenmesini ayarlayın: - `ysdk.adv.get_banner_adv_status()` — banner'ın durumunu gösterir,; - `ysdk.adv.show_banner_adv()` — banner'ı çağırır; - `ysdk.adv.hide_banner_adv()` — banner'ı kaldırır.. `ysdk.adv.get_banner_adv_status()` metodları `sticky_adv_is_showing: boolean` değerini döndürür. Eğer `sticky_adv_is_showing = false` ise, `ysdk.adv.get_banner_adv_status()` metodu olası nedenlerle birlikte opsiyonel bir `reason` alanı döndürebilir: - `ADV_IS_NOT_CONNECTED` — banner'lar bağlı değil; - `UNKNOWN` — Yandex tarafında reklam görüntüleme hatası. #### Örnek {#sticky-banner-example} ```lua showLineNumbers ysdk.adv.get_banner_adv_status( function (self, sticky_adv_is_showing, reason) if sticky_adv_is_showing then -- Reklam gösteriliyor. elseif reason then -- Reklam gösterilmiyor. print(reason) else ysdk.adv.show_banner_adv() end end ) ``` --- Depo [*key_sticky]: Oyun sırasında görüntülenen bir reklam bloğu.