Adapty SDK, React Native uygulamanıza sorunsuz entegrasyon için iki temel modül içerir:

• Core Adapty: Bu modül, Adapty’nin uygulamanızda düzgün çalışması için zorunludur.
• AdaptyUI: Bu modül, platformlar arası paywall’lar oluşturmak için kullanılan, kullanımı kolay, no-code araç olan Adapty Paywall Builder’ı kullanıyorsanız gereklidir. AdaptyUI, core modülüyle birlikte otomatik olarak etkinleştirilir.

React Native uygulamanızda uygulama içi satın alma (IAP) özelliğini nasıl hayata geçireceğinize dair tam bir rehber istiyorsanız buna göz atabilirsiniz.

Eksiksiz bir uygulama rehberi için şu videoyu da izleyebilirsiniz:

Gereksinimler

Adapty React Native SDK, iOS 13.0+ sürümünü destekler; ancak Adapty paywall builder ile oluşturulan paywallları kullanmak için iOS 15.0+ gereklidir.

Adapty SDK’yı Yükleme

1. Adapty SDK’yı yükleyin (@adapty/core da otomatik olarak yüklenir):

   npx expo install react-native-adapty
   npx expo prebuild

2. EAS veya yerel build kullanarak uygulamanızı geliştirme için derleyin:

   # iOS için
   eas build --profile development --platform ios
   
   # Android için
   eas build --profile development --platform android

   # iOS için
   npx expo run:ios
   
   # Android için
   npx expo run:android

3. Geliştirme sunucusunu başlatın:

   npx expo start --dev-client

Adapty SDK’nın Adapty modülünü etkinleştirin

Public SDK Key’inizi almak için:

1. Adapty Kontrol Paneli’ne gidin ve App settings → General sayfasına geçin.
2. Api keys bölümünden Public SDK Key’i kopyalayın (Secret Key’i değil).
3. Koddaki "YOUR_PUBLIC_SDK_KEY" ifadesini bununla değiştirin.

Adapty’yi etkinleştirmek için aşağıdaki kodu App.tsx dosyasına kopyalayın:

adapty.activate('YOUR_PUBLIC_SDK_KEY');

Şimdi uygulamanızda paywallları ayarlayın:

• Adapty Paywall Builder kullanıyorsanız, Paywall Builder hızlı başlangıç kılavuzunu inceleyin.
• Kendi paywall arayüzünüzü oluşturuyorsanız, özel paywall’lar için hızlı başlangıç kılavuzuna bakın.

Adapty SDK’nın AdaptyUI modülünü etkinleştirin

Paywall Builder kullanmayı planlıyorsanız AdaptyUI modülüne ihtiyacınız olacaktır. Core modülü etkinleştirdiğinizde otomatik olarak etkinleştirilir; başka bir şey yapmanıza gerek yoktur.

İsteğe bağlı kurulum

Günlükleme

Günlükleme sistemini ayarlayın

Adapty, neler olduğunu anlamanıza yardımcı olmak için hataları ve diğer önemli bilgileri kaydeder. Aşağıdaki günlük seviyeleri mevcuttur:

Level	Description
error	Yalnızca hatalar loglanır
warn	Hatalar ve SDK’dan gelen kritik hatalara yol açmayan ancak dikkat edilmesi gereken mesajlar loglanır
info	Hatalar, uyarılar ve çeşitli bilgi mesajları loglanır
verbose	Hata ayıklama sırasında işe yarayabilecek her türlü ek bilgi (fonksiyon çağrıları, API sorguları vb.) loglanır
Adapty yapılandırmasından önce veya yapılandırma sırasında uygulamanızda log seviyesini ayarlayabilirsiniz:

// Set log level before activation
// 'verbose' is recommended for development and the first production release
adapty.setLogLevel('verbose');

// Or set it during configuration
adapty.activate('YOUR_PUBLIC_SDK_KEY', {
  logLevel: 'verbose',
});

Veri politikaları

Adapty, siz açıkça göndermediğiniz sürece kullanıcılarınızın kişisel verilerini saklamaz. Ancak mağaza veya ülke yönergelerine uymak için ek veri güvenliği politikaları uygulayabilirsiniz.

IP adresi toplama ve paylaşımını devre dışı bırakma

Adapty modülünü etkinleştirirken, kullanıcı IP adresi toplama ve paylaşımını devre dışı bırakmak için ipAddressCollectionDisabled değerini true olarak ayarlayın. Varsayılan değer false’tur. Kullanıcı gizliliğini artırmak, bölgesel veri koruma yönetmeliklerine (GDPR veya CCPA gibi) uymak ya da IP tabanlı özelliklere ihtiyaç duymayan uygulamalarda gereksiz veri toplamayı azaltmak için bu parametreyi kullanın.

adapty.activate('YOUR_PUBLIC_SDK_KEY', {
  ipAddressCollectionDisabled: true,
});

Reklam kimliği toplama ve paylaşımını devre dışı bırakma

Adapty modülünü etkinleştirirken, reklam tanımlayıcılarının toplanmasını devre dışı bırakmak için iOS’ta ios.idfaCollectionDisabled veya Android’de android.adIdCollectionDisabled değerini true olarak ayarlayın. Varsayılan değer false’tur.

Bu parametreyi; App Store/Play Store politikalarına uymak, App Tracking Transparency iznini tetiklemekten kaçınmak ya da uygulamanız reklam kimliklerine dayalı attribution veya analitik gerektirmiyorsa kullanabilirsiniz.

adapty.activate('YOUR_PUBLIC_SDK_KEY', {
  ios: {
    idfaCollectionDisabled: true,
  },
  android: {
    adIdCollectionDisabled: true,
  },
});

AdaptyUI için medya önbelleği yapılandırmasını ayarlayın

AdaptyUI, performansı artırmak ve ağ kullanımını azaltmak için medyayı (görseller ve videolar gibi) varsayılan olarak önbelleğe alır. Özel bir yapılandırma sağlayarak önbellek ayarlarını özelleştirebilirsiniz.

Varsayılan önbellek ayarlarını geçersiz kılmak için mediaCache kullanın:

adapty.activate('YOUR_PUBLIC_SDK_KEY', {
  mediaCache: {
    memoryStorageTotalCostLimit: 200 * 1024 * 1024, // Optional: memory cache size in bytes
    memoryStorageCountLimit: 2147483647,            // Optional: max number of items in memory
    diskStorageSizeLimit: 200 * 1024 * 1024,       // Optional: disk cache size in bytes
  },
});

Parametre	Zorunlu	Açıklama
memoryStorageTotalCostLimit	isteğe bağlı	Bellekteki toplam önbellek boyutu (bayt cinsinden). Varsayılan değer platforma göre belirlenir.
memoryStorageCountLimit	isteğe bağlı	Bellek depolamasının öğe sayısı sınırı. Varsayılan değer platforma göre belirlenir.
diskStorageSizeLimit	isteğe bağlı	Diskteki dosya boyutu sınırı (bayt cinsinden). Varsayılan değer platforma göre belirlenir.

Yerel access level’ları etkinleştirin (Android)

Varsayılan olarak yerel access level’lar iOS’ta etkin, Android’de devre dışıdır. Android’de de etkinleştirmek için localAccessLevelAllowed değerini true olarak ayarlayın:

adapty.activate('YOUR_PUBLIC_SDK_KEY', {
  android: {
     localAccessLevelAllowed: true,
  },
});

Yedekten geri yüklemede verileri temizleyin

clearDataOnBackup değeri true olarak ayarlandığında SDK, uygulamanın bir iCloud yedeğinden geri yüklendiğini algılar ve önbelleğe alınmış profil bilgileri, ürün ayrıntıları ve paywalllar dahil olmak üzere yerel olarak depolanan tüm SDK verilerini siler. SDK ardından temiz bir durumla başlatılır. Varsayılan değer false’tur.

adapty.activate('YOUR_PUBLIC_SDK_KEY', {
   ios: {
       clearDataOnBackup: true
   },
});

Geliştirme ortamı ipuçları

Expo Go / Expo Web için mock modu kurma

Expo Go ve Expo Web ortamlarında Adapty’nin native modüllerine erişim bulunmaz. Uygulamanızın kullanıcı arayüzünü ve paywall mantığını oluştururken ve test ederken çalışma zamanı hatalarından kaçınmak için Adapty mock modu sunar.

Varsayılan olarak, SDK; Expo Go ve web ortamlarını otomatik olarak algılar ve mock modunu etkinleştirir. Mock verilerini özelleştirmek istemiyorsanız herhangi bir yapılandırma yapmanıza gerek yoktur.

Mock modu etkinken:

• Tüm Adapty metotları, Adapty sunucularına ağ isteği göndermeden mock veri döndürür.
• Varsayılan olarak, başlangıçtaki mock profilinde aktif abonelik bulunmaz.
• Varsayılan olarak, makePurchase(...) başarılı bir satın alma simüle eder ve premium erişim sağlar. mockConfig parametresini aktivasyon sırasında kullanarak sahte verileri özelleştirebilirsiniz. Yapılandırma formatını ve desteklenen parametreleri buradan inceleyebilirsiniz.

try {
  await adapty.activate('YOUR_PUBLIC_SDK_KEY', {
    mockConfig: {
      // Customize the initial mock profile (optional)
    },
  });
} catch (error) {
  console.error('Failed to activate Adapty SDK:', error);
}

SDK yöntemlerini aktivasyondan önce çağırmanız gerekiyorsa (örneğin isActivated() veya setLogLevel()), activate()’den önce enableMock() kullanın. Bridge zaten başlatılmışsa bu yöntem hiçbir şey yapmaz.

adapty.enableMock(); // İsteğe bağlı: mock verilerini özelleştirmek için mockConfig geçirebilirsiniz

// Artık aktivasyondan önce yöntemleri çağırabilirsiniz

await adapty.activate('YOUR_PUBLIC_SDK_KEY');

Geliştirme amacıyla SDK aktivasyonunu geciktirme

Adapty, SDK etkinleştirildiğinde gerekli tüm kullanıcı verilerini önceden çekerek taze verilere daha hızlı erişim sağlar.

Ancak bu durum, geliştirme sırasında sık sık kimlik doğrulama isteyen iOS simülatöründe sorun yaratabilir. Adapty, StoreKit kimlik doğrulama akışını kontrol edemese de SDK’nın taze kullanıcı verisi almak için yaptığı istekleri erteleyebilir.

__debugDeferActivation özelliği etkinleştirildiğinde, activate çağrısı bir sonraki Adapty SDK çağrısına kadar bekletilir. Bu sayede, ihtiyaç duyulmadığında gereksiz kimlik doğrulama istekleri önlenir. Bu özelliğin yalnızca geliştirme amaçlı kullanım için tasarlandığını belirtmek önemlidir; zira tüm olası kullanıcı senaryolarını kapsamaz. Üretim ortamında aktivasyon geciktirilmemelidir, çünkü gerçek cihazlar kimlik doğrulama verilerini genellikle hatırlar ve tekrar tekrar kimlik bilgisi sormaz.

Kullanım için önerilen yaklaşım şu şekildedir:

try {
  adapty.activate('PUBLIC_SDK_KEY', {
    __debugDeferActivation: isSimulator(), // 'isSimulator' herhangi bir 3. taraf kütüphaneden
  });
} catch (error) {
  console.error('Adapty SDK etkinleştirilemedi:', error);
  // Uygulamanız için hatayı uygun şekilde ele alın
}

React Native’in Fast Refresh özelliğinde SDK etkinleştirme hatalarını giderme

React Native’de Adapty SDK ile geliştirme yaparken şu hatayla karşılaşabilirsiniz: Adapty can only be activated once. Ensure that the SDK activation call is not made more than once. Bu durum, React Native’in hızlı yenileme (fast refresh) özelliğinin geliştirme sırasında birden fazla aktivasyon çağrısı tetiklemesinden kaynaklanır. Bunu önlemek için __ignoreActivationOnFastRefresh seçeneğini __DEV__ (React Native’in geliştirme modu bayrağı) olarak ayarlayın.

try {
  adapty.activate('PUBLIC_SDK_KEY', {
    __ignoreActivationOnFastRefresh: __DEV__,
  });
} catch (error) {
  console.error('Failed to activate Adapty SDK:', error);
  // Handle the error appropriately for your app
}

Sorun Giderme

Minimum iOS sürümü hatası

iOS için derleme yaparken, özellikle iOS 15.0+ gerektiren Adapty paywall builder ile oluşturulmuş paywalllar kullanıyorsanız, minimum iOS sürümü veya deployment target ile ilgili bir hata alabilirsiniz.

Expo, expo prebuild sırasında iOS projesini (Podfile dahil) oluşturduğundan, Podfile dosyasını doğrudan düzenlememelisiniz. Bunun yerine deployment target’ı expo-build-properties config plugin’i aracılığıyla yapılandırın.

1. Plugin’i yükleyin:

2. npx expo install expo-build-properties

3. Expo yapılandırmanızı (app.json veya app.config.js) güncelleyerek iOS deployment target’ı ayarlayın:

{
    "expo": {
        // ...other Expo config...
        "plugins": [
            [
                "expo-build-properties",
                {
                    "ios": {
                        // Yalnızca temel Adapty özellikleri için "13.0",
                        // veya paywall builder ile oluşturulan paywallları kullanıyorsanız "15.0" kullanın.
                        "deploymentTarget": "15.0"
                    }
                }
            ],
        ]
    }
}

3. Native iOS projesini yeniden oluşturun ve yeniden derleyin:

npx expo prebuild --clean
npx expo run:ios      # or `eas build -p ios` on your CI

Android Auto Backup manifest çakışması

Expo’yu Android Auto Backup yapılandıran birden fazla SDK ile (Adapty, AppsFlyer veya expo-secure-store gibi) kullanırken manifest birleştirme çakışmasıyla karşılaşabilirsiniz.

Tipik bir hata şu şekilde görünür: Manifest merger failed : Attribute application@fullBackupContent value=(@xml/secure_store_backup_rules) from AndroidManifest.xml:24:248-306 is also present at [io.adapty:android-sdk:3.12.0] AndroidManifest.xml:9:18-70 value=(@xml/adapty_backup_rules). Bu çakışmayı çözmek için Adapty eklentisinin Android yedekleme yapılandırmasını yönetmesine izin vermeniz gerekiyor. Projeniz expo-secure-store da kullanıyorsa, çakışmayı önlemek için kendi yedekleme kurulumunu devre dışı bırakın.

app.json dosyanızı şu şekilde yapılandırın:

{
  "expo": {
    "plugins": [
      ["react-native-adapty", { "replaceAndroidBackupConfig": true }],
      ["expo-secure-store", { "configureAndroidBackup": false }]
    ]
  }
}

replaceAndroidBackupConfig seçeneği varsayılan olarak false değerindedir. Etkinleştirildiğinde, Android yedekleme kurallarının Adapty eklentisi tarafından yönetilmesine izin verir. expo-secure-store kullanıyorsanız uyarıları önlemek için "configureAndroidBackup": false ekleyin; zira SecureStore’un yedekleme yapılandırması artık Adapty tarafından yönetilecektir.