ReferralHero
  • Welcome to the Support Center
  • Common Questions
  • Features
    • Subscribers
      • Subscriber Profile
      • Unique Identifier
      • Active Visitors
      • 'Quick Add' Referral
      • Update Referral Status
    • Campaign Templates
      • Contest
      • Website Referral Analysis
      • Net Promoter Score
    • Unique Identifier
      • Phone Number
      • Confirmation Email
        • Thank-You Page
    • Automations
      • A/B Test
    • Security
      • Manual Review & Confirmation
      • Secondary Verification Method
      • High Risk
      • Blacklist
      • ReCaptcha
    • Reward
      • Reward Status
      • Advanced Reward Options
      • Transactions
    • Analytics
      • Active Visitors
      • Subscribers
      • Sources
      • Shares
      • Devices
      • Unsubscribers
    • Misc
      • Memorable referral links
      • 1-Click Signup
      • Forward & Refer
      • Coupon Codes
      • Custom Attribution
  • Integrate
    • Embeddable Widgets
      • Custom Domain
    • Integrations
      • Active Campaign
      • Aweber
      • Blockchain
      • Facebook Pixel
      • Calendly
      • Discord
      • HubSpot
      • Intercom
      • KakaoTalk
      • Klaviyo
      • Mailchimp
      • Salesforce
      • SendLane
      • Slack
      • Stripe
      • Tango Card
      • Telegram
      • Tremendous
      • Twilio
      • Typeform
      • Webhooks
      • Zapier
      • Zoho
    • Platform-specific Instructions
      • Google Tag Manager
      • WordPress
      • Webflow
      • SquareSpace
      • ClickFunnels
      • Unbounce
      • Instapage
      • Shopify
      • Carrd
      • WIX
    • Javascript Web API
      • Getting Started
      • Configuration file
      • Callbacks
      • Add a subscriber
      • Add a Pending Referral
      • Track multi-step conversion events
      • Track Transaction
      • Identify a Subscriber
      • Identify a Referrer
      • Generate Dashboard Widget
      • Generate Sharing-Screen
    • ReactJS
    • REST API
      • Errors
      • Webhooks
      • Objects
      • Endpoint Reference
    • Mobile SDKs
      • iOS SDK
        • Getting Started
        • Public Methods
        • Public Classes
        • API Interaction Methods
      • Android SDK
        • Getting Started
        • Public Methods
        • Public Classes
        • Listeners & Interfaces
      • Flutter SDK
        • Getting Started
        • Public Methods
      • React Native
        • Getting Started
        • Public Methods
        • Mobile App Testing in Development Mode
      • Mobile App Testing in Development Mode
  • API Tutorials
Powered by GitBook
On this page
  • Crypto Wallet Address Verification
  • Blockchain On-Chain Tracking

Was this helpful?

  1. Integrate
  2. Integrations

Blockchain

PreviousAweberNextFacebook Pixel

Last updated 10 months ago

Was this helpful?

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 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

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 .

To enable crypto wallet address verification through our widget:

  1. Go to Edit Campaign > Unique Identifier > Select Crypto Wallet Address as your primary/secondary unique identifier

  2. Enable Verification Method > Select the crypto wallets you would like to activate to verify wallet addresses

  3. Users will now be given the option to connect and verify their crypto wallet address directly through our widget.

  1. 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:

  1. Go to your campaign dashboard > Edit Campaign > Integrations > Blockchain and click on Add Event To Track

  1. 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

  1. 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:

  1. Add the event to track by specifying the blockchain, event name, the conversion event (tokens transferred), and the transaction definitions (e.g. contract address).

  1. A referral signs up to your referral campaign, and later performs the required event on BNB Chain.

  2. The on-chain transaction occurs and is created on the BNB Chain.

  1. The referral’s status is confirmed and the conversion value is sent to ReferralHero for your onward action.

primary/secondary unique identifier
pending to confirmed
shown here