Adapty Unity SDK 4.1, 4.x serisinin ilk kararlı sürümüdür — 4.0 yalnızca beta olarak yayımlandığından, 3.x kullanıyorsanız doğrudan 4.1’e geçin. Bu kılavuz, 4.0’da sunulan flow’ları ve bunların üzerine gelen 4.1 değişikliklerinin tamamını kapsamaktadır.

4.x serisi, flow’ları tanıtıyor ve paywall API’larını buna göre yeniden adlandırıyor. Yeni API’lar flow’larla çalıştığı gibi, eski builder’dan gelen paywall’larla da çalışıyor — Adapty Kontrol Paneli tarafında herhangi bir kurulum değişikliği gerekmiyor. Bunlara ek olarak, 4.1 harici attribution API’larını yeniden adlandırıyor, Adapty Attribution’ı opt-in hale getiriyor, zorunlu bir listener metodu ekliyor ve yedek dosya formatını değiştiriyor.

Hızlı referans

v3	v4.1
Adapty.GetPaywall(placementId, locale, ...)	Adapty.GetFlow(placementId, ...)
Adapty.GetPaywallForDefaultAudience(placementId, locale, ...)	Adapty.GetFlowForDefaultAudience(placementId, ...)
Adapty.GetPaywallProducts(paywall, ...)	Adapty.GetPaywallProducts(flow, ...)
Adapty.LogShowPaywall(paywall, ...)	Adapty.LogShowFlow(flow, ...)
AdaptyPaywall	AdaptyFlow
AdaptyUI.CreatePaywallView(paywall, ...)	AdaptyUI.CreateFlowView(flow, ...)
AdaptyUICreatePaywallViewParameters	AdaptyUICreateFlowViewParameters
AdaptyUIPaywallView	AdaptyUIFlowView
AdaptyUI.PresentPaywallView(view, ...) / DismissPaywallView(view, ...)	AdaptyUI.PresentFlowView(view, ...) / DismissFlowView(view, ...)
Adapty.SetPaywallsEventsListener(listener)	Adapty.SetFlowsEventsListener(listener)
AdaptyPaywallsEventsListener	IAdaptyFlowsEventsListener
AdaptyEventListener	IAdaptyEventListener, yeni zorunlu OnReceivePromotedPurchase metoduyla birlikte
AdaptyOnboardingsEventsListener	IAdaptyOnboardingsEventsListener
PaywallViewDidPerformAction, PaywallViewDidAppear ve diğer PaywallView... geri çağırmaları	FlowViewDidPerformAction, FlowViewDidAppear ve diğer FlowView... geri çağırmaları
PaywallViewDidFailRendering	FlowViewDidReceiveError
string kaynaklı Adapty.UpdateAttribution(data, source, ...)	AdaptyExternalAttributionProvider kullanan Adapty.UpdateExternalAttribution(jsonString, provider, ...)
IReadOnlyList<string> olarak AdaptyProfile.AppliedAttributionSources	IReadOnlyList<AdaptyExternalAttributionProvider> olarak AdaptyProfile.AppliedExternalAttributionProviders
Adapty Attribution otomatik olarak etkin	varsayılan olarak devre dışı — Builder.SetAdaptyAttributionEnabled(true) ile etkinleştirin
3.x için indirilen yedek dosya	yeni yedek dosya formatı — dosyayı yeniden indirin
Adapty.SetFallbackPaywalls(...) (v3’te kullanımdan kaldırıldı)	kaldırıldı — Adapty.SetFallback(fileName, ...) kullanın
Builder.SetIDFACollectionDisabled(...) (v3’te kullanımdan kaldırıldı)	kaldırıldı — Builder.SetAppleIDFACollectionDisabled(...) kullanın
paywall.Products (AdaptyProductReference listesi)	kaldırıldı — ProductIdentifiers veya VendorProductIds kullanın ya da tam ürünler için GetPaywallProducts(flow) çağrısı yapın
AdaptyProductReference	herkese açık tür olarak kaldırıldı — bkz. Veri modeli
paywall.RemoteConfigString	kaldırıldı — flow.RemoteConfig?.Data kullanın

AdaptyPaywallProduct adını korur — ürünler hâlâ bir flow’a aittir ve GetPaywallProducts da adını korur, artık bir AdaptyFlow alır. GetFlow ve GetFlowForDefaultAudience metodları artık locale parametresi almaz. Satın alma ve profil API’leri (MakePurchase, RestorePurchases, GetProfile, Identify, UpdateProfile) değişmemiştir. SetFallback imzasını korur, ancak okuduğu dosyanın yeniden indirilmesi gerekir — bkz. Yedek dosyalar. Onboarding metodları hâlâ çalışır ancak kullanımdan kaldırılmıştır — bkz. Onboarding API kullanımdan kaldırma. Bazı varsayılan davranışlar değişti — bkz. Varsayılan davranış değişiklikleri.

Kurulum

SDK 4.1’i Unity Package Manager aracılığıyla yüklemek için Git URL’sine versiyon etiketini ekleyin:

https://github.com/adaptyteam/AdaptySDK-Unity.git?path=/Packages/com.adapty.unity-sdk#4.1.0

Unity paketi aracılığıyla yüklemek istiyorsanız, adapty-unity-plugin-4.1.0.unitypackage dosyasını 4.1.0 sürümünden indirin. Tam kurulum için Adapty SDK’yı Yükleyin sayfasına bakın.

4.x ile birlikte iki derleme kurulumu değişikliği geldi:

• iOS bağımlılıkları Swift Package Manager’a geçiyor. Yerel Adapty iOS SDK’sı, CocoaPods pod’u yerine uzak bir Swift paketi olarak tanımlanıyor. External Dependency Manager’ı 1.2.188 veya üzeri sürüme güncelleyin — önceki sürümler Swift Package Manager bağımlılıklarını desteklemiyor. CocoaPods adımları (iOS Resolver -> Install Cocoapods, Unity-iPhone.xcworkspace açma) artık geçerli değil. iOS için derleme yapmak artık Xcode 26 veya üzerini gerektiriyor; Swift paketi, Swift tools 6.2 ile derleniyor.
• iOS deployment target 15.0 veya üzeri olmalıdır. Unity Editor’daki yeni bir derleme doğrulayıcısı, hedef daha düşükse iOS derlemesini durduruyor.

Altta yatan yerel Adapty SDK’ları her iki platformda da otomatik olarak 4.x sürümüne güncellenir; başka bir derleme değişikliğine gerek yoktur.

Flow’ları çekme

GetPaywall → GetFlow

Döndürülen tür AdaptyPaywall’dan AdaptyFlow’a değişir ve locale parametresi kaldırılır — bir flow render ettiğinizde, locale otomatik olarak belirlenir; özel paywalllar için tüm locale’ler flow.RemoteConfigs içinde döndürülür:

- Adapty.GetPaywall("YOUR_PLACEMENT_ID", "en", (paywall, error) => {
+ Adapty.GetFlow("YOUR_PLACEMENT_ID", (flow, error) => {
      if (error != null) {
          // handle the error
          return;
      }
-     // use the paywall
+     // use the flow
  });

GetPaywallForDefaultAudience aynı şekilde yeniden adlandırıldı:

- Adapty.GetPaywallForDefaultAudience("YOUR_PLACEMENT_ID", "en", (paywall, error) => { /* ... */ });
+ Adapty.GetFlowForDefaultAudience("YOUR_PLACEMENT_ID", (flow, error) => { /* ... */ });

GetPaywallProducts(paywall) → GetPaywallProducts(flow)

GetPaywallProducts adını korur ancak artık bir AdaptyFlow alır:

- Adapty.GetPaywallProducts(paywall, (products, error) => {
+ Adapty.GetPaywallProducts(flow, (products, error) => {
      if (error != null) {
          // handle the error
          return;
      }
      // use the products
  });

Veri modeli

GetFlow, bir AdaptyPaywall yerine AdaptyFlow döndürür ve nesne yapısı değişti:

v3 AdaptyPaywall özelliği	v4 AdaptyFlow özelliği	İşlem
RemoteConfig (tekil, null olabilir)	RemoteConfigs (liste)	Bir flow, yapılandırılmış her dil için ayrı bir remote config taşır. flow.RemoteConfigs içinden kullanıcıya uyan olanı okuyun. flow.RemoteConfig kısayolu ilk girişi döndürür.
(yeni)	Paywalls (AdaptyFlowPaywall listesi)	Her giriş, flow içindeki bir paywall varyasyonunu temsil eder; kendi Name, VariationId ve ProductIdentifiers değerlerine sahiptir. Web paywall metotları bir AdaptyFlowPaywall alır — bkz. Web paywall metotları.
ProductIdentifiers, VendorProductIds	korundu	AdaptyFlow üzerinde bu değerler, tüm paywall varyasyonlarındaki ürünleri bir araya getirir. Her varyasyon kendi ProductIdentifiers ve VendorProductIds değerlerini de sunar. Ürünleri çekmek için GetPaywallProducts(flow) çağrısını kullanmaya devam edin.
HasViewConfiguration	kaldırıldı	Kodunuzdaki HasViewConfiguration kontrollerini kaldırın — bunun yerine CreateFlowView hata döndürür (bkz. Flow’ları görüntüleme).
Products (AdaptyProductReference listesi)	kaldırıldı	AdaptyProductReference artık herkese açık değil; bununla birlikte taşıdığı PromotionalOfferId, WinBackOfferId ve AndroidOfferId değerleri de kaldırıldı. VendorProductId ve yalnızca Android’e özgü BasePlanId (v3’teki AndroidBasePlanId) içeren AdaptyProductIdentifier listesi olan ProductIdentifiers’ı kullanın — ya da fiyatlar ve tekliflerle birlikte tam AdaptyPaywallProduct nesnelerine ihtiyaç duyduğunuzda GetPaywallProducts(flow) çağırın.
RemoteConfigString	kaldırıldı	Dizeyi doğrudan remote config’den okuyun: flow.RemoteConfig?.Data veya flow.RemoteConfigs içindeki ilgili giriş.
(yeni)	FlowVersionId (null olabilir)	Flow’un sürüm tanımlayıcısı; mevcut olmadığında null döner.

AdaptyPaywallProduct bir alan kazanır: FlowProductId, ürünün flow içindeki tanımlayıcısıdır; bir flow’a ait olmayan ürünler için null değerini alır.

Web paywall metodları

OpenWebPaywall ve CreateWebPaywallUrl isimlerini korur, ancak paywall argümanı artık flow.Paywalls içindeki varyantlardan biri olan bir AdaptyFlowPaywall alır. Bunun yerine yine de AdaptyPaywallProduct geçirebilirsiniz:

- Adapty.OpenWebPaywall(paywall, AdaptyWebPresentation.ExternalBrowser, (error) => { /* ... */ });
+ var flowPaywall = flow.Paywalls.FirstOrDefault();
+ if (flowPaywall != null) {
+     Adapty.OpenWebPaywall(flowPaywall, AdaptyWebPresentation.ExternalBrowser, (error) => { /* ... */ });
+ }

Flow görüntülemelerini takip etme

LogShowPaywall → LogShowFlow

LogShowPaywall, LogShowFlow olarak yeniden adlandırıldı ve artık bir AdaptyFlow alıyor. Etkinlik hâlâ aynı varyasyona karşı kaydedildiğinden, mevcut huni ve A/B testi metrikleri kontrol panelinde herhangi bir değişiklik yapılmadan çalışmaya devam eder.

- Adapty.LogShowPaywall(paywall, (error) => { /* ... */ });
+ Adapty.LogShowFlow(flow, (error) => { /* ... */ });

v3’te olduğu gibi, Adapty tarafından render edilen flow’ları veya paywallları görüntülerken bu metodu çağırmanıza gerek yoktur — Adapty bu görüntülemeleri otomatik olarak takip eder.

Flow’ları Görüntüleme

CreatePaywallView → CreateFlowView

Factory metodunu yeniden adlandırın ve AdaptyFlow’u iletin. Döndürülen view türü AdaptyUIPaywallView’dan AdaptyUIFlowView’a yeniden adlandırıldı, ancak metodları (Present, Dismiss) değişmedi ve isteğe bağlı parametreler nesnesi aynı alanları (LoadTimeout, PreloadProducts, CustomTags, CustomTimers, CustomAssets, ProductPurchaseParameters) yeni AdaptyUICreateFlowViewParameters adıyla korur, ayrıca iki yeni alan eklenmiştir — Locale ve EnableSafeAreaPaddings:

- AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
+ AdaptyUI.CreateFlowView(flow, parameters, (view, error) => {
      if (error != null) {
          // handle the error
          return;
      }
      view.Present((error) => { /* handle the error */ });
  });

CreateFlowView, flow için görünüm yapılandırılmamışsa hata döndürür — bu, v3’teki HasViewConfiguration kontrolünün yerini alır:

- if (paywall.HasViewConfiguration) {
-     AdaptyUI.CreatePaywallView(paywall, null, (view, error) => { /* ... */ });
- }
+ AdaptyUI.CreateFlowView(flow, (view, error) => {
+     if (error != null) {
+         // the flow has no view configured, or view creation failed
+         return;
+     }
+     view.Present((error) => { /* handle the error */ });
+ });

Android güvenli alan dolguları

AdaptyUICreateFlowViewParameters, Android güvenli alan dolgularını çalışma zamanında kontrol eden EnableSafeAreaPaddings özelliğini ekler. iOS’ta yok sayılır ve varsayılan değeri true’dur:

var parameters = new AdaptyUICreateFlowViewParameters()
    .SetEnableSafeAreaPaddings(false);

Olayları İşleme

Dinleyici arayüzleri artık C# I- ön eki kuralını takip ediyor ve eski takma adlar korunmuyor — bunları uyguladığınız her yerde AdaptyEventListener yerine IAdaptyEventListener, AdaptyOnboardingsEventsListener yerine ise IAdaptyOnboardingsEventsListener olarak yeniden adlandırın.

Flow events listener, AdaptyPaywallsEventsListener’dan IAdaptyFlowsEventsListener’a yeniden adlandırıldı; kayıt metodu SetPaywallsEventsListener’dan SetFlowsEventsListener’a, callback’ler ise PaywallView önekinden FlowView önekine değiştirildi. Mevcut handler gövdelerinde kod değişikliği gerekmez — sadece arayüz ve metotları yeniden adlandırın:

- public class MyListener : MonoBehaviour, AdaptyPaywallsEventsListener {
-     public void PaywallViewDidFinishPurchase(
-         AdaptyUIPaywallView view,
+ public class MyListener : MonoBehaviour, IAdaptyFlowsEventsListener {
+     public void FlowViewDidFinishPurchase(
+         AdaptyUIFlowView view,
          AdaptyPaywallProduct product,
          AdaptyPurchaseResult purchasedResult
      ) {
          // custom logic after purchase
      }
      // ...
  }

- Adapty.SetPaywallsEventsListener(myListener);
+ Adapty.SetFlowsEventsListener(myListener);

Bir callback yeniden adlandırıldı: PaywallViewDidFailRendering, FlowViewDidReceiveError oldu. Bu callback, önceki gibi rendering hatalarında tetiklenmeye devam eder; buna ek olarak satın alma dışındaki diğer çalışma zamanı hatalarında da tetiklenir:

- public void PaywallViewDidFailRendering(AdaptyUIPaywallView view, AdaptyError error) { }
+ public void FlowViewDidReceiveError(AdaptyUIFlowView view, AdaptyError error) { }

Tüm callback listesi için Flow & paywall olaylarını yönetme bölümüne bakın.

Yeni zorunlu metod: OnReceivePromotedPurchase

SDK 4.1 sürümünden itibaren IAdaptyEventListener arayüzüne yeni bir metod eklendiğinden, bunu uygulayan her sınıf aşağıdakini ekleyene kadar derlenmez:

public void OnReceivePromotedPurchase(AdaptyPromotedProduct product) {
    // The user tapped one of your in-app purchases on your App Store product page.
    // Complete the purchase through Adapty:
    Adapty.MakePromotedPurchase(product, (result, error) => { /* ... */ });
}

Bu metot, App Store’da tanıtılan uygulama içi satın almalar için kullanılır ve Android’de hiçbir zaman çağrılmaz. Gövdeyi boş bırakmayın: iOS 16.4 ve sonraki sürümlerde SDK, satın almayı burada iletir ve tamamlamanızı bekler; boş bir gövde, kullanıcının başlattığı bir satın almayı düşürür. Önceki sürümlerde bu tür satın almalar otomatik olarak tamamlanıyordu. Bkz. App Store’dan tanıtılan uygulama içi satın almalar.

Yeni API’lar

• Adapty.SetObserverModeResolver(...) ve IAdaptyUIObserverModeResolver — SDK Observer mode’da çalışırken flow’lardan başlatılan satın alma ve geri yükleme işlemlerini yönetir. Daha önce bu özellik yalnızca native iOS ve Android SDK’larında mevcuttu. Bkz. Flow’ları Observer mode’da sunma.
• Adapty.SetSystemRequestsHandler(...) ve IAdaptyUISystemRequestsHandler — bir flow’dan gelen sistem istekleri için ayrılmıştır: İşletim sistemi izin istemleri (FlowViewDidAskPermission) ve uygulama değerlendirme istekleri (FlowViewDidRequestAppReview). Flow’lar henüz bu istekleri tetiklemediğinden bir handler kaydetmenize gerek yoktur.
• AdaptyUICreateFlowViewParameters.Locale (SetLocale ile ayarlanır) — bir flow veya paywall’ı, flow’un varsayılanı yerine belirli bir Builder yerelleştirmesiyle oluşturur. Bir flow, görünümü oluşturulduğunda yerelleştirilir; bu nedenle yerelleştirmeyi seçebileceğiniz tek yer burasıdır ve oluşturulan görünüm, yapılandırıldığı yerelleştirmeyi view.Locale aracılığıyla raporlar. Bkz. Yerelleştirmeleri ve yerel ayar kodlarını kullanma.
• IAdaptyFlowsEventsListener üzerindeki yeni FlowViewDidReceiveAnalyticEvent callback’i, bir flow’dan gelen analitik olaylarını raporlar; kullanıcının açtığı her ekran için ekran görüntüleme olayıyla başlar. Bkz. Flow ekran görüntülemelerini izleme.
• AdaptyUI.OpenUrl(url, openIn, ...) ve AdaptyUI.RequestAppReview(...) — open_url eylemleri ve uygulama değerlendirme isteklerinin arkasındaki native işleme. Varsayılan URL davranışını korumak için FlowViewDidPerformAction içinden OpenUrl’i çağırın; RequestAppReview ise henüz flow’ların tetiklemediği varsayılan uygulama değerlendirme istemini destekler.

Yeniden adlandırılan harici attribution API’leri

SDK 4.1 sürümünden itibaren, harici bir sağlayıcıdan (Adjust, AppsFlyer, Branch, Tenjin veya özel bir sağlayıcı) attribution verisi aktarmak için kullanılan API’ler, yerel SDK’larla uyumlu olacak şekilde yeniden adlandırıldı; sağlayıcı artık bir string yerine bir tür olarak tanımlanıyor. Eski çağrı noktaları için herhangi bir deprecated takma ad bulunmuyor, bu nedenle güncelleme yapılmadığı takdirde mevcut çağrılar derlenmez:

4.1 Öncesi	4.1
Adapty.UpdateAttribution(data, source, ...)	Adapty.UpdateExternalAttribution(jsonString, provider, ...)
string olarak source	AdaptyExternalAttributionProvider olarak provider
IReadOnlyList<string> olarak AdaptyProfile.AppliedAttributionSources	IReadOnlyList<AdaptyExternalAttributionProvider> olarak AdaptyProfile.AppliedExternalAttributionProviders

Yalnızca metodu yeniden adlandırmak yeterli değildir — aynı düzenlemede provider argümanını da değiştirin:

- Adapty.UpdateAttribution(attributionJsonString, "adjust", (error) => { /* ... */ });
+ Adapty.UpdateExternalAttribution(attributionJsonString, AdaptyExternalAttributionProvider.Adjust, (error) => { /* ... */ });

AdaptyExternalAttributionProvider, backend’in sağlayıcıyı tanımak için kullandığı tanımlayıcıyı taşır; altı paylaşımlı örneği vardır: AppleAds (apple_search_ads), Adjust, Appsflyer, Branch, Tenjin ve Custom. Bu SDK sürümünden sonra Adapty’nin eklediği bir sağlayıcı için, tanımlayıcısından birini oluşturun — new AdaptyExternalAttributionProvider("your_provider") — ve backend’e değiştirilmeden ulaşır. Çevredeki boşluklar kırpılır.

Attribution verisi serileştirilmiş bir JSON dizesi olarak girilir. Veriyi bir sözlük olarak tutuyorsanız, önce serileştirin:

var attributionJsonString = Newtonsoft.Json.JsonConvert.SerializeObject(attribution);

Profil tarafında, uygulanan sağlayıcıları yeni tür aracılığıyla okuyun:

- if (profile.AppliedAttributionSources.Contains("apple_search_ads")) {
+ if (profile.AppliedExternalAttributionProviders.Contains(AdaptyExternalAttributionProvider.AppleAds)) {
      // Apple Ads attribution has been applied
  }

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

Önceki sürümlerde SDK, Adapty Attribution için kurulumları otomatik olarak kaydediyordu. SDK 4.1 sürümünden itibaren bu özellik varsayılan olarak kapalıdır: SDK kurulumları kayıt etmez, OnInstallationDetailsSuccess ve OnInstallationDetailsFail dinleyici geri çağrıları hiçbir zaman tetiklenmez ve GetCurrentInstallationStatus, NotAvailable durumunu döndürür.

Adapty Attribution kullanıyorsanız, SDK’yı etkinleştirirken bunu etkinleştirin:

var builder = new AdaptyConfiguration.Builder("YOUR_PUBLIC_SDK_KEY")
    .SetAdaptyAttributionEnabled(true);

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

Yedek dosyalar

Yedek dosya formatı SDK 4.1’de değişti. iOS ve Android yedek dosyalarını Placements > Fallbacks bölümünden tekrar indirin ve Assets/StreamingAssets klasöründekilerin yerine koyun; daha önceki bir sürüm için indirmiş olsanız bile.

Varsayılan davranış değişiklikleri

Bu değişiklikler derleme hatası oluşturmaz, dolayısıyla bunları çalışma zamanında test edin:

• Satın alma tamamlama: v3’te, başarılı bir satın almanın ardından görünüm otomatik olarak kapatılıyordu. v4’te, bir flow satın alma veya hata sonrasında siz kapatana kadar açık kalır — SDK herhangi bir varsayılan davranış uygulamaz. Kullanıcı erişim kazandıktan sonra FlowViewDidFinishPurchase içinde view.Dismiss(...) metodunu kendiniz çağırın.
• Android sistem geri tuşu: Sistem geri tuşu (veya geri kaydırma hareketi), FlowViewDidPerformAction’a SystemBack aksiyonu olarak iletilir ve artık flow’u kendiliğinden kapatmaz — bu durum iOS ile tutarlıdır; iOS’ta bir flow sistem hareketi ile kapatılamaz. Kullanıcılara açık bir çıkış yolu sunun (bir Close düğmesi veya on_device_back aksiyonu) ya da aksiyonu işlerken görünümü kendiniz kapatın.
• Görünümler tek kullanımlıktır: Dismiss çağrısından sonra görünüm yok edilir. Flow’u tekrar göstermek için CreateFlowView metodunu yeniden çağırın.
• Observer mode işlemleri: ReportTransaction artık başarı durumunda kod çözme hatası döndürmez — v3’te başarı yanıtı hatalı şekilde ayrıştırılıyordu, bu yüzden başarılı bir rapor her zaman hatayla tamamlanıyordu.

Onboarding API’sinin kullanımdan kaldırılması

Eski onboarding API’si, v4’te Flow & Paywall Builder lehine kullanımdan kaldırılmıştır. Hâlâ çalışmaya devam etmektedir, ancak gelecekteki bir sürümde kaldırılacaktır; bu nedenle onboardinglarınızı Flow & Paywall Builder’a taşımayı planlayın.

Kullanımdan kaldırılan semboller: GetOnboarding, GetOnboardingForDefaultAudience, AdaptyUI.CreateOnboardingView, AdaptyUI.PresentOnboardingView, AdaptyUI.DismissOnboardingView ve Adapty.SetOnboardingsEventsListener.