Skip to main content

👥 Wallet-Based Personalization

Wallet-Based Personalization enables Web3 developers to tailor the customer journey based on the onchain value, history, and persona of the user's wallet. By leveraging Thirdwave's Wallet Intelligence API, developers can create customized experiences that cater to users' varying levels of experience and engagement with blockchain technology.

Web3 developers can use Wallet-Based Personalization in several key scenarios, including:

  • Onboarding Experience: Customize the onboarding process based on the user's experience level. Beginners can be directed to tutorials and educational resources, while blockchain pros can skip the basics and access advanced features.
  • Feature Access: Tailor feature access and recommendations based on the user's wallet activity and history, ensuring relevant and engaging interactions.
  • Incentive Programs: Design personalized incentive programs that reward users based on their engagement and value, fostering loyalty and deeper engagement.
  • Content Customization: Serve personalized content, such as news, updates, or tutorials, based on the user's transaction history and interests.
  • User Retention: Identify users who may be at risk of churn and offer tailored incentives or interventions to keep them engaged.
  • Community Building: Facilitate connections and interactions among users with similar wallet characteristics or engagement levels, fostering a more vibrant and supportive community.

Using Wallet-Based Personalization, Web3 developers can enhance the user experience by delivering customized interactions that cater to individual needs and expertise levels, leading to a more engaged and satisfied user base.

Instructions​

Step 0: User connects new wallet (example: 0x828d3Fff01cf78C96495aB1bD2C1e1b1b2384A9a) to your application.

Step 1: Obtain API Key

Step 2: Construct the API Request

  • Use the endpoint URL https://api.thirdwavelabs.com/evm/wallets/{account}, replacing {account} with the blockchain wallet address you want to check.
  • Set the request method to GET.

Step 3: Set Headers

  • Include the X-Api-Key header in your request with your API key as the value.

Step 4: Send the Request

  • Execute the request using your preferred method, such as curl or HTTP request library in your programming language of choice.
curl -s
--request GET 'https://api.thirdwavelabs.com/evm/wallets/0x828d3Fff01cf78C96495aB1bD2C1e1b1b2384A9a'
--header 'X-Api-Key: YOUR_API_KEY'

Step 5: Receive and Interpret the Response

  • Upon receiving the response from the API, parse the data to extract the relevant information. In this example we will personalize the experience based on a blockchain n00b vs blockchain pros →
    • Look for the firstSeenAt field in the response object, which indicates when the wallet first appeared on any EVM-compliant chain. This serves as an indicator of the wallet's maturity and longevity in the ecosystem.
    • Assess the engagementScore to determine the level of user engagement. This score ranges from 0 to 100 and quantifies a wallet's onchain activity based on transaction frequency, recency of the last transaction, and outbound transaction value. Here's how developers can use this score:
      • High Engagement Score (70-100): Wallets with high scores demonstrate deeper and higher-value engagement patterns. Users with such scores are likely to be retained and show higher spending potential. Tailor experiences to these users by providing access to advanced features, exclusive offers, or loyalty rewards.
      • Medium Engagement Score (40-69): Wallets with moderate scores reflect occasional but consistent activity. Users in this range might need targeted interventions to increase their engagement. Offer upsell opportunities, personalized recommendations, or special incentives to encourage more frequent interactions.
      • Low Engagement Score (0-39): Wallets with low scores indicate minimal activity and a higher likelihood of churn. These users can benefit from re-engagement campaigns such as educational resources, onboarding assistance, or introductory offers to boost their activity and retention.
  • Based on the wallet's attributes, engagement score and history, classify the user as either a beginner or a blockchain pro.
{
  "data": {
    "address": "0x828d3fff01cf78c96495ab1bd2c1e1b1b2384a9a",
    "balance": 453.83,
    "botWarning": false,
    "engagementScore": 95,
    "firstSeenAt": "2021-02-11T19:51:10.000Z",
    "hodlerScore": 95,
    "outboundTransactionCount": "973",
    "outboundTransactionValue": 445014.864936489,
    "transactionPatterns": [
      {
        "key": "CONTINUOUS",
        "value": false
      },
      {
        "key": "HIGH_VELOCITY",
        "value": false
      },
      {
        "key": "SUSPICIOUS_WALLET_NETWORK",
        "value": false
      },
      {
        "key": "TIMED",
        "value": false
      }
    ]
  }
}
info

If the wallet address provided doesn't exist, wasn't in the correct format, or is not on a supported chain, the response for that entry will be null.

Step 6: Personalize Customer Journey

  • Customize the onboarding experience based on the user's classification.
    • For beginners: Direct them to a basic onboarding path with tutorials and educational resources to familiarize them with blockchain concepts.
    • For blockchain pros: Skip the basic onboarding and provide access to advanced features or core experiences of the application.

Outcome​

By personalizing the customer journey based on the user's wallet attributes and history, developers can create tailored experiences that cater to users' individual needs and levels of expertise in blockchain technology.