Uygulama Yönetimi

Uygulamalarım (Kontrol Paneli)

Uygulamalarım (/ veya /apps), giriş yaptıktan sonra açılan sayfadır ve ekibinizin yönettiği tüm uygulamalar için ana yönetim merkezidir.

Uygulama tablosu. Her satırda şunlar gösterilir: sıra numarası, uygulama simgesi (simge yüklenmemişse yerine harf içeren bir avatar), uygulamanın adı ve paket/bundle kimliği, atanan Marka, Mağaza (iOS/Android/Amazon için platform simgesi), mevcut SDK Sürümü (sıralanabilir), Varsayılan Yapılandırma durum noktası (uygulama için varsayılan yapılandırma oluşturulmuşsa yeşil "Eklendi", aksi takdirde gri "Eklenmedi"), Oluşturulma Tarihi (sıralanabilir) ve İşlemler sütunu.

Arama ve filtreleme. Arama kutusu, siz yazdıkça ada/pakete göre filtreleme yapar. Filtre Çubuğundaki ayrı Marka, Mağaza ve SDK Sürümü açılır filtreleri aramayla birlikte kullanılabilir. Sayfalama, tablonun yerleşik sayfalama bileşeni yerine, sayfa başına satır sayısı seçicisi ve ⟨ ‹ › ⟩ gezinme düğmeleri içeren özel bir "Z kayıttan X–Y arası gösteriliyor" alt alanıyla yapılır.

İşlemler menüsü. Her satırdaki üç nokta menüsü, izinlerinize bağlı olarak Düzenle, Çoğalt ve Sil seçeneklerini sunar (aşağıdaki Plan sınırları ve paylaşılan görünüm izinleri açıklamalarına bakın).

Plan sınırları ve kilitli uygulamalar. Abonelik planınız, sahip olabileceğiniz uygulama sayısını sınırlar (maxApps). Mevcut uygulama sayınız bu sınırı aşarsa — örneğin daha düşük bir plana geçtikten sonra — sayfanın üst kısmında sarı-turuncu bir uyarı bandı görünür: "Uygulama sınırınızı aştınız — X/Y uygulama kullanılıyor". Bu bantta küçük bir ilerleme çubuğu ve Abonelik sayfasına yönlendiren Planı Yükselt düğmesi bulunur.

Sınırı aştığınızda Portal, hangi uygulamaların kilitleneceğini rastgele belirlemez: oluşturulma tarihine göre en eski uygulamalarınızı plan sınırına kadar kullanılabilir durumda tutar ve bunlardan sonra oluşturulan tüm uygulamaları kilitler. Kilitli bir uygulamanın İşlemler menüsü kısıtlı bir görünüme geçer: üç nokta düğmesine tıkladığınızda yalnızca "Bu uygulama plan sınırınızın dışında. Yer açmak için uygulamayı silin" açıklamasını içeren "KİLİTLİ" başlığı ve silme yetkiniz varsa kırmızı bir "Uygulamayı Sil" seçeneği gösterilir. Kilitli satırlarda Düzenle ve Çoğalt kullanılamaz. Kilitli bir uygulamaya yeniden erişmenin tek yolu, yer açmak için başka uygulamaları silmek veya planınızı yükseltmektir.

Oluştur düğmesi. + Uygulama Oluştur düğmesi yalnızca planınızda hâlâ yer varsa tıklanabilir (canCreateApp()). Sınırınıza ulaştıysanız bunun yerine küçük bir kullanım göstergesi ("X/Y uygulama kullanılıyor") ve Abonelik sayfasına yönlendiren "🔒 Planı Yükselt" bağlantısı gösterilir.

Paylaşılan hesap/işbirliği görünümü. Bu sayfayı geçiş yaptığınız veya sizinle paylaşılan bir hesap bağlamında görüntülüyorsanız (yukarıdaki Hesap menüsüne bakın), tablo ayrıca o hesaba özel izinlerinizi alır (/rights/user-permissions üzerinden) ve her satırdaki Düzenle/Sil/Çoğalt işlemlerinin kullanılabilirliğini bu izinlere göre belirler. Örneğin, kaynak sahibinin size verdiği yetkilere bağlı olarak uygulamaları görüntüleyip düzenleyebilir, ancak silemeyebilirsiniz.

Yeni Uygulama Ekleme

+ Uygulama Oluştur düğmesine tıklamak, Uygulama formunu "oluşturma" modunda, ortalanmış ve dikey yerleşimli bir modal pencere olarak açar.

Alanlar:

• Simge — isteğe bağlıdır. Üstteki büyük kare yükleme alanında, bir dosya seçilene kadar "Görsel Yükle" yazar; JPEG, PNG ve GIF türleri kabul edilir.
• Mağaza — zorunlu tek seçim alanı: Apple App Store, Google Play veya Amazon App Store (seçenekler backend'den dinamik olarak yüklenir; çağrı başarısız olursa bu üç seçenek kullanılır).
• Ad — zorunludur, 4–70 karakter olmalıdır.
• Paket / Bundle Kimliği — zorunludur, com. ile başlamalıdır (com.* desenine göre doğrulanır).
• URL — oluşturma sırasında zorunludur. Mağaza olarak Google Play seçildiğinde https://play.google.com/store/apps/details?id={package} otomatik doldurulur; Apple App Store seçildiğinde ise temel adres olan https://apps.apple.com/ otomatik doldurulur. Otomatik doldurma sonrasında URL'yi elle düzenleyebilirsiniz. Google Play seçiliyken paketi değiştirirseniz otomatik doldurulan URL de buna göre güncellenir.
• Marka — mevcut Markalarınızı içeren bir açılır liste.

Form gönderildiğinde uygulama oluşturma uç noktası çağrılır; uygulama, hiçbir reklam arabuluculuk (mediation) ağı veya reklam birimi yapılandırılmadan oluşturulur. Bunları daha sonra Uygulama Ayrıntıları içinde yapılandırırsınız. İptal düğmesine tıklamak, modal pencereyi kaydetmeden kapatır.

Uygulama Düzenleme veya Çoğaltma (hızlı modal pencere)

Bir satırın İşlemler menüsünden Düzenle seçildiğinde aynı form bileşeni "düzenleme" modunda açılır. Ancak dikey oluşturma düzeni yerine tek ve kompakt bir yatay satır kullanılır: simge (değiştirmek için üzerinde küçük bir kalem düğmesi bulunur), Ad, salt okunur Paket alanı, salt okunur URL alanı, Marka açılır listesi ve Kaydet düğmesi. Uygulama oluşturulduktan sonra Paket ve URL alanları kalıcı olarak salt okunur hâle gelir (oluşturma sonrasında uygulamanın paket kimliğini veya mağaza URL'sini değiştiremezsiniz; yalnızca adını, simgesini ve markasını değiştirebilirsiniz). Bu satırın kullanılabilirliği canUpdate izin denetimiyle belirlenir; paylaşılan hesap/işbirliği bağlamında bu izin, size verilen Uygulama Bilgileri yetkilerinden gelir.

Çoğalt seçildiğinde, oluşturma modundaki formun kaynak uygulamadan önceden doldurulmuş ikinci bir kopyası açılır. Orijinaliyle çakışmaması için paket adının sonuna .copy eklenir. Ardından istediğiniz alanları (ad, simge, marka) düzenleyip tamamen yeni bir uygulama olarak kaydedebilirsiniz. Arabuluculuk, reklam birimleri ve diğer tüm Uygulama Ayrıntıları ayarları kopyalanmaz; çoğaltılan uygulama, yeni oluşturulmuş bir uygulama gibi sıfırdan başlar.

Uygulama Ayrıntıları

Bir uygulamayı açmak (Uygulamalarım → Düzenle yoluyla veya doğrudan uygulama satırına tıklayarak) sizi Uygulama Ayrıntıları sayfasına götürür. Bu, Portalın en kapsamlı sayfasıdır ve uygulamanın SDK davranışı burada yapılandırılır.

Canlı ve Geliştirme modları. Sayfanın üstündeki anahtar, sayfanın tamamını Canlı ve Geliştirme yapılandırmaları arasında geçirir. Aşağıdaki tüm bölümler — Arabuluculuk, Reklam Birimleri, Yer Tutucular, Görüntüleme Seçenekleri, MMP, Özellik Tanıtımı, Ayarlar — her mod için ayrı ayrı yapılandırılır. Böylece yayınlanmış uygulamanızın mevcut canlı davranışını etkilemeden değişiklikleri Geliştirme modunda hazırlayıp test edebilirsiniz. Canlı yapılandırmayı geliştirmeye uygula ve Geliştirme yapılandırmasını canlıya uygula düğmeleri, bir modun tüm yapılandırmasını tek işlemle diğerinin üzerine kopyalamanızı sağlar (test edilmiş bir Geliştirme yapılandırmasını Canlıya taşımak veya yeni bir şeyi test etmeden önce Geliştirmeyi Canlı ile eşleşecek şekilde sıfırlamak için kullanışlıdır).

Sayfa başlığında ayrıca uygulamanın mevcut Yapılandırma Sürümü numarası, Değişiklik Geçmişi bağlantısı (aşağıya bakın) ve Yapılandırmayı Al düğmesi (aşağıya bakın) gösterilir. Yapılandırma arayüzünün bazı kısımları (ve aşağıda belirtilen Bölge Grupları seçicisi), yalnızca uygulamanın bildirdiği SDK sürümü belirli eşikleri karşıladığında görünür. Portal, bazı yeni özellikler için minimum SDK sürümü koşulu uygular; böylece eski uygulama derlemeleri, aslında kullanamayacakları seçenekleri görmez.

Sayfanın geri kalanı, aşağıdaki sırayla genişletilebilir bölümler hâlinde düzenlenmiştir:

Uygulama Bilgileri

Uygulamanın temel kimlik bilgileri: ad, paket/bundle kimliği, mağaza, simge ve marka ataması. Bunlar, kolaylık sağlamak için burada da sunulan ve esasen Uygulama oluşturma/düzenleme formuyla aynı olan alanlardır.

Arabuluculuk Ağı Seçimi

Bu uygulama/mod için kullanılacak arabuluculuk ağını seçin (örneğin, waterfall modelini kullanan bir ağ veya AppLovin MAX). Bu seçim bir ön koşuldur: burada bir arabuluculuk ağı seçilene kadar aşağıdaki Reklam Birimleri, Reklam Yer Tutucuları ve Yer Tutucular için Reklam Birimleri bölümleri kilitli kalır. Çünkü bu bölümlerin, hangi ağın SDK'sını ve reklam birimi biçimini yapılandırdığınızı bilmesi gerekir.

Reklam Birimleri Ekleme

Arabuluculuk ağınızın sağladığı reklam birimi kimliklerini, reklam biçimine göre düzenlenmiş sekmelere girin: Uygulama Açılışı (App Open), Geçiş (Interstitial), Banner, Yerel (Native) ve Ödüllü (Rewarded). Yalnızca yukarıda seçilen arabuluculuk ağının desteklediği biçimler sekme olarak görünür.

Reklam Yer Tutucuları

Adlandırılmış yer tutucular tanımlayın: bunlar, uygulamanızda veya oyununuzda reklam gösterilebilecek mantıksal alanlardır (örneğin, "Seviye Tamamlandı" veya "Ana Menü Banner'ı"). Yer tutucular, yeni öğeler ekleyebileceğiniz veya mevcut öğeleri yeniden adlandırabileceğiniz numaralı bir ızgara olarak sunulur. Yer tutucu adlarının genellikle uygulamanızın kaynak kodundaki sabitlerle eşleşmesi gerektiğinden Portal, tüm yer tutucu listesini Kotlin (.kt) enum dosyası olarak içe ve dışa aktarmayı destekler. Böylece kod tabanınız ile Portal yapılandırmanız, elle yeniden yazmaya gerek kalmadan senkronize tutulabilir.

Reklam Yer Tutucuları için Reklam Birimleri

Bir eşleme ızgarasıdır: bir eksende yer tutucular, diğerinde reklam biçimleri (Geçiş / Banner / Yerel / Ödüllü) bulunur. Her kombinasyon için, yukarıda eklenen reklam birimlerinden hangisinin ilgili yer tutucuda reklam sunacağını seçersiniz.

Önemli bir nokta: Çapraz Tanıtım da bu ızgarada gerçek reklam ağı birimlerinizin yanında seçilebilir bir seçenek olarak görünür. Bir yer tutucu için bu seçeneği belirlemek, o alanda ücretli bir ağ reklamı gösterilmeyeceği anlamına gelir. Bunun yerine, Kampanyalar altında yapılandırıldığı şekilde diğer uygulamalarınızdan birine ait çapraz tanıtım kreatifi gösterilir. Kampanyalar özelliğini uygulamalarınızdaki gerçek reklam yerleşimlerine bağlayan mekanizma budur.

Reklam Görüntüleme Seçenekleri

Her reklam biçimi için yükleme sırasındaki kullanıcı deneyimini kontrol edin: reklam getirilirken yükleme iletişim kutusu veya shimmer animasyonu gösterilip gösterilmeyeceğini ve vazgeçmeden önce ne kadar bekleneceğini belirleyen zaman aşımını ayarlayın. Geçiş reklamları, basit görüntüleme zamanlamasının ötesinde ek tetikleme seçenekleri sunar: tıklamada, belirli bir süre aralığından sonra, bu ikisinin birleşimiyle veya uygulama içi sahne geçişlerine göre tetiklenmelerini seçebilirsiniz. Her tetikleme modu, kendine özgü ayarlanabilir parametreler sunar (örneğin, süre aralığı veya tıklama sayısı).

Uygulama Yer Tutucuları için Ödeme Duvarları

Ödeme Duvarı Şablonlarınızdan birini (Ödeme Duvarı Şablonları özelliği altında tasarlanır; bu kılavuzun ilerleyen kısmındaki Ödeme Duvarları bölümüne bakın) doğrudan bu uygulamanın yer tutucularıyla eşleyin. Böylece SDK, uygulamanız bir ödeme duvarı istediğinde hangisini göstereceğini bilir.

Üst düzeydeki Etkin anahtarı, bu uygulama için özelliğin tamamını açar veya kapatır. Etkinleştirildiğinde her satır, bir ödeme duvarını gösterilmesi gereken Uygulama Yer Tutucularıyla (daha önce Reklam Yer Tutucuları altında tanımlanan) eşler: ödeme duvarını adıyla arayın, ardından + Yer tutucu ekle seçeneğiyle bir veya daha fazla yer tutucu bağlayın. Bağlanan her yer tutucu, küçük bir sayı rozeti içeren kaldırılabilir bir etiket olarak görünür. Bir yer tutucu aynı anda yalnızca bir ödeme duvarıyla eşlenebilir; başka bir ödeme duvarına atandığında önceki ödeme duvarından otomatik olarak kaldırılır.

Uygulama Ayrıntılarının geri kalanından farklı olarak bu eşleme, sayfanın üstünde seçili olan Canlı/Geliştirme moduna kesin olarak bağlı değildir. Cihaza yüklenmiş gerçek bir uygulamanın kendine ait "Canlı" veya "Geliştirme" kimliği yoktur; bu ayrım yalnızca yönetim tarafında değişiklikleri hazırlamayı kolaylaştırır. Dolayısıyla bir ödeme duvarını herhangi bir modda bir yer tutucuyla eşleyip kaydettiğinizde, bu eşleme gerçek cihazlarda çözümlenebilir. Eşlemenin üretim ortamına ulaşması için aynı işlemi diğer modda ikinci kez yapmanız gerekmez.

MMP Seçimi

Bir Mobil Ölçüm İş Ortağı (MMP) bağlayın. Seçenekler arasında Adjust, AppsFlyer, Firebase, Cost Center ve Solar Engine bulunur. Reklam geliri raporlamasını her reklam biçimi için ayrı ayrı açıp kapatın; böylece reklam geliri olayları, diğer yükleme ve etkileşim verilerinizle birlikte ilişkilendirme/analitik altyapınıza aktarılır.

Özellik Tanıtımı

Reklam ağlarıyla ilgisi olmayan uygulama içi tanıtım banner'ları veya kartları yapılandırın. Örneğin, kendi uygulamanızın arayüzünde "yeni bir özelliği duyurmak" veya "premium paketi çapraz satışla tanıtmak" için kullanabilirsiniz. Düzenlenebilir bu tablodaki her kaydın bir başlığı, türü, anahtarı, görseli ve kullanıcı dokunduğunda tetiklenen bir işlemi (derin bağlantı veya uygulama içi gezinme hedefi gibi) vardır.

Ayarlar

Diğer bölümlere uymayan çeşitli uygulama düzeyi ayarlar: hata ayıklama için konsol günlüklerini etkinleştirme, reklam olaylarının günlüğe kaydedilmesini etkinleştirme, yerel bildirimler için izin verilen zaman farkı toleransı ve uygulamanın Gizlilik Politikası ile Hizmet Koşulları URL'leri (bazı reklam ağları ve uygulama mağazaları bunları kullanıcıya sunmanızı gerektirir).

Yapılandırmayı Alma

Yapılandırmayı Al düğmesine tıklamak, o anda etkin olan mod (Canlı veya Geliştirme) için yukarıda yapılandırdığınız her şeyi temsil eden şifrelenmiş bir yapılandırma dizesi oluşturur. Uygulama Ayrıntıları başlığındaki bölge seçicisinde bir Bölge Grubu seçiliyse, oluşturulan bağlantı/dize bu grubun kimliğini de sorgu parametresi olarak taşır. Böylece çalışma zamanında alınan yapılandırma bölge grubuna göre değişebilir. Portal ayrıca bu dizeyi Firebase Remote Config üzerinden AKS_AND_LIVE parametre anahtarı altında yayınlamanız için size yol gösterir. Canlı uygulamanız yapılandırmayı çalışma zamanında bu şekilde alır; Portalın kendisi, yapılandırmayı doğrudan son kullanıcı cihazlarına göndermez.

Değişiklik Geçmişi

Bir uygulamanın yapılandırması her kaydedildiğinde yeni bir Yapılandırma Sürümü kaydedilir. Değişiklik Geçmişi (Uygulama Ayrıntılarındaki bağlantıdan erişilen ayrı bir sayfa), uygulamanın tüm sürümlerini tablo olarak listeler: sıra numarası, Yapılandırma Sürümü, değişikliklerin Açıklaması (uzun açıklamalar dahili olarak dikey çizgiyle ayrılır ve ayrı satırlar hâlinde gösterilir; ilk 20 karakterden sonrası "Daha Fazla Göster / Daha Az Göster" seçeneğiyle kısaltılır), Güncelleme Tarihi ve Güncelleyen. Üstteki tarih aralığı filtresi, listeyi belirli bir dönemle sınırlar. Böylece uygulama yapılandırmasını kimin, ne zaman değiştirdiğine dair temel bir denetim kaydı elde edersiniz.

Benimle Paylaşılanlar

Başka bir ekip sizi uygulamalarında işbirliği yapmaya davet etmiş ve siz de kabul etmişseniz, bu paylaşılan kaynaklar Benimle Paylaşılanlar (/SharedWithMe) altında görünür. Bu bölüm, kendi ekibinizin sahip olduğu uygulamalardan ayrı olarak aldığınız davetleri içeren bir tablodur. Her satırda davet eden kişi ve davetin mevcut durumu gösterilir.

Buradan bekleyen bir daveti Kabul Et veya Reddet seçenekleriyle yanıtlayabilirsiniz. Her iki işlem de uygun kararı ileterek aynı davet işleme uç noktasını çağırır. Kabul ettikten sonra davet eden kişi, hesap değiştirme açılır listenizde (yukarıda açıklanmıştır) görünür; böylece onun hesabına geçip size verilen izinler kapsamında çalışabilirsiniz.

Bu sayfaya ?invitationId= sorgu parametresi içeren bir bildirim bağlantısıyla gelirseniz, satırı kendiniz bulmanıza gerek kalmadan Davet İletişim Kutusu sayfa yüklenirken otomatik olarak açılır.

Davet İletişim Kutusu. Bu modal pencerenin üst kısmında, davet eden hesabın e-posta adresi bir etiket içinde gösterilir. Ayrıca duruma bağlı bir başlık/simge bulunur: bekleyen davet için hediye simgesi, daha önce kabul ettiğiniz davet için onay işareti, reddedilen davet için X ve süresi dolan davet için saat. Bunun altında kaydırılabilir bir "N Kaynağa Erişim" listesi yer alır. Her satırda uygulama simgesi için bir yer tutucu, kaynak adı (örneğin, temel izin anahtarından biçimlendirilen "Uygulamalar", "Uygulama Bilgileri") ve kaynak üzerinde hangi yetkilere sahip olacağınızı gösteren sağa hizalı rozetler (Okuma / Oluşturma / Güncelleme / Silme) bulunur. Davetin bir son geçerlilik tarihi varsa bu tarih bir uyarı satırında gösterilir.

Alt kısımdaki düğmeler duruma göre değişir: bekleyen bir davette "Şimdi Değil" ve "✓ Daveti Kabul Et" gösterilir. Daha önce yanıtlanmış veya süresi dolmuş bir davette ise yalnızca "Kapat" düğmesi ve açıklayıcı bir metin gösterilir (süresi dolmuş bir davet için örneğin "Lütfen {davet edenin e-posta adresi} adresinden yeni bir davet göndermesini isteyin").

---