Get up and running with your first gamification project in under 10 minutes.
This guide will walk you through setting up your first goldrush project, connecting your user data, and creating your first attribute.
Prerequisites
Before you begin, make sure you have:
- A Google Sheet with your user data (or access to create one)
- A goldrush account (sign up at app.goldrush.technology)
- Basic understanding of your user engagement goals
Step 1: Connect Your User Data
First, we’ll connect goldrush to your existing user data via Google Sheets.
- Navigate to the Connections screen in your goldrush dashboard
- Click “Connect via Google Sheet”
- Paste your Google Sheet URL
- Click “Test Connection” to verify access
Tip: Make sure your Google Sheet is publicly accessible or shared with goldrush. We recommend creating a dedicated sheet with only user IDs and no personal information.
Step 2: Select Your User ID Column
Choose which column in your sheet uniquely identifies each user.
- Review the columns goldrush detected from your sheet
- Select the column that contains unique user identifiers
- Click “Save & Continue”
Example Google Sheet Structure:
user_id | email | signup_date
001 | [email protected]| 2024-01-15
002 | [email protected]| 2024-01-16
003 | [email protected] | 2024-01-17Step 3: Set Update Schedule
Configure how often goldrush should check for new users in your sheet.
- Every Hour: For rapidly growing user bases
- Daily: Recommended for most use cases
- Weekly: For stable user bases
Step 4: Create Your First Attribute
Now let’s create a “Points” attribute to track user engagement.
- Navigate to the Attributes screen
- Click “Add Attribute”
- Fill in the attribute details:
| Field | Value | Description |
|---|---|---|
| UID | points | Unique identifier for API calls |
| Title | Points | Human-friendly name |
| Type | Number | Data type |
| Default | 0 | Starting value for new users |
| Minimum | 0 | Lowest possible value |
| Maximum | 10000 | Highest possible value (optional) |
Step 5: View Your Users
Navigate back to the Connections screen to see your users with their new Points attribute.
You’ll see a table with:
- User ID column (from your Google Sheet)
- Points column (showing default value of 0)
- Sortable columns (click headers to sort)
Next Steps
Congratulations! You’ve successfully set up your first goldrush project. Here’s what you can do next:
- Use the API to update user points programmatically
- Create additional attributes like levels, badges, or streaks
- Set up challenges to automatically reward user actions
- Learn best practices for effective gamification