---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.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: https://yandex.com.tr/dev/games/doc/tr/sdk/defold/adv.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com.tr/dev/games/doc/tr/llms.txt?revision=r21993288
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/games/doc/tr/llms.txt?revision=r21993288

# Reklamlarla çalışma

<!-- source: tr/_includes/script-common.md -->
<!-- source: tr/_includes/script/index-js.md -->

<!-- endsource: tr/_includes/script/index-js.md -->

<!-- source: tr/_includes/script/requirements-js.md -->

<!-- endsource: tr/_includes/script/requirements-js.md -->

<!-- source: tr/_includes/script/image-modal-js.md -->

<!-- endsource: tr/_includes/script/image-modal-js.md -->
<!-- endsource: tr/_includes/script-common.md -->

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

1. Reklam yerleşimiyle ilgili [özellikleri ve önerileri](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-adv.md#recommendations) inceleyin.
1. SDK'yı kullanarak reklam çağrısını ayarlayın.
1. Geliştirici Konsolu'nda [monetizasyonu etkinleştirin](https://yandex.com.tr/dev/games/doc/tr/console/adv-monetization.md#enable-int-monetization).

## Reklam çağrı ayarı {#settings}

### Tam ekran reklam bloğu {#full-screen-block}

<!-- source: tr/_includes/sdk/common-with-plugins.md -->
Uygulamayı tamamen kaplayan ve kullanıcının bir bilgi talebi (örneğin, oyunun bir sonraki seviyesine geçerken) ile bu bilginin alınması arasında gösterilen reklam bloğu.
<!-- endsource: tr/_includes/sdk/common-with-plugins.md -->

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}

<!-- source: tr/_includes/sdk/common-with-plugins.md -->
Kullanıcının izlediği için ödül aldığı, örneğin oyun içi para birimi kazandığı video reklam bloğu.
<!-- endsource: tr/_includes/sdk/common-with-plugins.md -->

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}

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

Geliştirici Konsolu'nda sticky banner etkinleştirme hakkında [ana makaleye](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-adv.md#banner-on) bakın.

Varsayılan olarak sticky banner, oyun başlatıldığında görünür ve oturum boyunca görüntülenir. Banner'ın gösterim zamanını 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
)
```

---


<!-- source: tr/_includes/sdk/button-git.md -->
<a href="https://github.com/yandex-games-plugins/defold">
  <span class="button">Depo</span>
</a>
<!-- endsource: tr/_includes/sdk/button-git.md -->

[*key_sticky]: Oyun sırasında görüntülenen bir reklam bloğu.