Reklamlarla çalışma

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

1. Reklam yerleşimiyle ilgili özellikleri ve önerileri inceleyin.
2. SDK'yı kullanarak reklam çağrısını ayarlayın.
3. Geliştirici Konsolu'nda monetizasyonu etkinleştirin.

Reklam çağrı ayarı

Tam ekran reklam bloğu

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.

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

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

1ysdk.adv.show_fullscreen_adv({
2    on_close = function (self, was_shown)
3        -- Reklam kapatıldığında yapılacak işlem.
4    end,
5    on_error = function (self, error)
6        -- Hata durumunda yapılacak işlem.
7    end
8})

Ödüllü video reklam (rewarded video)

Kullanıcının izlediği için ödül aldığı, örneğin oyun içi para birimi kazandığı video reklam bloğu.

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

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

 1ysdk.adv.show_rewarded_video({
 2    on_open = function (self)
 3        print("Video ad open")
 4    end,
 5    on_close = function (self)
 6        print("Rewarded!")
 7    end,
 8    on_rewarded = function (self)
 9        print("Video ad closed.")
10    end,
11    on_error = function (self, error)
12        print("Error while open video ad: " .. error)
13    end
14})

Sticky banner

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

Geliştirici Konsolu'nda sticky banner etkinleştirme hakkında ana makaleye 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.
2. 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

 1ysdk.adv.get_banner_adv_status(
 2    function (self, sticky_adv_is_showing, reason)
 3        if sticky_adv_is_showing then
 4            -- Reklam gösteriliyor.
 5        elseif reason then
 6            -- Reklam gösterilmiyor.
 7            print(reason)
 8        else
 9            ysdk.adv.show_banner_adv()
10        end
11    end
12)