Yerleşim türleri

Tüm adBreak() çağrıları bir yerleşim türü belirtmelidir. Bu, reklam gösterildiğinde oyununuzun durumunu açıklayan bir dizedir. Oyununuz yeni mi yükleniyor? Oyuncu oyunu duraklattı mı? Oyununuzda ödül kazanılabilecekleri bir noktaya mı ulaştılar?

Kullandığınız tam eşleme türü önemlidir. Gösterilecek reklam deneyimi türünü (geçiş reklamına ve ödüllü reklama) doğrudan etkileyebileceği için. Ancak API'nin davranışı üzerinde daha az görünür olan başka etkileri de olabilir. API'nin en iyi şekilde çalışması için yerleşim türünü doğru bir şekilde belirtmeniz önemlidir.

Yerleşim türü Açıklama
'preroll' Oyununuz kullanıcı arayüzünü yüklemedi ve ses çalmıyor. Oyununuzda, her sayfa yükleme için yalnızca bir "videodan önce" yerleşim olabilir.

Örnek: Bir oyuncu, oyun kataloğunda oyununuzu tıklar. Oyun tuvali görüntülenir ve oyununuz kullanıcı arayüzünü oluşturmadan veya ses gösterilmesini sağlayan bir reklam göstermeden önce gösterilir. Oyuncu, reklamı tıklayabilir veya kapatarak oyunu başlatabilir.
'start' Oyununuz yüklendi, kullanıcı arayüzü görünür ve ses etkin. Oyuncular oyunla etkileşimde bulunabilir ancak oyun henüz başlamamıştır.

Örnek: Kısa bir yükleme ekranı "Yükleniyor...” yazar ve bir geçiş reklamı gösterilir. Oyuncu, oyuna devam etmek için reklamı tıklayabilir veya kapatabilir.

NOT: preroll, start yerleşiminden çok daha fazla performans gösterir. preroll, API'nin başlatılmasını bekler ve reklamları otomatik olarak önceden yükler. Kullanıcı arayüzü oluşturulmadan önce, oyununuz yüklenirken gösterilen ilk reklam için start yerine preroll kullanmanız gerekir. start, kullanıcı arayüzünüz oluşturulduktan ve oyuncu oyunla etkileşimde bulunduktan sonra daha iyi bir yerleşimdir.
start Oyun yeniden başlatıldığında da kullanılabilir. Her sayfa yüklemesinde birden fazla start yerleşimi olabilir. Oyununuzun ilk yerleşimi start yerleşimiyse (yani preroll yerleşimini kullanmıyorsanız) reklamların önceden yüklenmesini manuel olarak istemeniz gerekebilir.
'pause' Oyuncu oyunu duraklatır.

Örnek: Oyuncu oyunu duraklatır ve bir geçiş reklamı gösterilir. Reklam, oynatıcı kapanana kadar ekranda kalır. Geri döndüğünde oyun hâlâ duraklatılmış durumda. Sonrasında oyuncu oyunu devam ettirebilir ve oynamaya devam edebilir.
'next' Oyuncu bir sonraki seviyeye geçer.

Örnek: Oyuncu bir seviyeyi yeni tamamlamıştır. Bir düğme "Sonraki seviye..."ye dokunurlar. Bir geçiş reklamı gösterilir. Reklamı görüntüler, kapatır ve bir sonraki seviyeye geçerler.
'browse' Oyuncu, oyun dışında seçenekleri keşfediyor.

Örnek: Oyuncu, karakterinin tarzını değiştirmek istiyor. "Fırsatlar..." düğmesine dokunan bir geçiş reklamı gösteriliyor. Reklamı görüntüler, kapatır ve karakter düzenleyiciye gider.
'reward' Oyuncu, oyunda ödül verilen bir noktaya ulaşır.

Örnek: Oyuncu henüz ölmüş ve canı bitmiştir. Bu aşamada reklam izlemeleri kullanıcılara bonus can sunar. Ad Placement API, oynatıcıya ödülü sunmak için kodunuzu çağırır. Ödül düğmesine dokunur ve bir video reklamın tamamını izler. Sonrasında yeni bir hayat bulur ve oynamaya devam eder.

Not: Bu yerleşim türü grubu, etkin bir geliştirme alanıdır.

Oyununuzda doğal olarak bu kategorilerden birine uymayan yerleşimler varsa, Google Hesap Yöneticinize bildirin. Geri bildiriminizi zaman içinde bu kategorileri hassaslaştırmak için kullanırız.