E-commerce Purchase Tracking

The Challenge

You're running an online store selling electronics, clothing, and accessories. Your customers make purchases, but most only buy once and never return. Your metrics show:

• 📉 Most of your customers never make a second purchase
• 💰 Customer acquisition cost is not that much
• ⏱️ Average customer lifetime is just one transaction

The question: How do you turn one-time buyers into loyal, repeat customers?

The Solution: Gamified Purchase Rewards

By rewarding customers immediately after purchase, you can:

• ✨ Create an emotional connection with instant gratification
• 🎯 Increase repeat purchases significantly with point systems
• 👑 Build VIP tiers that encourage higher spending
• 🎁 Offer exclusive perks that keep customers coming back

In this guide, you'll build a complete purchase tracking system that rewards customers for:

• Making their first purchase (welcome bonus)
• High-value orders (VIP status)
• Bulk purchases (volume discounts)

What You'll Build

By the end of this guide, you'll have:

1. Purchase reward system that automatically tracks orders
2. Badge system for achievements (Electronics Enthusiast, VIP Customer, etc.)
3. Points & inventory system for redeemable rewards
4. Verification tools to monitor customer progress

Real-World Impact

E-commerce clients typically see a significant increase in repeat purchases within months of implementing this system.

Before You Start

Make sure you have:

• ✅ RapidMule account and API key (Get one here)
• ✅ Customers registered in RapidMule (via Player API)
• ✅ Basic understanding of REST APIs

Setup: Configure Your First Purchase Badge

Before sending purchase actions, you need to configure badges and rewards in your RapidMule dashboard. Let's create an "Electronics Enthusiast" badge that rewards customers for buying electronics.

Dashboard Configuration

Here's how to set up your first purchase badge step-by-step in the RapidMule dashboard:

1. Create Badge

Navigate to Badges in your dashboard and create a new badge:

Badge Properties

Name: "Electronics Enthusiast"
Description: "Made a purchase in electronics category"
Type: OneTimeOnly
Points: 15
Image: Upload or select badge icon

This badge will be awarded the first time a customer buys an electronics item.

2. Add Deliverable

Attach a Deliverable to your badge. This is what customers actually receive:

Deliverable Properties

Type: Prize (Points)
Label: "Purchase Bonus Points"
Quantity: 15
Deliverable Objects:
  - bonus_type: purchase_reward

Customers will see "+15 Bonus Points!" when they earn this badge.

3. Define Condition

Create the Condition that triggers the badge:

Condition Properties

Action Name: "purchase"
Challenge Type: "Several Times Challenge"
Action Count: 1
Filters:
  - Action object: "category"
  - Operator: is
  - Value: "electronics"

This rule checks if the purchase action has category: "electronics" in its details.

Why This Matters

The dashboard configuration is a one-time setup. Once configured, RapidMule's engine automatically evaluates every purchase action against these rules. You never need to manually check conditions in your code!

Step 1: Send Your First Purchase Action

Now that your badge is configured, let's track a customer's purchase. When John completes an order for $149.99 worth of electronics, your server sends this action:

Understanding Purchase Actions

Purchase actions include:

• Order amount - Total purchase value
• Currency - Payment currency
• Product category - Type of items purchased
• Item count - Number of products
• Payment method - How they paid

POSThttps://api.rapidmule.com/v1/action/process

Send a purchase action when customer completes an order

{ "name": "purchase", "referenceId": "order-12345", "playerId": "customer-abc-123", "details": [ { "amount": 149.99, "currency": "USD", "category": "electronics", "items_count": 2, "payment_method": "credit_card", "order_id": "order-12345" } ] }

Point Calculation

Each purchase in the electronics category rewards 15 fixed bonus points. Different product categories can have different fixed point rewards configured in your RapidMule dashboard.

What Just Happened?

1. ✅ Your backend sent a purchase action with order details
2. ✅ RapidMule's engine evaluated it against your "Electronics Enthusiast" badge condition
3. ✅ The condition matched (category: "electronics"), so the badge was awarded
4. ✅ Customer received 150 total points + 15 bonus points from the deliverable
5. ✅ Response returned immediately with all earned rewards

Next Challenge: What if John makes a much bigger purchase? Let's set up VIP rewards for high-value customers...

Step 2: Reward High-Value Customers

John loved his first purchase and is back to buy something premium. This time, he's spending $999.99 on a high-end laptop. Let's reward him with VIP status!

Dashboard Setup: Before testing, configure a VIP badge in your dashboard:

VIP Badge Setup

VIP Customer Badge

Name: "VIP Customer"
Type: OneTimeOnly
Points: 100
Condition:
  Action: "purchase"
  Challenge: "Several Times Challenge"
  Filters:
    - amount > 500
    - category = "premium"

VIP Rewards

Add multiple deliverables for VIP customers:

1. Bonus Points (100 points)
2. Free Shipping Voucher (30-day validity)

Now let's send the high-value purchase action:

POSThttps://api.rapidmule.com/v1/action/process

Track a high-value purchase for VIP rewards

{ "name": "purchase", "referenceId": "order-67890", "playerId": "customer-abc-123", "details": [ { "amount": 999.99, "currency": "USD", "category": "premium", "items_count": 1, "payment_method": "credit_card", "order_id": "order-67890", "is_premium_customer": true } ] }

Progress Check:

Notice how the response includes multiple deliverables:

• 📦 deliverables: Tangible rewards (points, vouchers)
• 🏅 badges: Visual achievements for your frontend

The deliverables array contains all the rewards the customer received:

• Update customer tier in your database
• Enable premium features
• Send confirmation email with voucher code

Next Challenge: What about customers who buy in bulk? Let's reward volume purchases...

Step 3: Encourage Bulk Purchases

Sarah is shopping for gifts and adds 5 items to her cart (2 clothing, 3 accessories). Let's reward her bulk purchase with a special badge!

Why This Matters: Bulk purchase rewards encourage:

• 🛒 Higher cart values
• 📈 Increased average order size
• 🎁 Gift shopping behavior

Dashboard Setup:

Bulk Buyer Badge

Bulk Buyer Badge

Name: "Bulk Buyer"
Type: Repeatable  # Can earn multiple times!
Points: 30
Condition:
  Action: "bulk_purchase"
  Challenge: "Several Times Challenge"
  Filters:
    - items_count >= 5

Note: This badge is Repeatable, so customers can earn it every time they buy 5+ items.

Here's the bulk purchase action:

POSThttps://api.rapidmule.com/v1/action/process

Track multiple purchases in a single session

{ "name": "bulk_purchase", "referenceId": "bulk-order-11111", "playerId": "customer-abc-123", "details": [ { "total_amount": 299.97, "currency": "USD", "items_count": 5, "payment_method": "credit_card", "order_id": "bulk-order-11111", "items": [ { "category": "clothing", "amount": 89.99, "quantity": 2 }, { "category": "accessories", "amount": 119.99, "quantity": 3 } ] } ] }

Key Insight:

Notice the difference between badge types:

• OneTimeOnly badges (Electronics, VIP): Earned once, never again
• Repeatable badges (Bulk Buyer): Can earn multiple times

This flexibility lets you design rewards that match your business goals!

---

Verification: Check Your Integration

You've sent three different purchase actions. Now let's verify everything is working by checking customer data through the API.

What You'll Verify:

1. ✅ All badges were properly awarded
2. ✅ Points accumulated correctly
3. ✅ Inventory items (vouchers) were added
4. ✅ Progress toward future badges is tracked

Check Player Progress

Use the Players API to see the customer's updated status:

GEThttps://api.rapidmule.com/v1/admin/players/customer-abc-123

Retrieve detailed player information including points, badges, and inventory

No body required for GET requests

---

What You've Built

Congratulations! You now have a complete purchase tracking system. Let's recap what you achieved:

🎯 Customer Journey You Created

• 🛒 First purchase → Electronics badge + 15 points
• 👑 Premium order ($999) → VIP badge + 100 points + Free shipping
• 📦 Bulk order (5 items) → Bulk Buyer badge + 30 points
• 🏆 After 10 purchases → "Loyal Customer" badge (in progress)

💡 Key Concepts You Learned

1. Dashboard First: Configure badges/conditions once, track forever
2. Progressive Rewards: OneTimeOnly vs Repeatable badges
3. Multi-Reward System: Badges, points, vouchers, and triggers together
4. Verification: Check customer progress instantly via API

📊 Business Impact

With this system, you can now:

• ✅ Increase repeat purchase rate significantly
• ✅ Build customer loyalty with point accumulation
• ✅ Create VIP tiers for high-value customers
• ✅ Track and reward bulk purchase behavior

What's Next?

Explore more gamification patterns:

🎯 Similar Use Cases

1. Habit Formation with Sliding Windows - Build engaging habit loops with flexible time windows
2. Social Engagement Rewards - Drive community participation and content creation
3. Leaderboard Competitions - Add competitive rankings to boost engagement

📚 Deep Dive

• Player Management API - Retrieve detailed customer profiles and progress
• Badges API - Explore badge types, ranks, and configuration
• Error Handling - Handle API failures gracefully in production

Common Patterns to Explore

• First Purchase Bonus: Extra rewards for new customers
• Spending Tiers: Bronze → Silver → Gold progression
• Seasonal Campaigns: Time-limited badges and promotions
• Referral Rewards: Track and reward customer referrals
• Category Mastery: Badges for buying from all categories

Need Help?

• 📚 API Reference - Complete endpoint documentation
• 📧 Contact Support - Get help from our team
• 💬 Contact Support - Get help from our team

---

Success!

You've successfully implemented e-commerce purchase tracking! Your customers can now earn rewards for their purchases, increasing engagement and loyalty. 🎉