Cueflow.track()

Track custom events to enable behavioral targeting and automatic checklist completion.

Syntax

Cueflow.track(eventName)
Cueflow.track(eventName, properties)

Parameters

Parameter	Type	Required	Description
eventName	string	Yes	Unique identifier for the event
properties	object	No	Additional event data

Basic Example

// Track a simple event
Cueflow.track('signup_completed');

// Track with properties
Cueflow.track('purchase_completed', {
  amount: 99.99,
  plan: 'pro',
  currency: 'USD'
});

Event Naming

Use snake_case for consistent event names:

// Good
Cueflow.track('feature_used');
Cueflow.track('report_exported');
Cueflow.track('team_member_invited');

// Avoid
Cueflow.track('FeatureUsed');
Cueflow.track('feature-used');
Cueflow.track('Feature Used');

Common Events

Onboarding

// User starts onboarding
Cueflow.track('onboarding_started');

// User completes a step
Cueflow.track('onboarding_step_completed', {
  step: 'profile',
  stepNumber: 1
});

// User finishes onboarding
Cueflow.track('onboarding_completed', {
  duration: 300 // seconds
});

Feature Usage

// User uses a feature
Cueflow.track('feature_used', {
  feature: 'advanced_export',
  context: 'dashboard'
});

// User creates something
Cueflow.track('project_created', {
  template: 'blank',
  isFirst: true
});

// User exports data
Cueflow.track('report_exported', {
  format: 'pdf',
  rowCount: 1500
});

Commerce

// User views pricing
Cueflow.track('pricing_viewed', {
  source: 'upgrade_banner'
});

// User starts checkout
Cueflow.track('checkout_started', {
  plan: 'pro',
  billing: 'annual'
});

// User completes purchase
Cueflow.track('purchase_completed', {
  plan: 'pro',
  amount: 99.99,
  currency: 'USD'
});

// User upgrades
Cueflow.track('plan_upgraded', {
  from: 'free',
  to: 'pro'
});

Engagement

// User invites team member
Cueflow.track('team_member_invited', {
  role: 'member'
});

// User connects integration
Cueflow.track('integration_connected', {
  provider: 'slack'
});

// User shares content
Cueflow.track('content_shared', {
  type: 'report',
  method: 'email'
});

Using Events for Targeting

After tracking events, you can target messages based on user behavior:

Has Done / Has Not Done

// Track when user uses advanced features
Cueflow.track('advanced_export_used');

Target users who haven't used it:

• Rule: Event "advanced_export_used" has not done

Event Count

// Track each report created
Cueflow.track('report_created');

Target power users:

• Rule: Event "report_created" count greater than 10

Recency

// Track feature usage
Cueflow.track('dashboard_viewed');

Target inactive users:

• Rule: Event "dashboard_viewed" last done before 7 days

Automatic Checklist Completion

Events can automatically mark checklist items as complete:

1. Create a checklist item in the dashboard

2. Set completion type to "Automatic"

3. Configure the event trigger (e.g., project_created)

When you track that event:

Cueflow.track('project_created');
// Checklist item "Create your first project" auto-completes!

The checklist UI updates immediately to show completion.

Event Properties

Supported Types

Type	Example
String	plan: "enterprise"
Number	amount: 99.99
Boolean	isFirstPurchase: true

Best Practices

// Good - flat structure with relevant context
Cueflow.track('purchase_completed', {
  amount: 99.99,
  plan: 'pro',
  isUpgrade: true
});

// Avoid - nested objects
Cueflow.track('purchase_completed', {
  details: {
    amount: 99.99,
    plan: {
      name: 'pro'
    }
  }
});

Queuing Behavior

If you call track() before initialization completes, events are queued and sent automatically:

Cueflow.init({ id: 'user-123' });

// This is safe - will be queued if init hasn't completed
Cueflow.track('page_loaded');

Framework Examples

React

function ExportButton() {
  const handleExport = async (format) => {
    await exportReport(format);

    // Track the event
    Cueflow.track('report_exported', { format });
  };

  return (
    <button onClick={() => handleExport('pdf')}>
      Export PDF
    </button>
  );
}

Vue

<template>
  <button @click="handleExport('pdf')">Export PDF</button>
</template>

<script>
export default {
  methods: {
    async handleExport(format) {
      await this.exportReport(format);
      Cueflow.track('report_exported', { format });
    }
  }
}
</script>

Vanilla JavaScript

document.getElementById('export-btn').addEventListener('click', () => {
  // Perform action
  exportReport();

  // Track event
  Cueflow.track('report_exported', {
    format: 'pdf'
  });
});

Requirements

• Must call Cueflow.init() first (events are queued if init is in progress)

• eventName must be a non-empty string

API vs Embed Script

Use Embed Script	Use API
User interactions (clicks, form submits)	Server-side events (webhooks)
Client-side feature usage	Background jobs
Real-time tracking	Batch processing

For server-side events, use the Events API.

Next Steps

• Event-Based Targeting - Target users by behavior

• Events API - Server-side event tracking