Quickstart

Overview

This guide will get you tracking user behavior and wallet connections in about 5 minutes. By the end, you’ll have:

✅ Automatic page, click, scroll, and form signals (when auto-events="true")
✅ Session tracking via the SDK session model
✅ Wallet linking with Cryptique.walletAddress() (and optional custom events)
✅ Data flowing to your dashboard

Prerequisites

A Cryptique account (sign up here)
Access to your website’s HTML or build system
Your Site ID from the Cryptique dashboard

Step 1: Get Your Site ID

Log in to app.cryptique.io
Navigate to Settings → Sites
Click Add Site or select an existing site
Copy your Site ID (format: your-domain-xx)

Step 2: Add the Tracking Script

Choose your installation method:

CDN (Recommended)
npm
Google Tag Manager

Add this script to your HTML, just before the closing </head> tag:

<script>
  var script = document.createElement('script');
  script.src = 'https://cdn.cryptique.io/scripts/analytics/1.0.1/cryptique.script.min.js';  
  script.setAttribute('site-id', 'YOUR_SITE_ID');
  script.setAttribute('auto-events', 'true');
  document.head.appendChild(script);
</script>

Replace YOUR_SITE_ID with your actual Site ID.

Install the package:

npm install cryptique-sdk

Initialize in your app:

import Cryptique from 'cryptique-sdk';

// Initialize (async)
await Cryptique.init({
  siteId: 'YOUR_SITE_ID',
  autoEvents: true
});

Step 3: Verify Installation

Visit your website
Open your browser’s developer console (F12)
Look for: [Cryptique] Initialized successfully
Go to your Cryptique dashboard → Live Events
You should see events appearing in real-time

Events may take up to 60 seconds to appear in the dashboard. If you don’t see events after 2 minutes, check the troubleshooting guide.

Step 4: Track Custom Events

Beyond auto-events, track specific actions that matter to your product:

// Track a custom event
Cryptique.track('swap_initiated', {
  input_token: 'ETH',
  output_token: 'USDC',
  amount: 1.5
});

Step 5: Track Wallet Connections

When a user connects their wallet:

// After wallet connection (e.g., via wagmi, ethers, web3-react)
Cryptique.walletAddress(walletAddress);

If you’re using standard wallet libraries, Cryptique can auto-detect wallet connections. Enable with:

<script>
  var script = document.createElement('script');
  script.src = 'https://cdn.cryptique.io/scripts/analytics/1.0.1/cryptique.script.min.js';  
  script.setAttribute('site-id', 'YOUR_SITE_ID');
  script.setAttribute('auto-events', 'true');
  script.setAttribute('auto-wallet-detect', 'true');
  document.head.appendChild(script);
</script>

Step 6: Identify Users

When a user logs in or you know their identity:

Cryptique.identify('user_12345');

// Set user properties
Cryptique.people.set({
  email: 'user@example.com',
  plan: 'pro',
  signup_date: '2024-01-15'
});

This links all their past anonymous activity to their identified profile.

What’s Being Tracked?

With auto-events enabled, the SDK sends many named auto events. Common ones:

Event	Description
`page_view`	Page load / route with timing context
`element_click`	Clicks with element and coordinate metadata
`rage_click` / `dead_click`	Frustration and non-interactive click patterns
`page_scroll`	Increasing scroll depth
`form_submit`	Form submits (metadata only, no field values)
`text_selection` / `copy_action`	Selection and copy signals
`page_summary`	Aggregated engagement when the user leaves or hides the tab

See the full list in Auto-Events. Wallet connect/disconnect are not built-in auto events — use Cryptique.walletAddress() and Cryptique.track() if you want them in the event stream.

Example: Complete Setup

Here’s a complete example for a DeFi app:

<!DOCTYPE html>
<html>
<head>
  <title>My DeFi App</title>
  
  <!-- Cryptique Tracking -->
  <script>
    var script = document.createElement('script');
    script.src = 'https://cdn.cryptique.io/scripts/analytics/1.0.1/cryptique.script.min.js';  
    script.setAttribute('site-id', 'mydefi-app-42');
    script.setAttribute('auto-events', 'true');
    document.head.appendChild(script);
  </script>
</head>
<body>
  <!-- Your app content -->
  
  <script>
    // Track custom events when they happen
    function onSwapComplete(txHash, inputToken, outputToken, amount) {
      Cryptique.track('swap_completed', {
        transaction_hash: txHash,
        input_token: inputToken,
        output_token: outputToken,
        amount_usd: amount
      });
    }
    
    // Track wallet connection
    async function connectWallet() {
      const accounts = await ethereum.request({ 
        method: 'eth_requestAccounts' 
      });
      
      Cryptique.walletAddress(accounts[0]);
      Cryptique.track('wallet_connected', {
        wallet_type: 'metamask',
        chain_id: await ethereum.request({ method: 'eth_chainId' })
      });
    }
  </script>
</body>
</html>

Troubleshooting

Events not appearing in dashboard

Check browser console for errors
Verify your Site ID is correct
Ensure the script loads before user interactions
Check that your domain is allowed in site settings
Disable ad blockers temporarily

Script not loading

Check for Content Security Policy (CSP) blocks
Verify the CDN URL is correct
Try the npm package instead

Wallet events not tracking

Call Cryptique.walletAddress(address) after the wallet connects
Pass a valid address (0x…)
If you rely on a custom event (e.g. wallet_connected), call Cryptique.track() yourself — it is not emitted automatically

Next Steps

Add Smart Contracts

Track on-chain transactions

Enable Wallet Enrichment

Get rich user profiles

Build Your First Report

Create insights from your data

SDK Reference

Full SDK documentation

INTRO

DATA IN

DATA MODEL

BEST PRACTICES

Overview

Prerequisites

Step 1: Get Your Site ID

Step 2: Add the Tracking Script

Step 3: Verify Installation

Step 4: Track Custom Events

Step 5: Track Wallet Connections

Step 6: Identify Users

What’s Being Tracked?

Example: Complete Setup

Troubleshooting

Next Steps

Add Smart Contracts

Enable Wallet Enrichment

Build Your First Report

SDK Reference

​Overview

​Prerequisites

​Step 1: Get Your Site ID

​Step 2: Add the Tracking Script

​Step 3: Verify Installation

​Step 4: Track Custom Events

​Step 5: Track Wallet Connections

​Step 6: Identify Users

​What’s Being Tracked?

​Example: Complete Setup

​Troubleshooting

​Next Steps

Add Smart Contracts

Enable Wallet Enrichment

Build Your First Report

SDK Reference

Overview

Prerequisites

Step 1: Get Your Site ID

Step 2: Add the Tracking Script

Step 3: Verify Installation

Step 4: Track Custom Events

Step 5: Track Wallet Connections

Step 6: Identify Users

What’s Being Tracked?

Example: Complete Setup

Troubleshooting

Next Steps