Adapty Resources
Custom Actions
Below are Adapty methods delivered to FlutterFlow with Adapty plugin. They can be used as custom actions in FlutterFlow.
Custom Action | Description | Action Arguments | Adapty Data Types - Action Output Variable |
---|---|---|---|
activate | Initializes the Adapty SDK | None | |
getPaywall | Retrieves a paywall. It does not return paywall products. Use the getPaywallProducts action to get the actual products | AdaptyGetPaywallResult | |
getPaywallProducts | Returns a list of actual paywall products | AdaptyPaywall | AdaptyGetProductsResult |
getProductsIntroductoryOfferEligibility | Checks if the user qualifies for an introductory iOS subscription offer | AdaptyPaywallProduct | AdaptyGetIntroEligibilitiesResult |
makePurchase | Completes a purchase and unlocks content. If a paywall has a promotional offer, Adapty automatically applies it at checkout |
| AdaptyMakePurchaseResult |
getProfile | Retrieves the current app user's profile. This allows you to set access levels and other parameters If it fails (e.g., due to no internet), cached data will be returned. Adapty regularly updates the profile cache to ensure the information stays as current as possible | None | AdaptyGetProfileResult |
updateProfile | Changes optional attributes of the current user profile such as email, phone number, etc. You can later use attributes to create user segments or just view them in CRM | The ID and any parameters that need to be updated for the AdaptyProfile | AdaptyError (Optional) |
restorePurchases | Restores any purchases the user has made | None | AdaptyGetProfileResult |
logShowPaywall | Logs when a specific paywall is shown to the user | AdaptyPaywall | AdaptyError (Optional) |
logShowOnboarding | Tracks users' steps during the onboarding process. The onboarding stage is a crucial part of modern mobile apps. The effectiveness of its implementation, the quality of the content, and the number of steps can significantly impact user behavior, particularly their willingness to subscribe or make purchases. To help you analyze user behavior during this critical phase without leaving Adapty, we’ve added the capability to send dedicated events every time a user navigates to a new onboarding screen. |
| AdaptyError (Optional) |
identify | Identifies the user using your system's customerUserId | customerUserId | AdaptyError (Optional) |
logout | Logs the current user out of your app | None | AdaptyError (Optional) |
presentCodeRedemptionSheet | Displays a sheet that allows users to redeem codes (iOS only) | None | None |
Data Types
Adapty data types (collections of data values) delivered to FlutterFlow with Adapty plugin.
AdaptyAccessLevel
Information about the user's access level.
Field Name | Type | Description |
---|---|---|
activatedAt | DateTime | The time when this access level was activated |
activeIntroductoryOfferType | String | The type of an active introductory offer. If set, it means an offer was applied during this subscription period |
activePromotionalOfferId | String | The ID of an active promotional offer (purchased from iOS) |
activePromotionalOfferType | String | The type of an active promotional offer (purchased from iOS). If set, it means an offer was applied during this subscription period |
billingIssueDetectedAt | DateTime | The time when a billing issue was detected. The subscription can still be active. Set to null if payment is successfully processed |
cancellationReason | String | The reason why the subscription was canceled |
expiresAt | DateTime | The access level expiration time (could be in the past or not set for lifetime access) |
id | String | The identifier of the access level |
isActive | Boolean | True if this access level is active. Generally, you can check this property to determine if a user has an access to premium features |
isInGracePeriod | Boolean | True if this auto-renewable subscription is in the grace period |
isLifetime | Boolean | True if this access level is active for a lifetime (no expiration date) |
isRefund | Boolean | True if this purchase was refunded |
offerId | String | The ID of an active promotional offer (purchased from Android) |
renewedAt | DateTime | The time when the access level was last renewed |
startsAt | DateTime | The start time of this access level (could be in the future) |
store | String | The store where the purchase was made |
unsubscribedAt | DateTime | The time when auto-renewal was turned off for the subscription. The subscription can still be active. If not set, the user reactivated the subscription |
vendorProductId | String | The product ID from the store that unlocked this access level |
willRenew | Boolean | True if this auto-renewable subscription is set to renew |
AdaptyAccessLevelIdentifiers
This struct is intended to replace key-value pair for Map<String, AdaptyAccessLevel
AdaptyAccessLevel.
Field Name | Type | Description |
---|---|---|
accessLevelIdentifier | String | The ID of the access level |
accessLevel | Data (AdaptyAccessLevel) | The associated AdaptyAccessLevel |
AdaptyCustomDoubleAttribute
Information on custom double attributes defined for the user.
Field Name | Type | Description |
---|---|---|
key | String | The ID of the custom double attribute |
value | Double | The value of the custom double attribute |
AdaptyCustomStringAttribute
Information on custom string attributes defined for the user.
Field Name | Type | Description |
---|---|---|
key | String | The ID of the custom string attribute |
value | String | The value of the custom string attribute |
AdaptyError
Contains details about an error. For a complete list of error codes, refer to Flutter, React Native, Unity - Handle errors.
Field Name | Type | Description |
---|---|---|
errorMessage | String | A human-readable description of the error |
errorCode | Integer | Numeric code identifying the error |
AdaptyGetIntroEligibilitiesResult
Contains the result of the getProductsIntroductoryOfferEligibility
custom action.
Field Name | Type | Description |
---|---|---|
value | List < Data (AdaptyProductIntroEligibility) > | List of the user's eligibility for promotional offers |
error | Data (AdaptyError) | Contains details about the error via AdaptyError |
AdaptyGetPaywallResult
Contains the result of the getPaywall
custom action.
Field Name | Type | Description |
---|---|---|
value | Data (AdaptyPaywall) | Contains a list of AdaptyPaywall objects |
error | Data (AdaptyError) | Contains error information via AdaptyError |
AdaptyGetProductsResult
Contains the result of the getPaywallProducts
custom action.
Field Name | Type | Description |
---|---|---|
value | List < Data (AdaptyPaywallProduct) > | Contains a list of AdaptyPaywallProducts |
error | Data (AdaptyError) | Contains error information via AdaptyError |
AdaptyGetProfileResult
Contains the result of the getProfile
custom action.
Field Name | Type | Description |
---|---|---|
value | Data (AdaptyProfile) | Contains the user profile as an AdaptyProfile |
error | Data (AdaptyError) | Contains error information via AdaptyError |
AdaptyMakePurchaseResult
Contains the result of the makePurchase
custom action.
Field Name | Type | Description |
---|---|---|
value | Data (AdaptyProfile) | Contains the user's profile as an AdaptyProfile |
error | Data (AdaptyError) | Contains error information via AdaptyError |
AdaptyNonSubscription
Information about non-subscription purchases. These can be one-time (consumable) products, unlocks (like new map unlock in the game), etc.
Field Name | Type | Description |
---|---|---|
isConsumable | Boolean | Indicates whether the product is consumable |
isOneTime | Boolean | Indicates if the product is a one-time purchase (e.g., if true, the purchase is processed only once) |
isRefund | Boolean | Indicates if the product has been refunded |
isSandbox | Boolean | Indicates if the product was purchased in a sandbox environment |
purchasedAt | DateTime | The time when the product was purchased |
purchaseId | String | The ID of the purchase in Adapty. Can be used for tracking one-time products |
store | String | The store where the product was purchased (e.g., App Store, Google Play) |
vendorProductId | String | ID of the product in vendor's system |
vendorTransactionId | String | Transaction ID in the vendor's system |
AdaptyPaywall
Information about a paywall.
Field Name | Type | Description |
---|---|---|
abTestName | String | The name of the parent A/B test |
hasViewConfiguration | Boolean | Indicates if there is a view configuration for the paywall |
locale | String | The locale ID of the paywall |
name | String | Paywall name |
placementId | String | The ID of the parent placement |
remoteConfigString | String | A custom dictionary from Adapty Dashboard associated with this paywall |
revision | Integer | The current revision/version of the paywall. Every change generates a new revision |
variationId | String | The variation ID used to attribute purchases to this paywall |
vendorProductIds | String | Array of product IDs related to the paywall |
AdaptyPaywallProduct
Information about product.
Field Name | Type | Description |
---|---|---|
vendorProductId | String | The ID of a product from an app store |
localizedDescription | String | A description of the product in the user's language |
localizedTitle | String | The name of the product in the user's language |
regionCode | String | The region code of the locale used to format the price of the product (use for iOS) |
isFamilyShareable | Boolean | A Boolean value that indicates whether the product is available for family sharing in App Store Connect. Will be always FALSE for iOS version below 14.0 and macOS version below 11.0 (use for iOS) |
paywallVariationId | String | The ID of a variation, used to attribute purchases to this paywall |
paywallABTestName | String | Parent A/B test name |
paywallName | String | Parent paywall name |
price | Data (AdaptyPriceData) | The price of the product |
subscriptionDetails | Data (AdaptySubscriptionDetails) | Information on subscription |
AdaptyPrice
Information about product price.
Field Name | Type | Description |
---|---|---|
amount | Double | The numeric value of the price |
currencyCode | String | The code of the price currency |
currencySymbol | String | The symbol used for the currency |
localizedString | String | The price displayed in the user's language |
AdaptyProductIntroEligibility
Defines if the user qualifies for an introductory offer for an iOS subscription.
Field Name | Type | Description |
---|---|---|
vendorProductId | String | The ID of a product from an app store |
eligibility | AdaptyEligibilityEnum | Definition if the user qualifies for an introductory offer for an iOS subscription |
AdaptyProductNonsubscriptions
Details of the active non-subscription tied to this product.
Field Name | Type | Description |
---|---|---|
productId | String | The ID of the product from an app store |
nonsubscriptions | AdaptyNonSubscription | Information about non-subscription purchases. These can be one-time (consumable) products, unlocks (like new map unlock in the game), etc. |
AdaptyProductSubscriptions
Details of the active subscription tied to this product.
Field Name | Type | Description |
---|---|---|
productId | String | The ID of the product from an app store |
subscription | AdaptySubscription | Information about subscription purchases |
AdaptyProfile
Information on the user's profile
Field Name | Type | Description |
---|---|---|
accessLevels | List < Data (AdaptyAccessLevelIdentifiers) > | List of all access levels that belong to the user |
profileId | String | The ID of the user profile |
customerUserId | String | The ID of the user in the vendor's system |
subscriptions | List < Data (MapKeySubscriptions) > | The list of all subscriptions purchased by the user |
nonSubscriptions | List < Data (MapKeyNonSubscriptions) > | The list of all non-subscription products purchased by the user |
AdaptyProfileParameters
Information on the user.
Field Name | Type | Description |
---|---|---|
firstName | String | The first name of the user |
lastName | String | The last name of the user |
gender | AdaptyGenderEnum | The gender of the user |
birthday | String | The birthday of the user |
String | The email of the user | |
phoneNumber | String | The phone number of the user |
facebookAnonymousId | String | The ID of the user in Facebook Ads integration |
amplitudeUserId | String | The ID of the user in Amplitude integration |
amplitudeDeviceId | String | The ID of the user's device in Amplitude integration |
mixpanelUserId | String | The ID of the user in Mixpanel integration |
appmetricaProfileId | String | The ID of the user in AppMetrica integration |
appmetricaDeviceId | String | The ID of the user's device in AppMetrica integration |
oneSignalPlayerId | String | The ID of the user in OneSignal integration |
pushwooshHWID | String | The ID of the user's device in Pushwoosh integration |
firebaseAppInstanceId | String | The ID of the user in Firebase integration |
airbridgeDeviceId | String | The ID of the user's device in Airbridge integration |
appTrackingTransparencyStatus | AdaptyATTStatus | The status of the access to IDFA (use for iOS) |
analyticsDisabled | Boolean | Definition if the external analytics is opted out for the user |
customStringAttributes | List < Data (AdaptyCustomStringAttribute) > | List of custom string attributes of the user |
customDoubleAttributes | List < Data (AdaptyCustomDoubleAttribute) > | List of custom double attributes of the user |
AdaptySubscription
Information on existing user subscription.
Field Name | Type | Description |
---|---|---|
activatedAt | DateTime | The time when this subscription was activated |
activeIntroductoryOfferType | String | The type of an active introductory offer. If set, it means an offer was applied during this subscription period |
activePromotionalOfferId | String | The ID of an active promotional offer (use for iOS) |
activePromotionalOfferType | String | The type of an active promotional offer (use for iOS). If set, it means an offer was applied during this subscription period |
cancellationReason | String | The reason why the subscription was canceled |
expiresAt | DateTime | The subscription expiration time |
renewedAt | DateTime | The time when the subscription was last renewed |
unsubscribedAt | DateTime | The time when auto-renewal was turned off for the subscription. The subscription can still be active. If not set, the user reactivated the subscription |
billingIssueDetectedAt | DateTime | The time when a billing issue was detected. The subscription can still be active. Set to null if payment is successfully processed |
isActive | Boolean | True if this subscription is active. Generally, you can check this property to determine if a user has access to premium features |
isInGracePeriod | Boolean | True if this auto-renewable subscription is in the grace period |
isLifetime | Boolean | True if this subscription is active for a lifetime (no expiration date) |
isRefund | Boolean | True if this purchase was refunded |
isSandbox | Boolean | Indicates if the product was purchased in a sandbox environment |
offerId | String | The ID of an active promotional offer (use for Android) |
startsAt | DateTime | The start time of this access level (could be in the future) |
store | String | The store where the product was purchased (e.g., App Store, Google Play) |
vendorOriginalTransactionId | String | ID of the initial subscription in vendor's system |
vendorProductId | String | ID of the product in vendor's system |
vendorTransactionId | String | Transaction ID in the vendor's system |
willRenew | Boolean | True if this auto-renewable subscription is set to renew |
AdaptySubscriptionDetails
Scheme of a Subscription object as a part of the AdaptyPaywallProduct.
Field Name | Type | Description |
---|---|---|
androidBasePlanId | String | Base plan ID in the Google Play Store or price ID in Stripe. |
androidIntroductoryOfferEligibility | AdaptyEligibilityEnum | Definition if the user qualifies for an introductory offer for an iOS subscription |
androidOfferId | String | The ID of an active promotional offer (use for Android) |
androidOfferTags | List < String > | List of custom tags specified for base plans and subscription offers. |
introductoryOffer | List < Data (AdaptySubscriptionPhase) > | The ID of an introductory offer (use for iOS) |
localizedSubscriptionPeriod | String | The period of the subscription in the user's language |
promotionalOffer | Data (AdaptySubscriptionPhase) | The promotional offer details (use for iOS) |
promotionalOfferEligibility | Boolean | Definition if the user qualifies for an promotional offer for an iOS subscription |
promotionalOfferId | String | The ID of the promotional offer (use for iOS) |
renewalType | AdaptyRenewalTypeEnum | Defines if the subscription is auto-renewable or not via AdaptyRenewalTypeEnum |
subscriptionGroupIdentifier | String | The ID of the product group the product belongs to (use for iOS) |
subscriptionPeriod | Data (AdaptySubscriptionPeriod) | The duration of the subscription |
AdaptySubscriptionPeriod
The duration of the subscription.
Field Name | Type | Description |
---|---|---|
numberOfUnits | Integer | Number of days/weeks/months/years the subscription lasts. |
unit | AdaptyPeriodUnitEnum | Measurement unit of the period: days, weeks, months, years. |
AdaptySubscriptionPhase
Represents a subscription phase, such as a free trial or an introductory offer period.
Field Name | Type | Description |
---|---|---|
identifier | String | The ID of the phase |
localizedNumberOfPeriods | String | The length of the phase. For example, a 6-month offer would display as 6 months in the user's language. |
localizedSubscriptionPeriod | String | The subscription duration in the user's language, like 3 months . |
numberOfPeriods | Integer | The number of subscription periods in this phase. For instance, a 6-month offer would have two 3-month periods. |
paymentMode | AdaptyPaymentModeEnum | The payment model used for this phase. |
price | Data (AdaptyPrice) | The price of this phase. |
subscriptionPeriod | Data (AdaptySubscriptionPeriod) | The subscription period on which this phase is based. |
AdaptySubscriptionUpdateParameters
(Android only) Parameters for replacing one subscription with another.
Field Name | Type | Description |
---|---|---|
oldSubVendorProductId | String | The ID of the current subscription in the Play Store that you want to replace. |
replacementMode | AdaptySubscriptionUpdateReplacementMode | Enum that corresponds to BillingFlowParams.ProrationMode values. |
MapKeyNonSubscriptions
Replacement for a dictionary for AdaptyNonSubscription.
Field Name | Type |
---|---|
key | String |
value | List < Data (AdaptyNonSubscription) > |
MapKeySubscriptions
Replacement for a dictionary for AdaptySubscription.
Field Name | Type |
---|---|
key | String |
value | List < Data (AdaptySubscription) > |
Enums
Adapty enums (variables that are sets of predefined constants) delivered to FlutterFlow with the Adapty plugin.
AdaptyEligibilityEnum
Defines if the user qualifies for an introductory offer for an iOS subscription.
Field Name | Description |
---|---|
eligible | The user is eligible for an intro offer, it is safe to reflect this info in your UI |
ineligible | The user is not eligible to get any offer, you shouldn't present it in your UI |
notApplicable | This product is not configured to have an offer |
AdaptyGenderEnum
Defines user's gender.
Field Name | Description |
---|---|
none | The gender is not set |
female | User's gender is female |
male | User's gender is male |
Other | The user has defined their gender as "other" |
AdaptyPaymentModeEnum
Defines the payment model.
Field Name | Description |
---|---|
payAsYouGo | A pricing model where customers are billed based on their actual usage or consumption of a product/service, rather than paying for a fixed fee upfront |
payUpFront | A pricing model where customers are billed before they receive the product/service. |
freeTrial | User is on a free trial period |
unknown | Pricing model is not defined |
AdaptyPeriodUnitEnum
Defines the units in which the periods are measured.
Field Name | Description |
---|---|
day | In days |
week | In weeks |
month | In months |
year | In years |
unknown | Not defined |
AdaptyRenewalTypeEnum
Defines if the subscription is auto-renewable or not.
Field Name | Description |
---|---|
prepaid | The subscription is prepaid and not auto-renewable. |
autorenewable | The subscription is auto-renewable |