← Back to Web3 Trackers

Last updated: 2026-01-19

Web3 Wallet Tracking Setup Guide

Two ways to connect wallet addresses to your marketing campaigns. Choose the method that fits your setup.

Choose Your Method

Tracking Pixel

Recommended
  • ✓One script tag, 5-minute setup
  • ✓Auto-detects all major wallets
  • ✓No code changes required
  • ✓Works with Ethereum + Solana

Best for: dApps, landing pages, most use cases

API Integration

Advanced
  • ✓Full control over when to track
  • ✓Server-side tracking support
  • ✓Bulk wallet import
  • ✓Custom integration logic

Best for: Custom flows, bulk imports, backend systems

1Tracking Pixel Setup

Step 1: Get Your Pixel ID

Sign in to Web3 Trackers and go to Settings. Your Pixel ID will be displayed in the Tracking Pixel section. It looks like: px_a1b2c3d4e5f6g7h8

Step 2: Add the Script Tag

Copy this code and paste it in your website's <head> section:

<script async src="https://www.web3trackers.com/pixel.js"
        data-pixel-id="YOUR_PIXEL_ID"></script>

Replace YOUR_PIXEL_ID with your actual Pixel ID from Step 1.

Step 3: Create Tracking Links

Go to your campaign and click Add Tracking Link. Fill in:

  • Source (required): Where the traffic comes from (twitter, discord, newsletter)
  • Medium: Type of traffic (organic-social, paid, referral)
  • Content: Specific content identifier (thread_1, post_a)

This creates a tracking link like: web3trackers.com/r/ref_abc123

Step 4: Share Links & Track

Share your tracking links on Twitter, Discord, newsletters, etc. When users click and land on your site:

  1. The pixel captures the attribution parameters from the URL
  2. When the user connects their wallet (MetaMask, Phantom, etc.), the pixel detects it
  3. The wallet is automatically attributed to your campaign
  4. Any future on-chain activity from that wallet is tracked

Debug Mode

Add data-debug="true" to the script tag to enable console logging. This helps verify the pixel is working correctly.

2API Integration Setup

Option A: Register Wallet with Referral Code

Use this endpoint when you have a referral code from a tracking link:

POST /api/public/register-wallet
Content-Type: application/json

{
  "code": "ref_abc123",
  "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f42b0e"
}

The code is the ref or w3t parameter from your tracking link URL.

Option B: Record Touch with Pixel ID

Use this endpoint for direct pixel-style tracking via API:

POST /api/track/touch
Content-Type: application/json

{
  "pixelId": "px_a1b2c3d4e5f6g7h8",
  "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f42b0e",
  "chain": "ethereum",
  "refToken": "ref_abc123",
  "utmSource": "twitter",
  "utmMedium": "social"
}

The refToken and UTM parameters are optional but recommended for attribution.

JavaScript Example

Call the API after the user connects their wallet:

// After wallet connect
const walletAddress = await ethereum.request({ 
  method: 'eth_requestAccounts' 
});

// Get refToken from URL params
const urlParams = new URLSearchParams(window.location.search);
const refToken = urlParams.get('ref') || urlParams.get('w3t');

// Register the wallet
await fetch('https://www.web3trackers.com/api/track/touch', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    pixelId: 'YOUR_PIXEL_ID',
    walletAddress: walletAddress[0],
    chain: 'ethereum',
    refToken: refToken
  })
});

When to Use Each Method

Use CaseTracking PixelAPI
Standard dApp with wallet connect✓ BestWorks
Marketing landing page✓ BestWorks
Bulk import historical walletsNo✓ Best
Server-side trackingNo✓ Best
Custom wallet connect flowMaybe✓ Best
Mobile app (React Native)No✓ Best

Frequently Asked Questions

What is wallet tracking in Web3 marketing?▼

Wallet tracking connects marketing campaigns to wallet addresses. When a user clicks your campaign link and connects their wallet, the system records that connection and attributes any future on-chain activity (swaps, mints, deposits) back to your campaign.

What is the difference between the tracking pixel and API methods?▼

The tracking pixel auto-detects wallet connections on your site (MetaMask, Phantom, etc.) with one script tag — no code changes needed. The API method requires you to manually send wallet addresses when users connect, giving you more control but requiring integration work.

Which wallet tracking method should I use?▼

Use the tracking pixel if you want the easiest setup with no code changes. Use the API if you need custom integration, server-side tracking, or want to import historical wallet data. Most teams start with the pixel and add API integration later if needed.

What wallets does the tracking pixel support?▼

The pixel auto-detects MetaMask, Phantom, Coinbase Wallet, Rainbow, Rabby, and any wallet supporting EIP-6963 (modern multi-wallet standard). It works with both Ethereum and Solana wallets.

How long does pixel setup take?▼

About 5 minutes. Copy the script tag from your dashboard, paste it in your site's <head> section, and you're done. The pixel starts detecting wallet connections immediately.

Do I need engineering resources for setup?▼

Not for the tracking pixel — anyone who can edit HTML can add the script tag. The API method requires a developer to integrate the endpoint into your wallet connection flow.

How does attribution work with tracking links?▼

Create UTM-style tracking links (source/medium/content) and share them. When users click and land on your site, the pixel captures attribution parameters. When they connect a wallet, that wallet is attributed to your campaign.

Can I use both methods together?▼

Yes. The pixel handles most wallet connections automatically. You can use the API for bulk imports, server-side tracking, or special cases. Both feed into the same attribution system.

Is the tracking pixel GDPR compliant?▼

The pixel only tracks wallet addresses (public blockchain data) when users actively connect their wallet. It doesn't use cookies for tracking. Wallet addresses are pseudonymous blockchain identifiers, not personal data under most interpretations.

What happens if a user has multiple wallets?▼

Each wallet connection is tracked separately. If one user connects multiple wallets from the same campaign, each wallet is attributed independently. This gives you accurate conversion counts.

Ready to Start Tracking?

Create your free account and start tracking wallet connections in 5 minutes.

Start FreeLearn More About Attribution

Related Resources