Adapty verileri mağazalarla nasıl senkronize eder
Adapty, App Store ve Google Play ile ürün verisi alışverişi yapar; ancak bu alışveriş ne süreklidir ne de eksiksizdir. Değerlerin büyük çoğunluğu yalnızca siz harekete geçtiğinizde güncellenir — bir ürünü mağazalara gönderdiğinizde veya yeni fiyatlar yüklediğinizde. Bazı değerler ise hiçbir zaman senkronize edilmez; bu nedenle Adapty ile mağaza aynı ürün için farklı fiyatlar gösterebilir.
Adapty mağazalardan neler okur
Adapty, mağazadan ürün listelerini, temel planları, fiyatları ve işlemleri okur. Bir ürünü veya fiyatı değiştirmek için bunu mağaza konsolunda yapın. Adapty’nin tuttuğu ülkeye özgü fiyatları görmek için Ürünü düzenle sayfasından fiyat CSV’sini indirin.
| Adapty’nin okuduğu | Nasıl ulaşır (App Store) | Nasıl ulaşır (Google Play) |
|---|---|---|
| Ürün listesi ve inceleme durumu | App Store Connect API anahtarı aracılığıyla | Hizmet hesabı aracılığıyla |
| Temel planlar | Geçerli değil | Abonelik ürününün parçası |
| Ülkeye özgü fiyatlar | Bir mağaza ürünü bağladığınızda veya düzenlediğinizde | Bir mağaza ürünü bağladığınızda veya düzenlediğinizde |
| İşlemler, yenilemeler ve iadeler | App Store sunucu bildirimleri aracılığıyla | Gerçek zamanlı geliştirici bildirimleri aracılığıyla |
| Müşterinin ödediği fiyat | Her işlemle birlikte | Her işlemle birlikte |
Adapty’nin mağazalara yazdıkları
Ürünler, fiyatlar ve başlangıç deneme süreleri Adapty’de oluşturulur ve bir işlem yaptığınızda mağazaya iletilir; bu işlem hiçbir zaman otomatik bir zamanlamaya göre gerçekleşmez.
| Adapty’nin yazdığı | App Store’a ne zaman ulaşır | Google Play’e ne zaman ulaşır |
|---|---|---|
| Yeni ürünler | Bir ürünü mağazalara gönderdiğinizde | Bir ürünü mağazalara gönderdiğinizde |
| Ülkeye özel fiyatlar | Fiyat CSV’sini yüklediğinizde | Fiyat CSV’sini yüklediğinizde |
| Başlangıç ücretsiz denemesi | Yeni bir ürün gönderdiğinizde | Hiçbir zaman — bunun yerine Google Play Console’da oluşturun |
Adapty, CSV dosyanızı mevcut mağaza fiyatlarıyla karşılaştırır ve yalnızca farklı olan fiyatları günceller; bu nedenle tüm dosyayı güvenle yükleyebilirsiniz. Mevcut aboneler, Apply to existing subscribers seçeneğini işaretlemediğiniz sürece kayıt olduklarındaki fiyatı korur.
Yalnızca Adapty’de ayarladıklarınız
Bu ayarların hiçbirini mağaza değiştirmez.
| Öğe | Neden Adapty’de kalır |
|---|---|
| Bağladığınız bir mağaza ürününün fiyatı | Oluşturma sırasında sabit bir yer tutucudur. Ürünleri birbirinden ayırt etmenize yardımcı olur ancak mağazaya hiçbir zaman ulaşmaz. Analizler, entegrasyonlar ve SDK mağazanın gerçek fiyatlarını kullanır. |
| Access level’lar | Adapty, ücretli içeriğinize erişim sağlar. Mağazaların bunun karşılığı yoktur. |
| Promosyon teklifi ve geri kazanma teklifi ID’leri | Adapty, satın almayı imzalamak için ID’ye ihtiyaç duyar. Teklifi kendiniz mağaza konsolunda oluşturursunuz. |
Cihazda neler olur
Müşterinin paywall’da gördüğü fiyat, paywall açıldığında StoreKit veya Google Play Billing’den gelir; Adapty’den değil. Mağaza konsolunda değiştirdiğiniz bir fiyat, mağaza yayınladığı anda müşterilerinize ulaşır. Uygulama güncellemesi yapmanıza gerek yoktur ve Adapty’de herhangi bir şeyi değiştirmenize de gerek yoktur.
Öte yandan, Adapty SDK’sı her satın almayı fiyat, para birimi ve ülke bilgisiyle birlikte Adapty’ye gönderir. Adapty bu değerleri müşterinin kendi para biriminde geliri kaydetmek için kullanır.
Stripe, Paddle ve özel mağazalar
Stripe ve Paddle entegrasyonları, ürün kataloğunuzu değil işlemleri taşır. Satın almalar, sağlayıcının webhook’u aracılığıyla ya da özel mağazalar için kendi backend’inizden Adapty’ye ulaşır. Her ürün ve fiyat ID’sini elle eklemeniz gerekir. Adapty’de bulunmayan bir ID hiçbir şeyle eşleşmez; bu nedenle ilgili işlemler ve gelirler hiçbir zaman görünmez. Stripe ve Paddle’da ise ürün mevcut olsa bile Subscription duration ayarı eksikse aynı sorun yaşanır. Her iki durumu da işaretleyen bir uyarı yoktur; bu yüzden sattığınız her ürün için bir ID ve süre eklediğinizden emin olun.
Ürün ve fiyat tutarsızlıkları
Adapty ile mağaza konsolu arasındaki bazı farklılıklar tasarım gereğidir ve müşterilerinizin ödediği tutarı değiştirmez. Diğerleri ise gelirin kaydedilmediği anlamına gelir.
| Ne görüyorsunuz | Olası nedenler | Ne yapmalısınız |
|---|---|---|
| Adapty’deki fiyat mağaza fiyatından farklı | Products ekranı, ürünü oluştururken girdiğiniz fiyatı gösterir. Ürünü mağazalara gönderdiyseniz Adapty bu fiyatı başlangıç fiyatı olarak kullandı. Sonradan değiştiremezsiniz; mağazalar fiyatın sahibi olduktan sonra ikisi birbirinden ayrışır. Müşterilerin şu an ödediği fiyatlar ülkeye özel fiyatlardır. | Bir şey yapmanıza gerek yok. Müşterilerinizden mağaza fiyatı tahsil edilir; gelir raporları da fiilen ödenen tutarı kullanır. Ödedikleri tutarı değiştirmek için her mağazanın konsolunda fiyatı düzenleyin ya da her iki mağazayı aynı anda güncellemek için fiyat CSV’si yükleyin. |
| Ürününüz ürün açılır listesinde görünmüyor | Üç olası neden var: Çalışmayı durduran mağaza kimlik bilgileri boş bir liste döndürür. Son 10 dakikada oluşturulan bir ürün henüz Adapty’nin App Store listesinin önbelleğe alınmış kopyasına ulaşmamış olabilir. Seçili Subscription duration listeyi filtreler: Lifetime, Non-Subscriptions ve Consumables tek seferlik ürünleri gösterirken diğer tüm değerler abonelikleri gösterir. | Subscription duration değerini ürünün mağazadaki türüyle eşleşecek şekilde ayarlayın. Ürünü birkaç dakika önce oluşturduysanız kısa süre sonra tekrar deneyin. Aksi takdirde mağaza kimlik bilgilerini doğrulayın. |
| Bir başlangıç teklifi Adapty’de görünmüyor | Adapty, başlangıç teklifini yalnızca mağazaya yeni bir ürün gönderdiğinizde oluşturur ve yalnızca kendisinin oluşturduğu teklifleri listeler. Mağaza konsolunda kendiniz oluşturduğunuz bir teklif Edit product penceresinde hiçbir zaman görünmez. | Bir şey yapmanıza gerek yok. Başlangıç teklifleri, müşteri uygun olduğunda otomatik olarak uygulanır; Adapty’ye eklenmelerine gerek yoktur. |
| Satın almada indirim uygulanmadı | Müşteri koşulları karşılamıyor olabilir — bu karar mağaza tarafından verilir, Adapty tarafından değil. Bunun yanı sıra, Adapty In-App Purchase Key ile imzalayamadığı için bir App Store promosyon teklifi uygulanmamış olabilir. | Anahtarın yüklendiğini ve geçerli olduğunu doğrulayın, ardından mağazadaki teklifin koşullarını inceleyin. |
| Fiyat değişikliğinden sonra Stripe işlemleri görünmeyi bıraktı | Stripe’ta fiyat değiştirmek yeni bir price_id oluşturur; Adapty ise olayları tam product_id + price_id çiftiyle eşleştirir. Yeni fiyata ait olaylar hiçbir şeyle eşleşmez, Stripe ise webhook’u teslim edilmiş olarak raporlamaya devam eder. | Adapty’deki ürüne yeni price_id’yi ekleyin — bunu yapana kadar gelir kaydedilmez. Bkz. Stripe. |
| Bir müşteri ürün satın aldı ama access level almadı | Satın aldıkları mağaza ürün kimliği, Adapty’deki herhangi bir ürünle bağlantılı değil. Adapty, satın almayı otomatik olarak oluşturduğu bir ürün satırına kaydeder; bu satırın access level’ı yoktur. | Ürünü tam mağaza ürün kimliğiyle Adapty’de oluşturun ve bir access level atayın. |
| Güncellemeler artık gelmiyor | Mağaza kimlik bilgilerinizden biri çalışmayı durdurdu. Her biri alışverişin farklı bir bölümünü yönetir. | Duran kısmı bulun ve yalnızca o kimlik bilgisini değiştirin — bkz. Güncellemeler gelmeyi durdurursa. |
Güncellemeler gelmeyi durursa
Adapty, çalışmayı durduran kimlik bilgilerini işaretlemez. Her kimlik bilgisi alışverişin bir bölümünden sorumludur, bu yüzden belirti size hangisini yenilemeniz gerektiğini söyler.
| Ne durdu | Değiştirilecek credential |
|---|---|
| Ürün listesi, inceleme durumları veya ürün ve fiyatların mağazaya gönderilmesi | App Store: App Store Connect API anahtarı. Google Play: hizmet hesabı anahtar dosyası. |
| Yeni işlemler, yenilemeler ve iadeler | App Store: sunucu bildirimleri. Google Play: gerçek zamanlı geliştirici bildirimleri. |
| Satın alma sırasında promosyon teklifleri | App Store: Uygulama İçi Satın Alma Anahtarı. |
| Her müşteri için satın alma doğrulaması | App Store: paylaşılan gizli anahtar. Google Play: hizmet hesabı anahtar dosyası. |
Mağaza konsolunda bir kimlik bilgisini değiştirmek, Adapty’deki kaydı güncellemez. Yeni kimlik bilgisini App settings bölümüne yükleyin.