💻Quick Start

The setup should take less than 30 mins

3 min video demo

Create referral campaign

You can create a referral campaign by clicking Create a new campaign button on your main page.

1. Details

Give your referral campaign a title, description, and image

Make sure you include details of the reward instruction, and possible terms & conditions in the description

2. Reward structure

You can set up a flexible reward structure for the referrer & invitee.

There are three types of rewards you can set:

1. Token reward: Set a specific amount of tokens reward per referee, e.g. Every referral Jason generates, he will be rewarded with 5 USDC

2. Other reward: Set non-token rewards like NFT, Raffle tickets or even merchandise. e.g. Every referral Jason generates, he will be rewarded with 1 NFT equipment in-game

3. Dynamic reward: Set revenue sharing-based reward. e.g. Jason can earn 25% of the fee collected from the people he referred.

A maximal number of invitees per referrer can be set. e.g. Every referrer can bring a maximum of 10 invitees.

If you want to set up a dynamic reward, please contact us for the setup

3. Referral

Then you can define the referral link, as well as create a pop-up for invitees when they open the referral link.

Referral link: where do you want the referral link takes people to

Please make sure the referral link domain is added to the allowed domains list on the Setting page. Otherwise, the SDK won't work

Referral link popup configuration (optional)

You can also trigger a popup when someone visits the referral link, can you turn it off if you don't need this.

4. Track

The last step is defining the conversion events, as well as the integration to your Dapp for tracking.

We support 2 types of conversion events:

1. On-chain verification: Qwestive will listen to your smart contract and monitor the transaction between the invitees' public key & your smart contract. Tracking will be based on on-chain data directly

2. Website verification: You can track website verification by using the setReferral events below

See Implementing tracking section for a detailed integration guide

If you want to set up on-chain verification, please contact us for the setup

5. Share with your community

Once you set up the tracking & campaign details, you can invite others to join the referral campaign in 3 ways.

1. Share the link to join the referral program: You can get the link from the campaign detail page with a Share button. You can share the link in discord, Twitter, DM, or blog posts.

1. Embed link on your Dapp: You can also add a button/link on your website to take users to the referral campaign page.

Example of adding a button/link

1. Embed UI on your Dapp: we also provide embed UI SDK so that users don't need to leave your Dapp.

When referrers/affiliates click on the above shown button/link, it will open the Embedded UI popup from qwestive, where referrers can checkout the campaign details and track their progress from your Dapp.

See Implement Embedded UI section for a detailed integration guide.