Adapty iOS SDK'yı v4.1'e Geçirme

Adapty iOS SDK 4.1, Adapty Attribution’ın nasıl etkinleştirileceğini değiştiriyor, harici attribution API’larını yeniden adlandırıyor ve yedek dosya formatını değiştiriyor. Ayrıca 4.0’da kaldırılan App Store’da tanıtılan uygulama içi satın alma desteğini geri getiriyor.

Hızlı başvuru

⚠️ Adapty Attribution varsayılan olarak devre dışıdır

4.0 ve önceki sürümlerde SDK, Adapty Attribution için kurulumları otomatik olarak kaydediyordu. 4.1’den itibaren bu özellik varsayılan olarak kapalıdır: SDK kurulumları kaydetmez ve onInstallationDetailsSuccess ile onInstallationDetailsFail delegate callback’leri hiçbir zaman tetiklenmez. getCurrentInstallationStatus() ise .notAvailable döndürür.

Adapty Attribution kullanıyorsanız, SDK’yı etkinleştirirken bu özelliği açın:

let configurationBuilder = AdaptyConfiguration
    .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
+   .with(adaptyAttributionEnabled: true)

Adapty Attribution kullanmıyorsanız herhangi bir değişiklik yapmanıza gerek yoktur.

Yeniden adlandırılan harici attribution API’leri

updateAttribution(:source:) → updateExternalAttribution(:provider:)

Harici bir sağlayıcıdan (Adjust, AppsFlyer, Branch, Tenjin veya özel bir sağlayıcı) attribution verisi ileten metot yeniden adlandırıldı ve source parametresinin adı provider olarak değiştirildi:

- try await Adapty.updateAttribution(attribution, source: .adjust)
+ try await Adapty.updateExternalAttribution(attribution, provider: .adjust)

JSON string aşırı yüklemesi kaldırıldı

4.0 sürümünde attribution verisi [AnyHashable: Any] sözlüğü ya da JSON String olarak kabul ediliyordu. 4.1 sürümünde yalnızca sözlük aşırı yüklemesi herkese açıktır — JSON string aşırı yüklemesi Adapty’nin çoklu platform SDK’ları için ayrılmıştır. Aktarmadan önce JSON’ı ayrıştırın:

- try await Adapty.updateAttribution(attributionJson, source: .adjust)
+ guard let attribution = try JSONSerialization.jsonObject(
+     with: Data(attributionJson.utf8)
+ ) as? [AnyHashable: Any] else { return }
+ try await Adapty.updateExternalAttribution(attribution, provider: .adjust)

AdaptyAttributionSource → AdaptyExternalAttributionProvider

Tür yeniden adlandırıldı. Önceden tanımlı sağlayıcılar aynı adları korur: .appleAds, .adjust, .appsflyer, .branch, .tenjin. ExpressibleByStringLiteral’a uymaya devam ettiği için string literal argümanlar derlemeye devam eder. Sağlayıcıyı bir String değişkeninde saklıyorsanız, şu şekilde sarmalayın: AdaptyExternalAttributionProvider(rawValue: yourProvider).

4.1 ayrıca Adapty’nin doğrudan entegre olmadığı sağlayıcılar için önceden tanımlı bir .custom değeri ekler. 4.0’da aynı değer yalnızca "custom" string literal olarak kullanılabiliyordu.

AdaptyProfile.appliedAttributionSources → appliedExternalAttributionProviders

Profile’e uygulanan attribution sağlayıcılarını listeleyen profil özelliği yeniden adlandırıldı. Buna bağlı olarak öğe türü de değişti:

- if profile.appliedAttributionSources.contains(.appleAds) {
+ if profile.appliedExternalAttributionProviders.contains(.appleAds) {
      // Apple Ads attribution has been applied
  }

AdaptySubscriptionOfferType artık bir struct

AdaptySubscriptionOfferType — AdaptySubscriptionOffer.offerType türü — enum’dan RawRepresentable struct’a dönüştürüldü; böylece backend, SDK güncellemesi gerektirmeden yeni teklif türleri sunabilir:

- public enum AdaptySubscriptionOfferType: String, Sendable { ... }
+ public struct AdaptySubscriptionOfferType: Sendable, RawRepresentable, Equatable, Hashable { ... }

Bu değişiklik kodunuzu üç şekilde etkiler:

• Kapsamlı switch ifadeleri artık derlenmez. Bir struct’ın sabit bir case kümesi yoktur, bu nedenle derleyici bir switch’in kapsamlı olduğunu kanıtlayamaz. Bir default dalı ekleyin:

  switch offer.offerType {
  case .introductory: // ...
  case .promotional: // ...
  case .winBack: // ...
  + default: // handle offer types added later
  }

• .code kaldırıldı. Teklif kodları artık AdaptySubscriptionOffer.offerType üzerinden raporlanmıyor. case .code dalını kaldırın. Teklif kodlarını yönetmek için bkz. iOS’ta teklif kodlarını kullanma.

• Codable uyumluluğu kaldırıldı. AdaptySubscriptionOfferType’ı doğrudan encode/decode ediyorsanız, bunun yerine offerType.rawValue (String) değerini saklayın ve AdaptySubscriptionOfferType(rawValue:) ile değeri yeniden oluşturun.

Önceden tanımlanmış değerlere karşı yapılan karşılaştırmalar değişmeden kalır: .introductory, .promotional ve .winBack, == kontrollerinde ve case kalıpları olarak çalışmaya devam eder.

Yedek dosyalar

Yedek dosya formatı SDK 4.1 ile değişti. Placements > Fallbacks bölümünden dosyayı tekrar indirip uygulamanıza ekleyin; 4.0 için daha önce indirmiş olsanız bile.

App Store’da öne çıkan uygulama içi satın almaların geri dönüşü

SDK 4.1, 4.0’ın kaldırdığı App Store’da öne çıkan uygulama içi satın alma desteğini yeniden sunuyor. Bu, bir geçiş adımı değil yeni bir özelliktir: 4.0 davranışını değiştirmez.

3.x sürümünden geçiş yapıyorsanız ve AdaptyDeferredProduct ile birlikte shouldAddStorePayment(for:) kullandıysanız, bunun yerine AdaptyPromotedProduct ile yeni didReceivePromotedPurchase(_:) delegate metodunu benimseyin. shouldAddStorePayment’tan farklı olarak, yeni metot bir değer döndürmez: eğer implement etmezseniz SDK satın alma işlemini hemen başlatır; satın almayı ertelemek için metodu implement edin, ürünü saklayın ve daha sonra makePurchase’a iletin. Bkz. App Store’dan uygulama içi satın almalar.