LogoLogo
SDK ReferenceChangelogBlogStatusGet HelpGo To Dashboard
  • Introduction
  • Basics
    • How ContextDecision Works
    • How ContextPush Works
    • Getting Started
  • Context Decision
    • Logging Conversions
    • Revenue Outcomes
      • Logging Revenue with RevenueCat
    • Adding Entry Points
    • Release Checklist
    • Advanced
      • Custom Signals
      • Alternative Outcomes
      • Custom Outcome Metadata
      • Listening for Good Moments
      • Model Distribution Methods
      • Custom A/B Test Segmentation
      • Analytics & Reporting
  • Context Push
    • Integrating ContextPush
    • Push Notification Providers
      • OneSignal
      • Customer.io
      • Simple Web Request
    • Release Checklist
    • Analytics & Reporting
  • Discover By Use Cases
    • Multivariate Monetization
    • Inline Banners
  • Other Information
    • Glossary
    • Updating Your SDK
    • Minimum SDK Requirements
    • FAQ
    • Get Help
    • Changelog
  • Advanced
    • Custom Configuration
    • Capturing Context In Key Moments
Powered by GitBook
On this page
  • What are entry points?
  • Why is adding entry points important?
  • How can I add more entry points?
  • Won't this annoy the users even more by spamming them?
  • Disabling new entry points during calibration phase
  • How many entry points should I add?

Was this helpful?

  1. Context Decision

Adding Entry Points

Adding entry points is essential for ContextDecision to deliver maximum value to you - learn why it’s required and how to implement them.

PreviousLogging Revenue with RevenueCatNextRelease Checklist

Last updated 4 days ago

Was this helpful?

What are entry points?

Why is adding entry points important?

When integrating ContextDecision, it's crucial that you increase the entry points in your app, to increase the number of sales and revenue.

In the image above, the app is initially showing prompts in both good and bad moments. Once ContextDecision is implemented, it will only show prompts in good moments - when users are more likely to convert - thus showing less prompts, with higher conversion. However, if your primary goal is to generate more revenue, showing fewer prompts may not achieve that objective.

How can I add more entry points?

There are two types of entry points:

  • Opportunities that refine existing algorithms, leveraging ContextDecision's ML decision-making to enhance or completely replace the logic previously used to trigger your upsell.

    • Example: a dating app currently shows an upsell prompt once every 10 profile swipes. We could tweak this number to 1 every 5, 1 every 2, or even on every swipe. See Won't this annoy the users even more by spamming them?

  • Opportunities that introduce new triggers, expanding the potential for upsells by incorporating additional moments into your app.

    • Example: an app shows an upsell prompt on every app launch. In this case there's no way we can increase the number of prompts shown, because it's already shown on every app launch (being as annoying as possible). In this case we'd need to introduce a new opportunity somewhere else, e.g. every time the user completes a key positive action within the app, tailored to the app’s specific industry.

First, determine whether the flow you’re enhancing with ContextDecision already uses existing algorithms, as shown in the first example above. If it does, that’s great news - it’s the easiest to refine and improve. If your current flow aligns more with the second type, you’ll need to explore new user journeys in your app where adding an upsell opportunity makes sense. These entry points often arise after key positive interactions or in other carefully timed moments.

After identifying where to introduce new entry point, collaborate with our technical team to configure a model tailored to this new flow. Ensure this configuration is complete before rolling out the new flow to production.

Won't this annoy the users even more by spamming them?

No - that’s the strength of ContextDecision.

ContextDecision show prompts only in the best moments, thus reducing the number of prompts shown. However, to keep showing the same number of prompts as before, it’s essential to introduce new entry points.

If these two actions - refining prompt timing and increasing entry points - aren’t implemented together, you risk either reducing the total number of prompts (potentially decreasing revenue) or increasing them unnecessarily (which could frustrate users). For the best results, these steps should occur simultaneously: deploying the ML model and adding new entry points.

Disabling new entry points during calibration phase

During the calibration phase, we recommend the new entry points to be "live", but disabled. There are 2 ways to disable them during the calibration phase:

  • Inform us which flows are the new ones that should be disabled, and we'll disable them remotely by always sending shouldUpsell = false to your flow, during the calibration phase.

  • Check if the model info exists and update your implementation accordingly:

let modelInfo = ContextManager.getCustomModel(for: "your_upsell_flow")
let isInCalibrationPhase = modelInfo == nil

Not yet supported in Android. Reach out to our team to request this feature.

Not yet supported in Android. Reach out to our team to request this feature.

Not yet supported in Flutter. Reach out to our team to request this feature.

Not yet supported in Unity. Reach out to our team to request this feature.

Not yet supported in React Native. Reach out to our team to request this feature.

How many entry points should I add?

It depends on your current prompt volume and your ability to increase it through existing and new flows.

In the example above, the app shows 100k prompts per week. At a 50% prompt intensity for the existing flow, it would need to add new entry points with enough volume to supply the suppressed 50k prompts per week. In the example, this was done by adding 2 new entry points, so that the final number of prompts shown per week remained the same.

See the chart below for an illustrative relationship between prompt intensity (percentage of prompts shown) and potential conversion rate improvements.

To achieve this, evaluate your app’s unique use cases and user behavior. New flows or refinements to existing ones may unlock the entry points you need.

Note that in the case of constantly evaluating the context, such as in the dating app example where the context would be evaluated multiple times per minute, your app is in charge of implementing a cooldown mechanism that prevents a prompt from being displayed multiple times subsequently, as ContextSDK doesn't embed this behavior internally.

The numbers used in this page are used just to illustrate and don't represent the actual gain in conversion or revenue your app will see. Each app and industry have their own user behavior patterns and we create a bespoke ML model for each app.

This is what would likely happen if the goal was just to increase the conversion rate
In this example, the app had a 50% increase in sales by adding new entry points alongside ContextDecision
Example showing 2 new entry points added, which was enough due to their volume
Sample showing the relation between % of prompt shown and % of conversion rate increase

Entry points are triggers in your app that may show an upsell to your users.

In those moments, your app invokes ContextSDK to capture and analyze the user’s context.

These contexts allow the ML model to determine the next action - such as show an upsell screen, an ad, an app rating prompt, or skip the flow completely. The actions are tailored to your app’s specific use case.

Examples of entry points in an app that offers subscriptions