Blockchain
The ReferralHero Blockchain Integration is very powerful and allows you to track and confirm on-chain conversion events for referrals. When a referral meets the defined event their referral status will change from pending to confirmed and the referral will officially count towards the referrer (ie. points accumulated, rewards unlocked, etc.).
ReferralHero currently supports on-chain tracking for:
BNB Chain
Ethereum
Solana
To use this feature ReferralHero subscribers must have verified crypto wallet addresses.
Crypto Wallet Address Verification
To enable the blockchain integration you must:
1. Set 'crypto wallet address' as the primary/secondary unique identifier
AND
2a. If you are using our widget to create subscribers, they must verify their crypto wallet address
OR
2b. If you are using our Javascript API, REST API, or SDK to create subscribers, you must send these fields (crypto_wallet_address & crypto_wallet_provider) to the subscriber profile, as shown here.
To enable crypto wallet address verification through our widget:
Go to Edit Campaign > Unique Identifier > Select Crypto Wallet Address as your primary/secondary unique identifier
Enable Verification Method > Select the crypto wallets you would like to activate to verify wallet addresses
Users will now be given the option to connect and verify their crypto wallet address directly through our widget.
ReferralHero will automatically check to see if the chosen wallet is activated in the browser extension. If it is, the wallet will automatically connect, and once the 'sign up' is complete the subscriber will be verified.
Blockchain On-Chain Tracking
To set up the Blockchain on-chain tracking integration:
Go to your campaign dashboard > Edit Campaign > Integrations > Blockchain and click on Add Event To Track
In the popup, enter the following:
Blockchain on which the transaction occurs
Name your tracking event
Select the conversion value that should be displayed in the subscriber profile
Set up as many relevant on-chain definitions
Click Start Tracking to close the popup Click Save
Blockchain integration only works for campaigns set up with ‘multi-step conversion events’ as the campaign goal
You will not be able to use the Blockchain integration to track events that do not occur on a blockchain, e.g. fiat on-ramp transactions, etc
Blockchain On-Chain Tracking Example
The following example illustrates how a ReferralHero on-chain tracking event can be set up:
Add the event to track by specifying the blockchain, event name, the conversion event (tokens transferred), and the transaction definitions (e.g. contract address).
A referral signs up to your referral campaign, and later performs the required event on BNB Chain.
The on-chain transaction occurs and is created on the BNB Chain.
The referral’s status is confirmed and the conversion value is sent to ReferralHero for your onward action.
Last updated
