launch

📱

Launch a Campaign to Show a Paywall

Open Recipe

NamiCampaignManager.launch()

NamiCampaignManager.launch(activity: Activity)

NamiCampaignManager.launch();

import {NamiCampaignManager, NamiCampaign} from 'react-native-nami-sdk';

NamiCampaignManager.launch('', (success, error) => {
  console.log('success', success);
  console.log('error', error);
});

NamiCampaignManager.Launch();

Launch a campaign with the specified label

NamiCampaignManager.launch(label: String)

NamiCampaignManager.launch(activity: Activity, label: String)

NamiCampaignManager.launch(label: "onboarding");

NamiCampaignManager.launch('onboarding', (success, error) => {
  console.log('success', success);
  console.log('error', error);
});

NamiCampaignManager.Launch("onboarding");

Parameters

label - a string matching the label set in the Control Center

Launch a campaign with a result callback

This can be used to know if the launch succeeded or failed to raise a paywall.
Additionally, you can use this to monitor for purchase change events to observe what the outcomes of any system purchase flows initiated from the campaign launch.

NamiCampaignManager.launch(label: "a_label", launchHandler: { success, error in
   // callback with success (bool) or error (LaunchCampaignError)               
})

NamiCampaignManager.launch(activity, "a_label") { result ->
    when (result) {
        is LaunchCampaignResult.Success -> {
          // success
        }
        is LaunchCampaignResult.Failure -> {
          // fail
            Log.d(LOG_TAG, "Launch Campaign Error -> ${result.error}")
        }
        is LaunchCampaignResult.PurchaseChanged -> {
            Log.d(
                LOG_TAG,
                "Launch Campaign Result - Purchase changed -> ${result.purchaseState}"
            )

            if (result.purchaseState == NamiPurchaseState.PURCHASED) {
                Log.d(
                    LOG_TAG,
                    "NamiPurchaseState - Purchased -> ${result.activePurchases}"
                )
            }
        }     
    }
}

// Launch the campaign, with a label, and use of an error handler
LaunchCampaignResult result;
result = await NamiCampaignManager.launch(label: "onboarding");
if (result.success) {
  print("Launch campaign - success");
} else {
  print("Launch campaign - error");
}

import {NamiCampaignManager, NamiCampaign} from 'react-native-nami-sdk';

NamiCampaignManager.launch(
  label,
  (successAction, error) => {
    console.log('successAction', successAction);
    console.log('error', error);
  });

// Launch a campaign with an error handler
var launchHandler = new LaunchHandler((isSuccess, errorMsg) =>
{
    // on launch
});
NamiCampaignManager.Launch("onboarding", launchHandler);

Launch a campaign with paywall interaction callback

Use this to monitor user interactions with the paywall raised by this campaign launch. Returns NamiPaywallAction events and an optional skuId if relevant to the action.

NamiCampaignManager.launch(label: label, launchHandler: { success, error in
        print("campaign launch - success \(success) or error \(error)")
    },
        paywallActionHandler: { action, skuId, purchaseError, purchases -> () in

            switch action {
            case .close_paywall:
                print("Launched paywall action - paywall closed")

            case .restore_purchases:
                print("Launched paywall action - restore purchases tapped")

            case .sign_in:
                print("Launched paywall action - sign in tapped")

            case .buy_sku:
                print("Launched paywall action - buy sku tapped with sku: \(String(describing: skuId))")

            case .select_sku:
                print("Launched paywall action - sku selected: \(String(describing: skuId))")

            case .purchase_selected_sku:
                print("Launched paywall action - purchase flow started with selected sku: \(String(describing: skuId))")

            case .purchase_success:
                print("purchase success")

            case .purchase_cancelled:
                print("purchase cancelled")

            case .purchase_failed:
                print("purchase failed - error \(String(describing: purchaseError))")
              
            default:
                print("Launched paywall action - unknown \(action.rawValue) skuId: \(String(describing: skuId))")
            }
    })

// Launch the campaign with paywall interaction feedback handler
NamiCampaignManager.launch(activity, label, paywallActionCallback = { action, sku, purchaseError, purchases ->
                    when (action) {
                        NamiPaywallAction.NAMI_BUY_SKU -> {
                            Log.d(LOG_TAG, "Buy SKU - ${sku?.skuId.orEmpty()}")
                        }
                        NamiPaywallAction.NAMI_SELECT_SKU -> {
                            Log.d(LOG_TAG, "Select SKU - ${sku?.skuId.orEmpty()}")
                        }
                        NamiPaywallAction.NAMI_RESTORE_PURCHASES -> {
                            Log.d(LOG_TAG, "Restore Purchases")
                        }
                        NamiPaywallAction.NAMI_SIGN_IN -> {
                            Log.d(LOG_TAG, "Sign in")
                        }
                        NamiPaywallAction.NAMI_CLOSE_PAYWALL -> {
                            Log.d(LOG_TAG, "Close Paywall")
                        }
                        NamiPaywallAction.NAMI_PURCHASE_SELECTED_SKU -> {
                            Log.d(LOG_TAG, "Purchase Selected SKU - ${sku?.skuId.orEmpty()}")
 
                        }
                        NamiPaywallAction.NAMI_PURCHASE_SUCCESS -> {
                            Log.d(
                                LOG_TAG,
                                "Purchase Success -> ${sku?.skuId} $purchases"
                            )
                        }
                        NamiPaywallAction.NAMI_PURCHASE_FAILED -> {
                            Log.d(
                                LOG_TAG,
                                "Purchase Failed -> ${sku?.skuId} $purchaseError"
                            )
                        }
                        NamiPaywallAction.NAMI_PURCHASE_CANCELLED -> {
                            Log.d(
                                LOG_TAG,
                                "Purchase Cancelled -> ${sku?.skuId} $purchaseError"
                            )
                        }
                        NamiPaywallAction.NAMI_PURCHASE_PENDING -> {
                            Log.d(
                                LOG_TAG,
                                "Purchase Pending -> ${sku?.skuId} $purchaseError"
                            )
                        }
                        NamiPaywallAction.NAMI_PURCHASE_UNKNOWN -> {
                            Log.d(
                                LOG_TAG,
                                "Purchase Flow Unknown -> ${sku?.skuId} $purchaseError"
                            )
                        }
                    }
                }) { result ->
                    when (result) {
                        is LaunchCampaignResult.Success -> {
                            Log.d(LOG_TAG, "Launch Campaign Success")
                        }
                        is LaunchCampaignResult.Failure -> {
                            Log.d(LOG_TAG, "Launch Campaign Error -> ${result.error}")
                        }
                    }

// Launch the campaign, with a label, and use of an error handler
LaunchCampaignResult result;
result = await NamiCampaignManager.launch(
  label: "onboarding",
  onPaywallAction: (action, sku) {
      print("Paywall action $action");
});
if (result.success) {
  print("Launch campaign - success");
} else {
  print("Launch campaign - error");
}// Launch the campaign with paywall interaction callbacks
// - Android paywallActionHandler
var paywallActionHandler = new PaywallActionHandler((namiPaywallAction, sku) =>
{
    // on paywall action
});
// - iOS paywallActionHandler
var paywallActionHandler = new PaywallActionHandler((namiPaywallAction, sku, errorMsg, purchases) =>
{
    // on paywall action
});
NamiCampaignManager.Launch("onboarding", launchHandler, paywallActionHandler);

import {NamiCampaignManager, NamiCampaign} from 'react-native-nami-sdk';

NamiCampaignManager.launch(
  label,
  (successAction, error) => {
    console.log('successAction', successAction);
    console.log('error', error);
  },
  (
    action,
    skuId,
    purchaseError,
    purchases,
    campaignId,
    campaignLabel,
    paywallId,
  ) => {
    console.log('action', action);
    console.log('skuId', skuId);
    console.log('purchaseError', purchaseError);
    console.log('purchases', purchases);
    console.log('campaignId', campaignId);
    console.log('campaignLabel', campaignLabel);
    console.log('paywallId', paywallId);
  },
);

// Launch the campaign with paywall interaction callbacks
// - Android paywallActionHandler
var paywallActionHandler = new PaywallActionHandler((namiPaywallAction, sku) =>
{
    // on paywall action
});
// - iOS paywallActionHandler
var paywallActionHandler = new PaywallActionHandler((namiPaywallAction, sku, errorMsg, purchases) =>
{
    // on paywall action
});
NamiCampaignManager.Launch("onboarding", launchHandler, paywallActionHandler);