For Developers
Managing Promo Codes
Complete guide to creating and managing effective promo code campaigns
Last updated: December 17, 2025
Managing Promo Codes
Promo codes are the core of GetFree's value proposition. They help you acquire users, get feedback, and drive adoption of your app. This guide covers everything you need to know about managing codes effectively.
Understanding Code Types
Apple App Store Promo Codes
- **Source**: Generated in App Store Connect
- **Format**: 12-character alphanumeric (e.g., "XNHJK7YKPPWW")
- **Limit**: 100 codes per app version
- **Expiration**: 28 days from generation
- **Best For**: Premium app unlocks, in-app purchases
Google Play Promo Codes
- **Source**: Generated in Google Play Console
- **Format**: 18-character alphanumeric
- **Limit**: 500 codes per quarter
- **Expiration**: Customizable by developer
- **Best For**: Paid apps, subscription trials, in-app items
Custom Promo Codes
- **Source**: Generated in your own system
- **Format**: Your choice (e.g., "GETFREE2024", "WELCOME50")
- **Limit**: Unlimited
- **Expiration**: You control expiration
- **Best For**: Web apps, custom offers, special campaigns
Setting Up Your First Code Campaign
Campaign Planning
Before creating codes, define your campaign goals:
- **Objective**: User acquisition, feedback, beta testing?
- **Target Audience**: New users, power users, specific regions?
- **Value Proposition**: What exactly are users getting?
- **Duration**: How long should the campaign run?
Campaign Creation Steps
Step 1: Navigate to Code Management
1. **Log in** to your developer dashboard 2. **Select** your app from the list 3. **Click** "Manage Codes" in the sidebar 4. **Choose** "Create New Campaign"
Step 2: Campaign Details
- **Campaign Name**: Internal reference (e.g., "Q1 Launch Promo")
- **Description**: What the offer includes
- **Offer Type**: Free trial, discount, lifetime deal, etc.
- **Campaign Duration**: Start and end dates
Step 3: Code Configuration
**For Store Codes (Apple/Google)**
- **Upload Method**: CSV file or manual entry
- **Code Source**: Select App Store or Play Store
- **Quantity**: Number of codes to upload
- **Validation**: System checks code format and availability
- **Generation Method**: Create codes in GetFree or import your own
- **Code Format**: Define pattern and length
- **Uniqueness**: Ensure codes are unique and not guessable
- **Validation**: Set up redemption logic
Campaign Management
Active Campaign Monitoring
Key Metrics to Track
- **Claim Rate**: Percentage of available codes claimed
- **Claim Velocity**: How quickly codes are being claimed
- **Conversion Rate**: Claims to actual app downloads
- **Geographic Distribution**: Where users are claiming from
Daily Activities
- **Check Code Inventory**: Monitor remaining codes
- **Review User Feedback**: Read reviews and comments
- **Respond to Questions**: Answer user inquiries promptly
- **Track Performance**: Analyze conversion metrics
Optimization Strategies
A/B Testing
- **Different Offers**: Test free trial vs discount
- **Varied Descriptions**: Try different value propositions
- **Timing Experiments**: Launch at different times/days
- **Audience Targeting**: Focus on specific user segments
Performance Improvements
- **Refine Offer**: Adjust value based on conversion
- **Update Creative**: Refresh screenshots and descriptions
- **Adjust Timing**: Optimize launch timing
- **Expand Reach**: Consider featured placement
Advanced Strategies
Staggered Releases
- **Batch Upload**: Release codes in waves
- **Scarcity Marketing**: Create urgency with limited availability
- **Timing Optimization**: Release codes at peak user activity times
- **Geographic Targeting**: Release codes by region/time zone
Multi-Campaign Coordination
- **Parallel Campaigns**: Run different offers simultaneously
- **Sequential Campaigns**: Build on previous success
- **Cross-Promotion**: Coordinate with other apps
- **Seasonal Campaigns**: Align with holidays and events