​
1. What is a Checkpoint?

A Checkpoint is a key milestone in your users’ journey that can trigger rewards in a referral program. Think of them as strategic touchpoints where you can recognize and incentivize valuable user actions.
  • Strategic: Reward users for meaningful actions beyond just sign-ups.
  • Flexible: Configure different reward triggers for each referral campaign.
  • Measurable: Track which actions drive the highest conversion rates.
Checkpoints can be configured differently across campaigns. This means you can quickly test and iterate which checkpoint yields the best conversion rate without rebuilding your entire referral program.

​
2. Give Marketers Control

Checkpoints give marketers powerful control over referral programs. With checkpoints, you can:
  • Configure different reward triggers for each referral campaign
  • A/B test various checkpoints to see which drives the highest conversion rates
  • Quickly iterate on your referral strategy without rebuilding your entire program
  • Optimize for different business goals by adjusting which actions trigger rewards
  • Make data-driven decisions based on real performance data
This approach lets you continuously refine your referral program, ensuring you’re rewarding the actions that truly drive business growth—all without requiring developer intervention once the checkpoints are implemented.

​
3. Common Checkpoint Examples

​
For Subscription-based SaaS

  • User signup: When a new user creates an account
  • Trial started: When a user begins their free trial period
  • Paid subscription started: When a user converts to a paying customer

​
For E-commerce

  • First order placed: When a customer completes their first purchase
  • First order delivered: When a customer receives their first order
  • First order held complete: When a purchase is confirmed past the refund window

​
4. How to Implement Checkpoints in Your App

  1. Identify key milestones in your user journey (e.g., sign-up, trial start, purchase) in Flock app.
  2. Define these checkpoints in your app using the Flock SDK.
  3. Configure which checkpoints trigger rewards in each campaign from the Flock dashboard.

​
Example: Triggering a Checkpoint After User Action

Below are code examples for triggering a checkpoint after a user completes a key action: 
// After user completes a purchase
func handlePurchaseComplete() {
    // ... existing purchase logic ...
    Flock.shared.checkpoint(
        name: "first_order_placed"
    )
}

​
5. Best Practices

  • Start simple: Begin with 2-3 key checkpoints before expanding
  • Align with business goals: Choose checkpoints that drive meaningful outcomes
  • Balance timing: Space out checkpoints to maintain engagement throughout the user journey
  • Test and optimize: Experiment with different checkpoint configurations to see what drives the best results
For implementation details, see the SDK documentation.