Purchasely
Rechercher…
3.2
General
Basic configuration
S2S notifications
Analytics
Integrations
Advanced Features
TESTING
Paywall only mode
This mode is made to use Purchasely solely for paywalls display.
When to use it ?
In this mode, Purchasely allows you to modify your paywall remotely and gain much flexibility to iterate on your user flows and still keep your legacy transaction processor in place.
If you only have a "one size fits all" paywall in your app and want to optimize your subscription flows and increase your conversion by iterating swiftly on the paywalls, without changing the way transactions are processed, this mode is meant for you.
Purchasely won't perform purchases and won't observe transactions. The dashboards will thus be empty.
What you can do in this mode ?
You can:
- display paywalls and modify them remotely
- create as many paywalls as you need and multiply the touch points
To display paywalls, Purchasely will provide (or display) controllers / fragments and will also let you handle purchases thanks to the action interceptor. You will be notified when the user taps on a purchase button and you will be able to perform the purchase with your own code.
General overview
Implementation
1- Start the SDK
The first thing you need to do is to call the
start method passing the mode paywallOnly / PLYRunningModePaywallOnly.
View implementation details2- Set user identifier
We need to know whenever a user is logged in or logged out to:
- Hide the login button in the paywalls
- Check if the user already used a trial and display the correct price
3- Configure your catalog of in-app purchases and subscriptions
To be able to display paywalls, the catalog of IAP must be configured into the Purchasely Console. Each product must be mapped with the corresponding SKU in the different app stores.
4- Configure and present paywalls
To display a paywall, you need to can get a Controller / Fragment from Purchasely.
Then you must use the Paywall Actions Interceptor to perform the purchase triggered from Purchasely's paywalls with your purchase system.
Here is an example where
MyPurchaseSystem is your internal subscription management system.Swift
Objective-C
Kotlin
Java
ReactNative
Cordova
Flutter
1
Purchasely.setPaywallActionsInterceptor { [weak self] (action, parameters, presentationInfos, proceed) in
2
switch action {
3
// Intercept the tap on purchase to display the terms and condition
4
case .purchase:
5
// Grab the plan to purchase
6
guard let plan = parameters?.plan, let appleProductId = plan.appleProductId else {
7
proceed(false)
8
return
9
}
10
11
MyPurchaseSystem.purchase(appleProductId) { (success, error) {
12
// We handle the purchase so we tell Purchasley not to handle it
13
proceed(false)
14
if success {
15
presentationInfos?.controller?.dismiss(animated: true, completion: nil)
16
}
17
}
18
19
default:
20
proceed(true)
21
}
22
}
Copied!
1
[Purchasely setPaywallActionsInterceptor:^(enum PLYPresentationAction action, PLYPresentationActionParameters *parameters, PLYPresentationInfo *presentationInfos, void (^ proceed)(BOOL)) {
2
switch (action) {
3
// Intercept the tap on purchase to display the terms and condition
4
case PLYPresentationActionPurchase:{
5
// Grab the plan to purchase
6
NSString *appleProductId = parameters.plan.appleProductId;
7
8
if (appleProductId == nil) {
9
proceed(NO);
10
return;
11
}
12
13
[MyPurchaseSystem purchase:appleProductId completion:^(BOOL success, NSError *Error) {
14
// We handle the purchase so we tell Purchasely not to handle it
15
proceed(false);
16
if (success) {
17
[presentationInfos.controller dismissViewControllerAnimated:YES completion:nil];
18
}
19
}];
20
21
break;
22
}
23
default:
24
proceed(YES);
25
break;
26
}
27
}];
Copied!
1
Purchasely.setPaywallActionsInterceptor { info, action, parameters, processAction ->
2
if (info?.activity == null) return@setPaywallActionsInterceptor
3
4
when(action) {
5
PLYPresentationAction.PURCHASE -> {
6
Purchasely.plan("PLAN_VENDOR_ID",
7
onSuccess = { plan ->
8
MyPurchaseSystem.purchase(plan.store_product_id)
9
processAction(false)
10
},
11
onError = { throwable ->
12
//display an error
13
processAction(false)
14
}
15
)
16
}
17
else -> processAction(true)
18
}
19
}
Copied!
1
Purchasely.setPaywallActionsInterceptor((info, action, parameters, listener) -> {
2
switch (action) {
3
case PURCHASE:
4
Purchasely.plan("PLAN_VENDOR_ID", new PlanListener() {
5
@Override
6
public void onSuccess(@Nullable PLYPlan plan) {
7
MyPurchaseSystem.purchase(plan.store_product_id);
8
listener.processAction(false);
9
}
10
11
@Override
12
public void onFailure(@NotNull Throwable throwable) {
13
//display an error
14
listener.processAction(false);
15
}
16
});
17
break;
18
default:
19
listener.processAction(true);
20
}
21
});
Copied!
1
Purchasely.setPaywallActionInterceptorCallback((result) => {
2
if (result.action === PLYPaywallAction.PURCHASE) {
3
try {
4
const plan = await Purchasely.planWithIdentifier('PLAN_VENDOR_ID');
5
6
//If you want to intercept it, close paywall and display your screen
7
Purchasely.closePaywall();
8
9
MyPurchaseSystem.purchase(plan.productId)
10
11
Purchasely.onProcessAction(false);
12
} catch (e) {
13
console.log(e);
14
Purchasely.onProcessAction(false);
15
}
16
} else {
17
Purchasely.onProcessAction(true);
18
}
19
});
Copied!
1
Purchasely.setPaywallActionInterceptorCallback((result) => {
2
if (result.action === Purchasely.PaywallAction.purchase) {
3
Purchasely.planWithIdentifier('PLAN_VENDOR_ID', (plan) => {
4
//If you want to intercept it, close paywall and display your screen
5
Purchasely.closePaywall();
6
7
MyPurchaseSystem.purchase(plan.productId)
8
9
Purchasely.onProcessAction(false);
10
}, (error) => {
11
Purchasely.onProcessAction(false);
12
});
13
} else {
14
Purchasely.onProcessAction(true);
15
}
16
});
Copied!
1
Purchasely.setPaywallActionInterceptorCallback(
2
(PaywallActionInterceptorResult result) {
3
if (result.action == PLYPaywallAction.purchase) {
4
try {
5
var plan = await Purchasely.planWithIdentifier('PLAN_VENDOR_ID');
6
7
//If you want to intercept it, close paywall and display your screen
8
Purchasely.closePaywall();
9
10
MyPurchaseSystem.purchase(plan.productId)
11
12
Purchasely.onProcessAction(false);
13
} catch (e) {
14
print(e);
15
Purchasely.onProcessAction(false);
16
}
17
} else {
18
Purchasely.onProcessAction(true);
19
}
20
});
Copied!
5- Configure deeplinks (optional)
Paywalls can be used in many othe ways that can be:
- Push notifications deeplinks
Dernière mise à jour 5mo ago