Naming Conventions

// ✅ Correct
Cryptique.track('swap_completed');
Cryptique.track('nft_minted');
Cryptique.track('liquidity_added');

// ❌ Avoid
Cryptique.track('SwapCompleted');      // PascalCase
Cryptique.track('swap-completed');     // kebab-case
Cryptique.track('Swap Completed');     // Title Case with spaces
Cryptique.track('swapcompleted');      // No separation

// ✅ Clear actions
'button_clicked'
'form_submitted'
'swap_initiated'
'swap_completed'
'wallet_connected'
'token_approved'

// ❌ Unclear or passive
'button'              // What about it?
'swap'                // Started? Finished? Viewed?
'user_data'           // Not an action
'page'                // Not descriptive

// Object + Action
'pool_created'
'token_selected'
'position_opened'
'order_placed'
'notification_dismissed'

// Action + Object (also acceptable)
'created_pool'
'selected_token'
'opened_position'

// ✅ Past tense - action completed
'swap_completed'
'transaction_confirmed'
'onboarding_finished'

// ✅ Present tense - action initiated
'swap_initiated'
'checkout_started'
'form_submitted'

// ❌ Avoid imperative/future
'complete_swap'        // Sounds like a command
'will_swap'            // Future tense

// Onboarding flow
'onboarding_started'
'onboarding_step_completed'
'onboarding_skipped'
'onboarding_finished'

// Swap flow
'swap_initiated'
'swap_quoted'
'swap_approved'
'swap_completed'
'swap_failed'

// Settings
'settings_opened'
'settings_changed'
'settings_saved'

// ✅ Correct
{
  input_token: 'ETH',
  output_token: 'USDC',
  amount_usd: 1500.00,
  slippage_percent: 0.5
}

// ❌ Avoid
{
  inputToken: 'ETH',       // camelCase
  'output-token': 'USDC',  // kebab-case
  AmountUSD: 1500.00,      // PascalCase
  'Amount USD': 1500.00    // Spaces
}

// ✅ Specific
{
  input_token: 'ETH',
  output_token: 'USDC',
  input_amount: 1.5,
  output_amount: 1500.00
}

// ❌ Vague
{
  token: 'ETH',           // Which token?
  amount: 1500.00,        // Of what?
  value: 1.5              // Meaning unclear
}

// ✅ Clear units
{
  amount_usd: 1500.00,
  amount_eth: 1.5,
  duration_seconds: 180,
  slippage_percent: 0.5,
  gas_gwei: 30
}

// ❌ Ambiguous
{
  amount: 1500.00,        // USD? ETH? Tokens?
  duration: 180,          // Seconds? Minutes?
  slippage: 0.5           // Percent? Decimal?
}

// ✅ Clear booleans
{
  is_first_purchase: true,
  has_referral: false,
  was_discounted: true,
  can_stake: true
}

// ❌ Unclear
{
  first_purchase: true,   // Is it the first? Or details about it?
  referral: false,        // Has one? Is one? Details?
  discounted: true        // Was it? Can it be?
}

// User counts
user_count: 150
active_user_count: 75

// Totals
total_volume: 50000
total_transactions: 230

// Timestamps
created_at: '2024-01-15T10:30:00Z'
updated_at: '2024-01-16T14:20:00Z'

Cryptique.identify('user_12345');

Cryptique.people.set({
  // Standard identity
  email: 'user@example.com',
  username: 'defi_whale',
  name: 'John Doe',
});

Cryptique.people.set({
  // Dates
  signup_date: '2024-01-01',
  first_purchase_date: '2024-01-15',
  last_active_date: '2024-01-20',
  
  // Status
  account_status: 'active',
  subscription_tier: 'pro',
  
  // Counts (use increment for these)
  // total_purchases: 5,   // Better with increment()
});

Cryptique.people.set({
  // Wallet info
  primary_chain: 'ethereum',
  connected_wallet_count: 2,
  
  // Activity
  first_transaction_date: '2024-01-10',
  favorite_protocol: 'uniswap',
  
  // Segments
  trader_type: 'active',     // active, casual, whale
  nft_collector: true
});

// ❌ Don't include IDs in event names
'viewed_token_0x1234...'
'clicked_button_abc123'

// ✅ Use properties instead
Cryptique.track('token_viewed', { token_address: '0x1234...' });
Cryptique.track('button_clicked', { button_id: 'abc123' });

// ❌ Don't generate event names dynamically
Cryptique.track(`${action}_${object}`);  // Could create thousands of events

// ✅ Use a standard event with properties
Cryptique.track('user_action', {
  action_type: action,
  target_object: object
});

// ❌ Too granular - will create noise
'mouse_moved'
'key_pressed'
'scroll_pixel_changed'

// ✅ Meaningful milestones
'scroll_depth_reached'   // At 25%, 50%, 75%, 100%
'form_field_completed'   // When moving to next field

// ❌ Never include PII in event names
'user_john@example.com_logged_in'
'wallet_0x1234_connected'

// ✅ Use properties
Cryptique.track('user_logged_in', { user_id: '12345' });
Cryptique.track('wallet_connected', { wallet_address: '0x1234...' });

// Product/token views
'token_viewed'
'pool_viewed'
'product_viewed'

// Cart/swap actions
'swap_initiated'
'item_added_to_cart'
'cart_updated'

// Checkout/transaction
'checkout_started'
'transaction_approved'
'purchase_completed'
'swap_completed'

// Onboarding
'signup_started'
'signup_completed'
'email_verified'
'profile_completed'

// Engagement
'feature_discovered'
'tutorial_completed'
'milestone_reached'

// Retention
'session_started'
'returned_after_absence'
'subscription_renewed'

// Wallet
'wallet_connected'
'wallet_switched'
'chain_changed'

// Transactions
'transaction_initiated'
'transaction_signed'
'transaction_confirmed'
'transaction_failed'

// DeFi
'liquidity_added'
'liquidity_removed'
'stake_deposited'
'rewards_claimed'