zScore Docs
  • Core
    • What is zScore
    • How It Works
    • Operational Mechanics
  • For Operators
    • Mainnet
      • Quickstart (Mainnet)
      • Registration (Mainnet)
  • For Protocols
    • Overview
    • zPass
      • Getting Started
      • Use Cases
        • Risk Assessment
        • User Segmentation
        • Sybil Detection
        • Reputation Scoring
      • API Reference
        • Get zScore by Wallet
        • Get Wallets zScore
        • Get Wallets by Protocol
        • Get All Categories
        • Get Protocol Analytics by Wallet
        • Get Global Protocol Analytics
Powered by GitBook
On this page
  • 🎯 Overview
  • 📊 The Segmentation Challenge
  • Traditional Web3 Marketing Problems
  • The zPass Solution
  • 🏗️ Implementation Guide
  • Step 1: Basic User Segmentation
  • Step 2: Advanced Behavioral Segmentation
  • Step 3: Dynamic Targeting Engine
  • 🎯 Segmentation Strategies
  • Value-Based Segmentation
  • Behavioral Segmentation
  • 📊 Campaign Optimization
  • Personalization Engine
  • 📈 Success Metrics & ROI
  • Campaign Performance Metrics
  • Real-World Results
  • 🚀 Getting Started
  • Quick Implementation
  • Best Practices
  • 🤝 Support & Resources
  • Implementation Support
  • Advanced Features
  1. For Protocols
  2. zPass
  3. Use Cases

User Segmentation

🎯 Overview

Transform your growth strategy with precision user segmentation based on comprehensive Web3 behavioral data. zPass enables you to identify, target, and engage high-value users while optimizing marketing spend and improving user experience.

Perfect for: Growth teams, marketing campaigns, user acquisition, personalization engines, loyalty programs


📊 The Segmentation Challenge

Traditional Web3 Marketing Problems

  • 🎯 Poor Targeting: Broad campaigns with low conversion rates

  • 💸 Wasted Spend: Marketing budgets lost on low-quality users

  • 🤖 Bot Infiltration: Sybil accounts skewing campaign metrics

  • 📉 Low Retention: Attracting mercenary users who leave quickly

  • 🔍 Limited Insights: No way to identify truly valuable users

The zPass Solution

zPass provides deep user intelligence through:

  • Behavioral Segmentation: Group users by on-chain activity patterns

  • Value-Based Targeting: Identify high-LTV users before they convert

  • Quality Scoring: Distinguish genuine users from bots and farmers

  • Cross-Protocol Insights: Understand user preferences across Web3

  • Predictive Analytics: Forecast user behavior and lifetime value


🏗️ Implementation Guide

Step 1: Basic User Segmentation

Start with simple user classification based on zScore ranges:

async function segmentUsers(walletAddresses) {
  const scores = await zpass.batchGetScores(walletAddresses);
  
  const segments = {
    whales: [],
    powerUsers: [],
    regularUsers: [],
    newUsers: [],
    riskUsers: []
  };
  
  scores.forEach(user => {
    if (user.zscore >= 800) {
      segments.whales.push(user);
    } else if (user.zscore >= 600) {
      segments.powerUsers.push(user);
    } else if (user.zscore >= 300) {
      segments.regularUsers.push(user);
    } else if (user.zscore >= 100) {
      segments.newUsers.push(user);
    } else {
      segments.riskUsers.push(user);
    }
  });
  
  return segments;
}

Step 2: Advanced Behavioral Segmentation

Implement sophisticated segmentation based on user behavior patterns:

async function advancedUserSegmentation(walletAddresses) {
  const detailedAnalytics = await zpass.batchGetAnalytics(walletAddresses);
  
  const behavioralSegments = {
    defiNatives: [],
    nftCollectors: [],
    gamefiPlayers: [],
    daoParticipants: [],
    yieldFarmers: [],
    crossChainUsers: [],
    institutionalUsers: []
  };
  
  detailedAnalytics.forEach(user => {
    const profile = analyzeUserProfile(user);
    const primarySegment = getPrimarySegment(profile);
    behavioralSegments[primarySegment].push({
      ...user,
      profile,
      secondarySegments: getSecondarySegments(profile)
    });
  });
  
  return behavioralSegments;
}

function analyzeUserProfile(userAnalytics) {
  const { chainUsage, protocolUsage, transactionPatterns } = userAnalytics;
  
  return {
    defiScore: calculateDefiEngagement(protocolUsage),
    nftScore: calculateNftActivity(transactionPatterns),
    gamefiScore: calculateGamefiEngagement(protocolUsage),
    daoScore: calculateDaoParticipation(userAnalytics),
    crossChainScore: chainUsage.length,
    institutionalScore: calculateInstitutionalIndicators(userAnalytics),
    loyaltyScore: calculateProtocolLoyalty(protocolUsage),
    riskScore: userAnalytics.risk_indicators.length
  };
}

Step 3: Dynamic Targeting Engine

Build a targeting engine that adapts to campaign goals:

class TargetingEngine {
  constructor(zpassClient) {
    this.zpass = zpassClient;
    this.campaigns = new Map();
  }

  async createTargetingCampaign(campaignConfig) {
    const {
      name,
      objective, // 'acquisition', 'retention', 'engagement', 'conversion'
      budget,
      targetSegments,
      exclusionCriteria
    } = campaignConfig;

    // Find eligible users based on criteria
    const eligibleUsers = await this.findEligibleUsers(targetSegments, exclusionCriteria);
    
    // Score and rank users for this campaign
    const rankedUsers = await this.rankUsersForCampaign(eligibleUsers, objective);
    
    // Optimize budget allocation
    const budgetAllocation = this.optimizeBudgetAllocation(rankedUsers, budget);
    
    const campaign = {
      id: generateCampaignId(),
      name,
      objective,
      targetUsers: rankedUsers,
      budgetAllocation,
      createdAt: Date.now(),
      status: 'ready'
    };

    this.campaigns.set(campaign.id, campaign);
    return campaign;
  }

  async rankUsersForCampaign(users, objective) {
    const rankedUsers = [];

    for (const user of users) {
      const campaignScore = await this.calculateCampaignScore(user, objective);
      rankedUsers.push({
        ...user,
        campaignScore,
        expectedROI: campaignScore.expectedROI,
        engagementProbability: campaignScore.engagementProbability
      });
    }

    return rankedUsers.sort((a, b) => b.campaignScore.total - a.campaignScore.total);
  }
}

🎯 Segmentation Strategies

Value-Based Segmentation

Segment
zScore Range
Characteristics
Marketing Strategy

Whales

800-1000

High-value, loyal users

VIP treatment, exclusive access

Power Users

600-799

Active, engaged users

Premium features, early access

Regular Users

300-599

Steady, reliable users

Standard campaigns, loyalty programs

New Users

100-299

Potential, needs nurturing

Onboarding, education content

Risk Users

0-99

Bots, farmers, low quality

Exclude or minimal spend

Behavioral Segmentation

DeFi Natives

  • Profile: Heavy DeFi usage, multiple protocols, sophisticated strategies

  • Targeting: Advanced features, yield opportunities, governance participation

  • Content: Technical analysis, protocol comparisons, yield strategies

NFT Collectors

  • Profile: Active NFT trading, collection building, community participation

  • Targeting: Exclusive drops, community events, creator collaborations

  • Content: Artist spotlights, market trends, collection guides

GameFi Players

  • Profile: Play-to-earn gaming, in-game asset trading, guild participation

  • Targeting: New games, tournaments, guild features

  • Content: Game guides, earning strategies, community events

DAO Participants

  • Profile: Governance voting, proposal creation, community leadership

  • Targeting: Governance features, leadership opportunities

  • Content: Governance updates, proposal analysis, community building


📊 Campaign Optimization

Personalization Engine

async function personalizeUserExperience(walletAddress) {
  const userProfile = await zpass.getUserProfile(walletAddress);
  const segmentProfile = await getSegmentProfile(userProfile);
  
  return {
    // UI/UX Personalization
    interface: {
      theme: segmentProfile.preferredTheme,
      layout: segmentProfile.preferredLayout,
      features: getRelevantFeatures(segmentProfile)
    },
    
    // Content Personalization
    content: {
      homepage: getPersonalizedHomepage(segmentProfile),
      recommendations: getPersonalizedRecommendations(userProfile),
      tutorials: getRelevantTutorials(segmentProfile)
    },
    
    // Feature Access
    features: {
      advancedTrading: userProfile.zscore > 500,
      betaFeatures: userProfile.zscore > 700,
      vipSupport: userProfile.zscore > 800
    },
    
    // Incentives
    incentives: {
      welcomeBonus: calculateWelcomeBonus(userProfile),
      loyaltyRewards: calculateLoyaltyRewards(userProfile),
      feeDiscounts: calculateFeeDiscounts(userProfile)
    }
  };
}

📈 Success Metrics & ROI

Campaign Performance Metrics

Targeting Accuracy

  • 3x improvement in conversion rates with zPass segmentation

  • 50% reduction in cost per acquisition

  • 40% increase in user lifetime value

  • 80% reduction in bot/Sybil infiltration

User Engagement

  • 60% higher engagement rates for personalized campaigns

  • 2x longer session duration for targeted users

  • 45% increase in feature adoption

  • 35% improvement in user satisfaction scores

Real-World Results

DeFi Protocol Campaign

  • Target: High-value DeFi users for new lending product

  • Segmentation: zScore 600+, active in 3+ protocols

  • Results:

    • 4x higher conversion rate vs. broad campaign

    • $50 cost per acquisition vs. $200 industry average

    • 85% user retention after 3 months

NFT Marketplace Launch

  • Target: Active NFT collectors and traders

  • Segmentation: NFT activity score >70, recent trading history

  • Results:

    • 6x higher engagement rate

    • 3x more transactions per user

    • 70% of users became repeat customers


🚀 Getting Started

Quick Implementation

  1. Analyze Current Users - Segment your existing user base

  2. Create Target Segments - Define your ideal user profiles

  3. Launch Test Campaign - Start with a small, focused campaign

  4. Measure & Optimize - Use data to refine your approach

Best Practices

  • Start Simple: Begin with basic zScore segmentation

  • Test Everything: A/B test different segments and messages

  • Personalize Gradually: Add personalization features incrementally

  • Monitor Quality: Track user quality metrics, not just volume

  • Iterate Quickly: Use data insights to rapidly improve campaigns


🤝 Support & Resources

Implementation Support

  • 💬 Discord: Join our growth marketing community

  • 📧 Email: [email protected]

  • 📞 Consultation: Schedule a growth strategy session

Advanced Features

  • Custom Segments: Build protocol-specific user segments

  • Predictive Models: Forecast user behavior and LTV

  • Real-time Personalization: Dynamic content based on user actions

PreviousRisk AssessmentNextSybil Detection

Last updated 1 day ago

- Get your API credentials

Ready to transform your user acquisition?

Set Up zPass
Start Segmentation →