Geçiş planınız 5 mantıksal adımdan oluşur ve ortalama 2 saat sürer. Geçişlerin %90’ı bir iş gününden kısa sürer.

1. Temel farklılıkları öğrenin; Adapty hesabı oluşturun ve hazırlayın (5 dakika);
2. RevenueCat SDK yerine platformunuz için Adapty SDK’yı yükleyin (iOS, Android, React Native, Flutter, Kotlin Multiplatform, Unity) (1 saat);
3. Adapty’ye Apple App Store sunucu bildirimleri kurun ve isteğe bağlı olarak ham olay iletmeyi etkinleştirin (5 dakika);
4. Uygulamanızın güncellemelerini test edin ve yayınlayın (30 dakika);
5. (İsteğe bağlı) RevenueCat desteğinden geçmiş verileri CSV formatında isteyin (5 dakika);
6. (İsteğe bağlı) Adapty desteği aracılığıyla geçmiş verileri içe aktarın (30 dakika).

Adapty SDK içeren uygulamanızın yeni sürümünü yayınlamadan önce yayın kontrol listemizi gözden geçirdiğinizden emin olun.

Temel farklılıkları öğrenin; Adapty hesabı oluşturun ve hazırlayın

Adapty ve RevenueCat SDK’ları benzer şekilde tasarlanmıştır. En büyük fark ağ kullanımı ve hızdır: Adapty SDK, talep ettiğinizde bilgileri olabildiğince hızlı sunmak için tasarlanmıştır. Örneğin bir paywall talep ettiğinizde, onboarding veya paywallınızı önceden oluşturmak için önce remote config gelir, ardından ürünler ayrı bir istekle alınır.

İsimlendirme biraz farklıdır:

RevenueCat	Adapty
Package	Product
Offering	Paywall
Paywall	Paywall Builder
Entitlement	Access level

Adapty’de placement kavramı vardır. Placement, uygulamanızda kullanıcının satın alma yapabileceği mantıksal bir yerdir. Çoğu durumda bir ya da iki placement’ınız olur:

• Onboarding (tüm satın almaların %80’i burada gerçekleşir);
• Genel (onboarding sonrası ayarlarda veya uygulama içinde gösterilen).

Adapty SDK’yı yükleyin ve RevenueCat SDK’yı değiştirin

Uygulamanıza platformunuz için Adapty SDK’yı yükleyin (iOS, Android, React Native, Flutter, Kotlin Multiplatform, Unity).

Uygulama tarafında birkaç SDK metodunu değiştirmeniz gerekecek. En yaygın fonksiyonlara ve bunları Adapty SDK metodlarıyla nasıl değiştireceğinize bakalım.

SDK aktivasyonu

Purchases.configure yerine Adapty.activate kullanın.

Paywall alma (offering’ler)

Purchases.shared.getOfferings yerine Adapty.getPaywall kullanın.

Adapty’de paywallı her zaman placement id üzerinden talep edersiniz. Pratikte en fazla 1-2 paywall çektiğinizden, bu yapıyı SDK’yı hızlandırmak ve ağ kullanımını azaltmak amacıyla bilerek böyle tasarladık.

Kullanıcı (müşteri profili) alma

Purchases.shared.getCustomerInfo yerine Adapty.getProfile kullanın.

Ürün alma

RevenueCat’te şu yapıyı kullanırsınız: Purchases.shared.getOfferings ve ardından self.offering?.availablePackages.

Adapty’de önce bir paywall talep edersiniz (yukarıya bakın) — bu sayede Adapty’nin remote config’una anında erişirsiniz — ardından Adapty.getPaywallProducts ile ürünleri alırsınız.

Satın alma yapma

Purchases.shared.purchase yerine Adapty.makePurchase kullanın.

Access level (entitlement) kontrolü

Müşteri profilini alın (önce yukarıyı okuyun) ve ardından şunu değiştirin:

customerInfo?.entitlements["premium"]?.isActive == true

şununla:

profile.accessLevels["premium"]?.isActive == true.

Satın alma geri yükleme

Purchases.shared.restorePurchases yerine Adapty.restorePurchases kullanın.

Kullanıcının giriş yapıp yapmadığını kontrol etme

Purchases.shared.isAnonymous yerine if profile.customerUserId == nil kullanın.

Kullanıcı girişi

Purchases.shared.logIn yerine Adapty.identify kullanın.

Kullanıcı çıkışı

Purchases.shared.logOut yerine Adapty.logout kullanın.

App Store sunucu tarafı bildirimlerini Adapty’ye geçirin

Bunu nasıl yapacağınızı buradan okuyun.

Uygulamanızın yeni sürümünü test edin ve yayınlayın

Buradasanız şunları yapmışsınızdır:

• Adapty Kontrol Panelini yapılandırdınız
• Adapty SDK’yı yüklediniz
• SDK mantığını Adapty fonksiyonlarıyla değiştirdiniz
• App Store sunucu tarafı bildirimlerini Adapty’ye geçirdiniz ve isteğe bağlı olarak RevenueCat’e ham olay iletmeyi etkinleştirdiniz
• Sandbox satın alması yaptınız
• Yeni bir uygulama sürümü yayınladınız

Yukarıdaki maddeleri işaretlediyseniz, Sandbox’ta bir test satın alması yapın ve uygulamayı yayınlayın.

(İsteğe bağlı) RevenueCat geçmiş verilerinizi CSV formatında dışa aktarın

RevenueCat’ten geçmiş verilerinizi CSV formatında RevenueCat’in resmi belgelerindeki talimatları izleyerek dışa aktarın.

(İsteğe bağlı) RevenueCat desteğinden Google Purchase Token’larını isteyin

Google Play işlemlerini içe aktarmanız gerekiyorsa, destek sayfaları üzerinden RevenueCat desteğiyle iletişime geçerek Google Purchase Token’larını içeren bir CSV dosyası talep edin. Google Purchase Token, Google Play’in her işlem için sağladığı benzersiz bir tanımlayıcıdır ve Adapty’de satın almaların doğru şekilde takip edilip doğrulanması için gereklidir. Bu bilgi standart dışa aktarma dosyasına dahil değildir. Dosya şu üç sütunu içerir:

• user_id
• google_purchase_token
• google_product_id

Geçmiş verilerinizi aktarmak için bize yazın

Web sitesi mesajlaşma aracı üzerinden veya CSV dosyalarınızla birlikte [email protected] adresine e-posta göndererek bizimle iletişime geçin.

1. RevenueCat’ten dışa aktardığınız CSV dosyasını doğrudan destek ekibimize gönderin.
2. Google Play işlemlerini içe aktarıyorsanız, RevenueCat desteğinden aldığınız Google Purchase Token’larını içeren CSV dosyasını da ekleyin.
3. Customer User ID olarak (Adapty’nin birincil kullanıcı tanımlayıcısı) hangi kullanıcı ID’sinin kullanılması gerektiğini belirtin: rc_original_app_user_id mi yoksa rc_last_seen_app_user_id_alias mi.

Destek Ekibimiz işlemlerinizi Adapty’ye aktaracaktır. Her işlem için aşağıdaki veriler Adapty’ye aktarılır:

Parametre	Açıklama
user_id	Customer User ID, Adapty’deki ve sisteminizde kullanıcınızın ana tanımlayıcısı.
apple_original_transaction_id	Abonelik zincirleri için bu, store_original_transaction_id ile bağlantılı orijinal işlemin satın alma tarihidir.
google_product_id	Google Play Store’daki ürün ID’si.
google_purchase_token	Google Play’in her işlem için sağladığı, doğrulama için gerekli benzersiz tanımlayıcı.
country	Kullanıcının ülkesi.
created_at	Kullanıcının oluşturulma tarihi ve saati.
subscription_expiration_date	Aboneliğin sona erme tarihi ve saati.
email	Son kullanıcının e-posta adresi.
phone_number	Son kullanıcının telefon numarası.
idfa	Apple’ın bir kullanıcının cihazına atadığı Reklamverenler için Tanımlayıcı (IDFA).
idfv	Bir geliştirici tarafından tüm uygulamalara atanan ve o uygulamalar arasında cihazda paylaşılan Satıcılar için Tanımlayıcı (IDFV).
advertising_id	Reklamcıların takip amacıyla kullanabileceği, Android işletim sistemi tarafından sağlanan benzersiz tanımlayıcı.
attribution_channel	Pazarlama kanalı adı.
attribution_campaign	Pazarlama kampanyası adı.
attribution_ad_group	Attribution reklam grubu.
attribution_ad_set	Attribution reklam seti.
attribution_creative	Attribution kreatif anahtar kelimesi.

Bunlara ek olarak, şu entegrasyonlara ait entegrasyon tanımlayıcıları da içe aktarılacaktır: Amplitude, Mixpanel, AppsFlyer, Adjust ve FacebookAds.

SSS

Adapty SDK’yı başarıyla yükledim ve yeni bir uygulama sürümü yayınladım. Adapty SDK’lı sürüme geçmeyen eski abonelerime ne olacak?

Kullanıcıların büyük çoğunluğu telefonlarını geceleri şarj eder; App Store da genellikle tüm uygulamaları bu sırada otomatik olarak günceller, dolayısıyla bu bir sorun olmamalıdır. Güncelleme yapmayan küçük bir ücretli abone grubu olabilir, ancak bu kullanıcılar premium içeriğe erişmeye devam eder. Onları güncellemeye zorlamanıza gerek yok.

RevenueCat’teki geçmiş verilerimi mümkün olduğunca hızlı dışa aktarmam mı gerekiyor, yoksa kaybeder miyim?

Çok acele etmenize gerek yok; önce Adapty SDK ile bir sürüm yayınlayın, ardından geçmiş verilerinizi bize iletin. Kullanıcılarınızın ödeme geçmişini geri yükleyip profiller ve grafikler bölümlerini dolduracağız.

MMP (AppsFlyer, Adjust vb.) ve analitik (Mixpanel, Amplitude vb.) kullanıyorum. Her şeyin düzgün çalışacağından nasıl emin olabilirim?

Öncelikle SDK’mız aracılığıyla veri göndermek istediğiniz üçüncü taraf hizmetlerinin ID’lerini bize iletmeniz gerekir. Attribution entegrasyonu ve analitik entegrasyonu kılavuzlarını okuyun. Geçmiş veriler ve eski kullanıcılar için RevenueCat’ten dışa aktardığınız verilerdeki bu ID’leri bize aktardığınızdan emin olun.