Adapty FlutterFlow eklentisi eylemleri ve veri türleri

Özel Aksiyonlar

Aşağıda, Adapty eklentisiyle FlutterFlow’a sunulan Adapty metodları yer almaktadır. Bunlar FlutterFlow’da özel aksiyon olarak kullanılabilir.

Özel EylemAçıklamaEylem ArgümanlarıAdapty Veri Türleri - Eylem Çıktı Değişkeni
activateAdapty SDK’yı başlatırYok

getPaywall

Bir paywall getirir. Paywall ürünlerini döndürmez. Gerçek ürünleri almak için getPaywallProducts eylemini kullanınAdaptyGetPaywallResult

getPaywallProducts

Gerçek paywall ürünlerinin listesini döndürürAdaptyPaywallAdaptyGetProductsResult

getProductsIntroductoryOfferEligibility

Kullanıcının iOS abonelik başlangıç teklifine uygun olup olmadığını kontrol ederAdaptyPaywallProductAdaptyGetIntroEligibilitiesResult

makePurchase

Satın alma işlemini tamamlar ve içeriğin kilidini açar. Paywall’da bir promosyon teklifi varsa Adapty bunu ödeme sırasında otomatik olarak uygular
  • product: Paywall’dan alınan bir AdaptyPaywallProduct nesnesi.
  • subscriptionUpdateParams: Aboneliği yükseltmek veya düşürmek için kullanılan bir AdaptySubscriptionUpdateParameters nesnesi (Android için kullanın).
  • isOfferPersonalized: Teklifin alıcıya özel olup olmadığını belirtir (Android için kullanın).
AdaptyMakePurchaseResult

getProfile

Mevcut uygulama kullanıcısının profilini getirir. Bu sayede access level’ları ve diğer parametreleri ayarlayabilirsiniz

Başarısız olursa (örneğin internet yoksa) önbelleğe alınmış veriler döndürülür. Adapty, bilgilerin mümkün olduğunca güncel kalması için profil önbelleğini düzenli olarak günceller

YokAdaptyGetProfileResult
updateProfileMevcut kullanıcı profilinin e-posta, telefon numarası vb. isteğe bağlı özelliklerini değiştirir. Bu özellikleri daha sonra kullanıcı segmentleri oluşturmak veya CRM’de görüntülemek için kullanabilirsinizAdaptyProfile için ID ve güncellenmesi gereken parametrelerAdaptyError (İsteğe Bağlı)
restorePurchasesKullanıcının daha önce yaptığı tüm satın almaları geri yüklerYokAdaptyGetProfileResult
logShowPaywallKullanıcıya belirli bir paywall gösterildiğinde bunu kaydederAdaptyPaywallAdaptyError (İsteğe Bağlı)
identifyKullanıcıyı sisteminizdeki customerUserId ile tanımlarcustomerUserIdAdaptyError (İsteğe Bağlı)
logoutMevcut kullanıcının uygulamadan oturumunu kapatırYokAdaptyError (İsteğe Bağlı)
presentCodeRedemptionSheetKullanıcıların kod kullanmasına olanak tanıyan bir sayfa görüntüler (yalnızca iOS)YokYok

Veri Tipleri

Adapty eklentisiyle FlutterFlow’a iletilen Adapty veri tipleri (veri değerleri koleksiyonları).

AdaptyAccessLevel

Kullanıcının access level bilgisi.

Alan AdıTürAçıklama
activatedAtDateTimeBu access level’ın etkinleştirildiği zaman
activeIntroductoryOfferTypeStringAktif başlangıç teklifinin türü. Ayarlanmışsa, bu abonelik döneminde bir teklif uygulandığı anlamına gelir
activePromotionalOfferIdStringAktif promosyon teklifinin kimliği (iOS’tan satın alınan)
activePromotionalOfferTypeStringAktif promosyon teklifinin türü (iOS’tan satın alınan). Ayarlanmışsa, bu abonelik döneminde bir teklif uygulandığı anlamına gelir
billingIssueDetectedAtDateTimeBir fatura sorununun tespit edildiği zaman. Abonelik hâlâ aktif olabilir. Ödeme başarıyla işlenirse null olarak ayarlanır
cancellationReasonStringAboneliğin iptal edilme nedeni
expiresAtDateTimeAccess level’ın sona erme zamanı (geçmişte olabilir ya da süresiz erişim için ayarlanmamış olabilir)
idStringAccess level’ın tanımlayıcısı
isActiveBooleanBu access level aktifse true. Genel olarak, kullanıcının premium özelliklere erişimi olup olmadığını belirlemek için bu özelliği kontrol edebilirsiniz
isInGracePeriodBooleanBu otomatik yenilenen abonelik ek süre içindeyse true
isLifetimeBooleanBu access level süresiz olarak aktifse true (son kullanma tarihi yok)
isRefundBooleanBu satın alma iade edildiyse true
offerIdStringAktif promosyon teklifinin kimliği (Android’den satın alınan)
renewedAtDateTimeAccess level’ın en son yenilendiği zaman
startsAtDateTimeBu access level’ın başlangıç zamanı (gelecekte olabilir)
storeStringSatın almanın yapıldığı mağaza
unsubscribedAtDateTimeAbonelik için otomatik yenilemenin kapatıldığı zaman. Abonelik hâlâ aktif olabilir. Ayarlanmamışsa, kullanıcı aboneliği yeniden etkinleştirmiştir
vendorProductIdStringBu access level’ı açan mağazadaki ürün kimliği
willRenewBooleanBu otomatik yenilenen abonelik yenilenecek şekilde ayarlanmışsa true

AdaptyAccessLevelIdentifiers

Bu struct, Map<String, AdaptyAccessLevel AdaptyAccessLevel için anahtar-değer çiftinin yerine geçmek amacıyla tasarlanmıştır.

Alan AdıTürAçıklama
accessLevelIdentifierStringAccess level’ın ID’si
accessLevelData (AdaptyAccessLevel)İlişkili AdaptyAccessLevel

AdaptyCustomDoubleAttribute

Kullanıcı için tanımlanmış özel double attribute bilgileri.

Alan AdıTürAçıklama
keyStringÖzel double attribute’un ID’si
valueDoubleÖzel double attribute’un değeri

AdaptyCustomStringAttribute

Kullanıcı için tanımlanmış özel string attribute’larına ilişkin bilgiler.

Alan AdıTürAçıklama
keyStringÖzel string attribute’un ID’si
valueStringÖzel string attribute’un değeri

AdaptyError

Bir hata hakkındaki ayrıntıları içerir. Hata kodlarının tam listesi için bkz. React Native, Flutter, Unity - Hataları yönetme.

Alan AdıTürAçıklama
errorMessageStringHatanın okunabilir açıklaması
errorCodeIntegerHatayı tanımlayan sayısal kod

AdaptyGetIntroEligibilitiesResult

getProductsIntroductoryOfferEligibility özel eyleminin sonucunu içerir.

Alan AdıTürAçıklama
valueList < Data (AdaptyProductIntroEligibility) >Kullanıcının promosyon tekliflerine uygunluk listesi
errorData (AdaptyError)AdaptyError aracılığıyla hata ayrıntılarını içerir

AdaptyGetPaywallResult

getPaywall özel eyleminin sonucunu içerir.

Alan AdıTürAçıklama
valueData (AdaptyPaywall)AdaptyPaywall nesnelerinin listesini içerir
errorData (AdaptyError)AdaptyError aracılığıyla hata bilgisi içerir

AdaptyGetProductsResult

getPaywallProducts özel eyleminin sonucunu içerir.

Alan AdıTürAçıklama
valueList < Data (AdaptyPaywallProduct) >AdaptyPaywallProduct listesini içerir
errorData (AdaptyError)AdaptyError aracılığıyla hata bilgisini içerir

AdaptyGetProfileResult

getProfile özel eyleminin sonucunu içerir.

Alan AdıTürAçıklama
valueData (AdaptyProfile)Kullanıcı profilini bir AdaptyProfile olarak içerir
errorData (AdaptyError)Hata bilgisini AdaptyError aracılığıyla içerir

AdaptyMakePurchaseResult

makePurchase özel eyleminin sonucunu içerir.

Alan AdıTürAçıklama
valueData (AdaptyProfile)Kullanıcının profilini AdaptyProfile olarak içerir
errorData (AdaptyError)Hata bilgisini AdaptyError aracılığıyla içerir

AdaptyNonSubscription

Abonelik dışı satın almalar hakkında bilgi. Bunlar tek seferlik (consumable) ürünler, kilit açma işlemleri (oyunda yeni harita açma gibi) vb. olabilir.

Alan AdıTürAçıklama
isConsumableBooleanÜrünün consumable olup olmadığını belirtir
isOneTimeBooleanÜrünün tek seferlik satın alma olup olmadığını belirtir (örneğin, true ise satın alma yalnızca bir kez işlenir)
isRefundBooleanÜrünün iade edilip edilmediğini belirtir
isSandboxBooleanÜrünün sandbox ortamında satın alınıp alınmadığını belirtir
purchasedAtDateTimeÜrünün satın alındığı zaman
purchaseIdStringAdapty’deki satın almanın kimliği. Tek seferlik ürünleri takip etmek için kullanılabilir
storeStringÜrünün satın alındığı mağaza (örneğin, App Store, Google Play)
vendorProductIdStringÜrünün satıcı sistemindeki kimliği
vendorTransactionIdStringSatıcı sistemindeki işlem kimliği

AdaptyPaywall

Bir paywall hakkındaki bilgiler.

Alan AdıTürAçıklama
abTestNameStringÜst A/B testinin adı
hasViewConfigurationBooleanPaywall için bir görünüm yapılandırması olup olmadığını gösterir
localeStringPaywallın locale ID’si
nameStringPaywall adı
placement.idStringÜst placement’ın ID’si
remoteConfigStringStringBu paywall ile ilişkilendirilmiş, Adapty Kontrol Paneli’nden gelen özel sözlük
placement.revisionIntegerPaywallın mevcut revizyon/sürüm numarası. Her değişiklik yeni bir revizyon oluşturur
variationIdStringSatın almaları bu paywalla atfetmek için kullanılan varyasyon ID’si
vendorProductIdsStringPaywall ile ilişkili ürün ID’lerinin dizisi

AdaptyPaywallProduct

Ürün hakkında bilgi.

Alan AdıTürAçıklama
vendorProductIdStringUygulama mağazasındaki bir ürünün ID’si
localizedDescriptionStringÜrünün kullanıcının dilindeki açıklaması
localizedTitleStringÜrünün kullanıcının dilindeki adı
regionCodeStringÜrün fiyatını biçimlendirmek için kullanılan yerel ayarın bölge kodu (iOS için kullanın)
isFamilyShareableBooleanÜrünün App Store Connect’te aile paylaşımına açık olup olmadığını belirten Boolean değeri. iOS 14.0 ve macOS 11.0 altındaki sürümler için her zaman FALSE olur (iOS için kullanın)
paywallVariationIdStringSatın almaları bu paywall’a atıflamak için kullanılan varyant ID’si
paywallABTestNameStringBağlı A/B testi adı
paywallNameStringBağlı paywall adı
priceData (AdaptyPriceData)Ürünün fiyatı
subscriptionDetailsData (AdaptySubscriptionDetails)Abonelik bilgileri

AdaptyPrice

Ürün fiyatına ilişkin bilgiler.

Alan AdıTürAçıklama
amountDoubleFiyatın sayısal değeri
currencyCodeStringFiyat para biriminin kodu
currencySymbolStringPara birimi için kullanılan sembol
localizedStringStringKullanıcının diline göre gösterilen fiyat

AdaptyProductIntroEligibility

Kullanıcının bir iOS aboneliği için başlangıç teklifine uygun olup olmadığını tanımlar.

Alan AdıTürAçıklama
vendorProductIdStringUygulama mağazasındaki bir ürünün ID’si
eligibilityAdaptyEligibilityEnumKullanıcının bir iOS aboneliği için başlangıç teklifine uygun olup olmadığının tanımı

AdaptyProductNonsubscriptions

Bu ürüne bağlı aktif abonelik dışı satın almanın ayrıntıları.

Alan AdıTürAçıklama
productIdStringUygulama mağazasındaki ürünün ID’si
nonsubscriptionsAdaptyNonSubscriptionAbonelik dışı satın almalar hakkında bilgi. Bunlar tek seferlik (consumable) ürünler, kilit açma öğeleri (oyunda yeni harita açma gibi) vb. olabilir.

AdaptyProductSubscriptions

Bu ürünle ilişkili aktif aboneliğin ayrıntıları.

Alan AdıTürAçıklama
productIdStringUygulama mağazasındaki ürünün kimliği
subscriptionAdaptySubscriptionAbonelik satın alımlarına ilişkin bilgiler

AdaptyProfile

Kullanıcının profil bilgileri

Alan AdıTürAçıklama
accessLevelsList < Data (AdaptyAccessLevelIdentifiers) >Kullanıcıya ait tüm access level’ların listesi
profileIdStringKullanıcı profilinin ID’si
customerUserIdStringKullanıcının satıcı sistemindeki ID’si
subscriptionsList < Data (MapKeySubscriptions) >Kullanıcının satın aldığı tüm aboneliklerin listesi
nonSubscriptionsList < Data (MapKeyNonSubscriptions) >Kullanıcının satın aldığı tüm abonelik dışı ürünlerin listesi

AdaptyProfileParameters

Kullanıcı hakkında bilgiler.

Alan AdıTürAçıklama
firstNameStringKullanıcının adı
lastNameStringKullanıcının soyadı
genderAdaptyGenderEnumKullanıcının cinsiyeti
birthdayStringKullanıcının doğum tarihi
emailStringKullanıcının e-posta adresi
phoneNumberStringKullanıcının telefon numarası
facebookAnonymousIdStringKullanıcının Facebook Ads entegrasyonundaki kimliği
amplitudeUserIdStringKullanıcının Amplitude entegrasyonundaki kimliği
amplitudeDeviceIdStringKullanıcının cihazının Amplitude entegrasyonundaki kimliği
mixpanelUserIdStringKullanıcının Mixpanel entegrasyonundaki kimliği
appmetricaProfileIdStringKullanıcının AppMetrica entegrasyonundaki kimliği
appmetricaDeviceIdStringKullanıcının cihazının AppMetrica entegrasyonundaki kimliği
oneSignalPlayerIdStringKullanıcının OneSignal entegrasyonundaki kimliği
pushwooshHWIDStringKullanıcının cihazının Pushwoosh entegrasyonundaki kimliği
firebaseAppInstanceIdStringKullanıcının Firebase entegrasyonundaki kimliği
airbridgeDeviceIdStringKullanıcının cihazının Airbridge entegrasyonundaki kimliği
appTrackingTransparencyStatusAdaptyATTStatusIDFA erişiminin durumu (iOS için kullanın)
analyticsDisabledBooleanKullanıcı için harici analitiğin devre dışı bırakılıp bırakılmadığını belirtir
customStringAttributesList < Data (AdaptyCustomStringAttribute) >Kullanıcının özel string özelliklerinin listesi
customDoubleAttributesList < Data (AdaptyCustomDoubleAttribute) >Kullanıcının özel double özelliklerinin listesi

AdaptySubscription

Kullanıcının mevcut aboneliğine ilişkin bilgiler.

Alan AdıTürAçıklama
activatedAtDateTimeBu aboneliğin etkinleştirildiği zaman
activeIntroductoryOfferTypeStringAktif başlangıç teklifinin türü. Ayarlanmışsa, bu abonelik döneminde bir teklif uygulandığı anlamına gelir
activePromotionalOfferIdStringAktif promosyon teklifinin kimliği (iOS için kullanın)
activePromotionalOfferTypeStringAktif promosyon teklifinin türü (iOS için kullanın). Ayarlanmışsa, bu abonelik döneminde bir teklif uygulandığı anlamına gelir
cancellationReasonStringAboneliğin iptal edilme nedeni
expiresAtDateTimeAboneliğin sona erme zamanı
renewedAtDateTimeAboneliğin en son yenilendiği zaman
unsubscribedAtDateTimeAbonelik için otomatik yenilemenin kapatıldığı zaman. Abonelik hâlâ aktif olabilir. Ayarlanmamışsa, kullanıcı aboneliği yeniden etkinleştirmiştir
billingIssueDetectedAtDateTimeÖdeme sorununun tespit edildiği zaman. Abonelik hâlâ aktif olabilir. Ödeme başarıyla işlenirse null olarak ayarlanır
isActiveBooleanBu abonelik aktifse True. Genel olarak, kullanıcının premium özelliklere erişimi olup olmadığını belirlemek için bu özelliği kontrol edebilirsiniz
isInGracePeriodBooleanBu otomatik yenilenen abonelik ek süre içindeyse True
isLifetimeBooleanBu abonelik süresiz erişim için aktifse True (son kullanma tarihi yok)
isRefundBooleanBu satın alma iade edildiyse True
isSandboxBooleanÜrünün sandbox ortamında satın alınıp alınmadığını gösterir
offerIdStringAktif promosyon teklifinin kimliği (Android için kullanın)
startsAtDateTimeBu access level’ın başlangıç zamanı (gelecekte olabilir)
storeStringÜrünün satın alındığı mağaza (ör. App Store, Google Play)
vendorOriginalTransactionIdStringSatıcı sistemindeki ilk aboneliğin kimliği
vendorProductIdStringSatıcı sistemindeki ürünün kimliği
vendorTransactionIdStringSatıcı sistemindeki işlem kimliği
willRenewBooleanBu otomatik yenilenen abonelik yenilenecek şekilde ayarlandıysa True

AdaptySubscriptionDetails

AdaptyPaywallProduct nesnesinin bir parçası olan Subscription nesnesinin şeması.

Alan AdıTürAçıklama
androidBasePlanIdStringGoogle Play Store’daki temel plan ID’si veya Stripe’taki fiyat ID’si.
androidIntroductoryOfferEligibilityAdaptyEligibilityEnumKullanıcının bir iOS aboneliği için başlangıç teklifine uygun olup olmadığının tanımı
androidOfferIdStringEtkin bir promosyon teklifinin ID’si (Android için kullanın)
androidOfferTagsList < String >Temel planlar ve abonelik teklifleri için belirtilen özel etiketlerin listesi.
introductoryOfferList < Data (AdaptySubscriptionPhase) >Başlangıç teklifinin ID’si (iOS için kullanın)
localizedSubscriptionPeriodStringKullanıcının dilinde abonelik dönemi
promotionalOfferData (AdaptySubscriptionPhase)Promosyon teklifi ayrıntıları (iOS için kullanın)
promotionalOfferEligibilityBooleanKullanıcının bir iOS aboneliği için promosyon teklifine uygun olup olmadığının tanımı
promotionalOfferIdStringPromosyon teklifinin ID’si (iOS için kullanın)
renewalTypeAdaptyRenewalTypeEnumAboneliğin otomatik yenilenip yenilenmediğini AdaptyRenewalTypeEnum aracılığıyla tanımlar
subscriptionGroupIdentifierStringÜrünün ait olduğu ürün grubunun ID’si (iOS için kullanın)
subscriptionPeriodData (AdaptySubscriptionPeriod)Aboneliğin süresi

AdaptySubscriptionPeriod

Aboneliğin süresi.

Alan AdıTürAçıklama
numberOfUnitsIntegerAboneliğin kaç gün/hafta/ay/yıl süreceği.
unitAdaptyPeriodUnitEnumDönemin ölçüm birimi: gün, hafta, ay veya yıl.

AdaptySubscriptionPhase

Bir abonelik aşamasını temsil eder; örneğin ücretsiz deneme veya başlangıç teklifi dönemi.

Alan AdıTürAçıklama
identifierStringAşamanın ID’si
localizedNumberOfPeriodsStringAşamanın süresi. Örneğin, 6 aylık bir teklif kullanıcının dilinde 6 months olarak görüntülenir.
localizedSubscriptionPeriodStringKullanıcının dilinde abonelik süresi, örneğin 3 months.
numberOfPeriodsIntegerBu aşamadaki abonelik dönemi sayısı. Örneğin, 6 aylık bir teklifin iki adet 3 aylık dönemi olur.
paymentModeAdaptyPaymentModeEnumBu aşama için kullanılan ödeme modeli.
priceData (AdaptyPrice)Bu aşamanın fiyatı.
subscriptionPeriodData (AdaptySubscriptionPeriod)Bu aşamanın dayandığı abonelik dönemi.

AdaptySubscriptionUpdateParameters

(Yalnızca Android) Bir aboneliği başka bir abonelikle değiştirmek için kullanılan parametreler.

Alan AdıTürAçıklama
oldSubVendorProductIdStringPlay Store’da değiştirmek istediğiniz mevcut aboneliğin ID’si.
replacementModeAdaptySubscriptionUpdateReplacementModeBillingFlowParams.ProrationMode değerlerine karşılık gelen enum.

MapKeyNonSubscriptions

AdaptyNonSubscription için bir sözlüğün yerine geçer.

Alan AdıTür
keyString
valueList < Data (AdaptyNonSubscription) >

MapKeySubscriptions

AdaptySubscription için bir sözlüğün yerine geçen yapı.

Alan AdıTür
keyString
valueList < Data (AdaptySubscription) >

Enum’lar

Adapty plugin’i aracılığıyla FlutterFlow’a iletilen Adapty enum’ları (önceden tanımlanmış sabitler kümesi olan değişkenler).

AdaptyEligibilityEnum

Kullanıcının bir iOS aboneliği için başlangıç teklifine uygun olup olmadığını belirtir.

Alan AdıAçıklama
eligibleKullanıcı başlangıç teklifine uygundur, bu bilgiyi arayüzünüzde göstermek güvenlidir
ineligibleKullanıcı herhangi bir teklif almaya uygun değildir, arayüzünüzde göstermemelisiniz
notApplicableBu ürün bir teklif sunacak şekilde yapılandırılmamıştır

AdaptyGenderEnum

Kullanıcının cinsiyetini tanımlar.

Alan AdıAçıklama
noneCinsiyet belirlenmemiş
femaleKullanıcının cinsiyeti kadın
maleKullanıcının cinsiyeti erkek
OtherKullanıcı cinsiyetini “diğer” olarak belirlemiş

AdaptyPaymentModeEnum

Ödeme modelini tanımlar.

Alan AdıAçıklama
payAsYouGoMüşterilerin sabit bir ücret ödemek yerine, ürün/hizmeti gerçek kullanımlarına göre faturalandırıldığı bir fiyatlandırma modeli
payUpFrontMüşterilerin ürün/hizmeti almadan önce faturalandırıldığı bir fiyatlandırma modeli.
freeTrialKullanıcı ücretsiz deneme sürecinde
unknownFiyatlandırma modeli tanımlanmamış

AdaptyPeriodUnitEnum

Dönemlerin ölçüldüğü birimleri tanımlar.

Alan AdıAçıklama
dayGün cinsinden
weekHafta cinsinden
monthAy cinsinden
yearYıl cinsinden
unknownTanımsız

AdaptyRenewalTypeEnum

Aboneliğin otomatik yenilenip yenilenmediğini tanımlar.

Alan AdıAçıklama
prepaidAbonelik ön ödemeli ve otomatik yenilenmiyor.
autorenewableAbonelik otomatik yenileniyor.

AdaptySubscriptionUpdateReplacementMode

Android için abonelik güncelleme modunu tanımlar.

Alan AdıAçıklama
withTimeProration(varsayılan) Yeni plan hemen devreye girer ve kalan süre orantılı hesaplanarak kullanıcıya kredi olarak yansıtılır.
chargeProratedPriceYeni plan hemen devreye girer ve faturalama döngüsü aynı kalır. Kalan süre için ücret tahsil edilir. Bu seçenek yalnızca abonelik yükseltmelerinde kullanılabilir.
withoutProrationYeni plan hemen devreye girer ve yeni fiyat bir sonraki yenileme tarihinde tahsil edilir. Faturalama döngüsü aynı kalır.
deferredYeni satın alma hemen geçerli olur; yeni plan ise mevcut öğenin süresi dolduğunda devreye girer.
chargeFullPriceYeni plan hemen devreye girer ve faturalama döngüsü aynı kalır. Kalan süre için ücret tahsil edilir. Bu seçenek yalnızca abonelik yükseltmelerinde kullanılabilir.

Uygulama Durumları

Uygulama durumu değişkenleri, bir uygulamanın mevcut durumunu tutan özel değişkenlerdir. Tüm sayfalar ve bileşenler genelinde, uygulamanın her yerinden erişilebilir ve değiştirilebilirler. Bu tür değişkenler; kullanıcı tercihleri ve kimlik doğrulama token’ları gibi uygulamanın farklı bölümleri arasında paylaşılması gereken verileri saklamak için kullanışlıdır.

Alan AdıVeri TipiKalıcıAçıklama
currentProfileData (AdaptyProfile)FalseMevcut kullanıcı profiline ait bilgileri içeren değişken. Güncel tutun.