# Custom rewards

## **What are Custom rewards?**

Custom Rewards are a powerful feature that allows you to reward users based on information you already have about them, outside of claimr. Instead of users earning rewards through actions within a claimr campaign (like completing tasks), you directly assign points to specific users based on a pre-defined list.

The primary use case for custom rewards is when you have an existing database of users (e.g., customers, subscribers, community members) and you want to:

* **Onboard them to claimr:** Give them an initial points balance to incentivize them to join your claimr campaign.
* **Reward prior activity:** Reward users for actions they've taken *outside* of claimr (e.g., attending an event, being a long-time subscriber).
* **Target specific segments:** Award points to a specific group of users based on criteria you define (e.g., VIP customers, users who have completed a specific action on your website).

## **How Custom rewards work**

Custom Rewards involve associating three pieces of information:

1. **Platform:** The platform the user is on.
2. **Account:** A user identifier. This is how you link the reward to the correct user.
3. **Points:** The number of points you want to award to that user.

You import this information to claimr and claimr automatically assigns the specified points to the corresponding users.

## **Create rewards**

To create Custom rewards, you'll import data from a CSV file. This allows you to reward users based on information you already have, without requiring them to perform actions within claimr.&#x20;

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FoUf19LhxNK6XfQKUloht%2FScreenshot%202025-02-28%20at%2000.13.59.png?alt=media&#x26;token=6aee03b4-35ad-4ac5-936a-6f74aac32696" alt=""><figcaption></figcaption></figure>

1. **Navigate to the Rewards section**
   * Go to your claimr dashboard and select the relevant campaign.
   * Click on the **Rewards** tab and move to **Custom rewards**.
2. **Initiate creation:** Click **Create** button. This will open a modal window for configuring the new Custom Reward.
3. **Fill in the fields:**

   <figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FI7l7VADBIJoYNARfpZdk%2FScreenshot%202025-02-28%20at%2016.15.34.png?alt=media&#x26;token=5107a3ad-acf7-4816-bd17-bc087353897e" alt="" width="375"><figcaption></figcaption></figure>

   * **Platform:** Select the platform associated with the user you're rewarding. This helps categorize the reward.
   * **Account:** Enter the user's identifier on the selected platform. This could be a wallet address or another platform-specific identifier. Be precise to ensure the reward is assigned correctly.
   * **Points:** Enter the number of points you want to award to this user.
   * **Create the Reward:** Click **Create** to finalize the process.

   Once created, the new reward will appear in the table of Custom rewards.&#x20;

## Import rewards

1. **Prepare your CSV file**
   * Your CSV file should contain a column for user identifiers (wallet addresses and usernames) and a column for the number of points to award.
   * You can have additional columns, but they are not required for the basic Custom Reward functionality.
   * The header should say the name of columns.
2. **Initiate import:** Click **Import** button. This will open the modal window on thew left.
3. **Upload your file:** In the opened modal window, click **Upload file** button and select the CSV file you prepared.
4. **Preview and map columns:**

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FMqwnqiTiiHg5KSiQ6oGg%2FScreenshot%202025-02-28%20at%2000.12.19.png?alt=media&#x26;token=d409b87f-c792-4147-af55-eb4a1c95a4c8" alt="" width="375"><figcaption></figcaption></figure>

* After uploading, claimr will display a preview of your CSV data. This preview shows the first few rows of your file.
* **Address:** Use the dropdown menus to map the columns in your CSV file to the required fields in claimr:
  * **Address:** Select the column that contains the user identifiers (e.g., wallet addresses, usernames). claimr will use this to match the rewards to the correct users.
  * **Points:** Select the column that contains the number of points to be awarded.
* If your columns are not automatically detected, select them manually.

6. **Import the rewards:** Once you've mapped the columns correctly, click **Import**. claimr will process your CSV file and create the Custom rewards, assigning the specified points to the corresponding users.
