# Campaign Tracking

> Monitor your WhatsApp campaigns in real-time, understand message statuses, track delivery and engagement metrics, and handle failed messages.

Source: https://edesy.in/docs/waflow/campaigns/tracking

Effective campaign tracking helps you understand what's working and optimize future campaigns. Waflow provides comprehensive real-time monitoring, detailed status tracking, and actionable insights for every campaign.

## Real-Time Progress Monitoring

Once a campaign starts sending, you can monitor its progress in real-time.

### Accessing Campaign Dashboard

1. Go to **Campaigns** in your workspace
2. Click on an active or completed campaign
3. The campaign dashboard opens with live statistics

### Live Statistics View

The dashboard displays:

```
Campaign: Holiday Sale Announcement
Status: Sending
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 67%

Total:     15,000    |  Sent:      10,050
Queued:     4,950    |  Delivered:  8,742
Failed:       208    |  Read:       6,127
```

### Progress Bar

The progress bar shows:
- **Queued** (gray): Messages waiting to send
- **Sent** (blue): Messages transmitted to WhatsApp
- **Delivered** (green): Messages confirmed received
- **Failed** (red): Messages that could not be delivered

### Auto-Refresh

The dashboard automatically refreshes every few seconds during active sending. You can also:
- Click **Refresh** for immediate update
- Adjust refresh interval in settings
- Pause auto-refresh if needed

## Message Statuses

Understanding message statuses helps you interpret campaign performance.

### Status Lifecycle

Each message progresses through statuses:

```
Queued → Sent → Delivered → Read
                    ↓
                  Failed
```

### Status Definitions

#### Queued

**What it means:** Message is waiting in the send queue.

**Why it happens:**
- Campaign just started
- Rate limiting in effect
- Processing in progress

**Normal behavior:** Count decreases as messages are sent.

#### Sent

**What it means:** Message has been transmitted to WhatsApp servers.

**What it confirms:**
- Message left Waflow successfully
- WhatsApp accepted the message
- Delivery in progress

**Note:** "Sent" does not guarantee delivery to the recipient.

#### Delivered

**What it means:** Message has reached the recipient's device.

**What it confirms:**
- Message is on the recipient's phone
- WhatsApp delivered successfully
- Recipient can see the message

**Indicators of success:** Single checkmark in WhatsApp.

#### Read

**What it means:** Recipient has opened and viewed the message.

**What it confirms:**
- Recipient saw the message
- Message appeared on screen
- Active engagement occurred

**Indicators:** Double blue checkmarks in WhatsApp.

> **Note:** Read receipts depend on recipient settings. Some users disable read receipts, so "Delivered" may be the final status you see.

#### Failed

**What it means:** Message could not be delivered.

**Possible causes:**
- Invalid phone number
- Recipient blocked your number
- Phone is off for extended period
- WhatsApp account doesn't exist
- Technical delivery failure

### Status Timing

| Status Transition | Typical Time |
|-------------------|--------------|
| Queued → Sent | Seconds to minutes |
| Sent → Delivered | Seconds to hours |
| Delivered → Read | Minutes to days |
| Sent → Failed | Seconds to 24 hours |

## Tracking Dashboard

### Overview Tab

The overview provides at-a-glance metrics:

**Delivery Metrics:**
- Total messages
- Sent count and percentage
- Delivered count and percentage
- Failed count and percentage

**Engagement Metrics:**
- Read rate
- Reply count
- Button click count
- Opt-out count

### Timeline View

See how your campaign progressed over time:

- Messages sent per minute/hour
- Cumulative delivery chart
- Engagement pattern visualization
- Peak engagement times

### Geographic Distribution

If location data is available:
- Map of message delivery
- Country/region breakdown
- Time zone distribution

## Handling Failed Messages

Failed messages need attention to maximize campaign reach.

### Viewing Failed Messages

1. Go to campaign dashboard
2. Click **Failed Messages** tab
3. View list with failure reasons

### Common Failure Reasons

| Reason | Description | Action |
|--------|-------------|--------|
| Invalid number | Phone number format incorrect | Update contact data |
| Not on WhatsApp | Number not registered with WhatsApp | Remove or use alternative channel |
| Blocked | Recipient blocked your number | Remove from list |
| Phone off | Device unreachable for 24+ hours | May retry later |
| Rate limited | Exceeded sending limits | Messages will retry |
| Template issue | Template no longer available | Check template status |

### Retry Logic

Waflow automatically retries certain failed messages:

**Automatic retry:**
- Rate limiting failures
- Temporary network issues
- Server timeouts

**Retry schedule:**
- First retry: After 5 minutes
- Second retry: After 30 minutes
- Third retry: After 2 hours
- Final retry: After 24 hours

**No retry (permanent failures):**
- Invalid numbers
- Blocked contacts
- Non-existent accounts

### Manual Retry

For eligible failed messages:

1. Select failed messages to retry
2. Click **Retry Selected**
3. Messages return to queue
4. Monitor new delivery attempts

### Export Failed List

Download failed messages for analysis:

1. Click **Export Failed**
2. Choose format (CSV or Excel)
3. File includes:
   - Contact information
   - Failure reason
   - Timestamp
   - Retry count

## Engagement Tracking

Beyond delivery, track how recipients interact with your messages.

### Read Tracking

**Metrics:**
- Read count
- Read rate (reads / delivered)
- Average time to read
- Read by time of day

**Interpreting read rates:**

| Read Rate | Assessment |
|-----------|------------|
| 80%+ | Excellent |
| 60-80% | Good |
| 40-60% | Average |
| Below 40% | Needs improvement |

> **Note:** Some recipients disable read receipts, so actual engagement may be higher than reported.

### Reply Tracking

Track conversations started from your campaign:

**Metrics:**
- Reply count
- Reply rate (replies / delivered)
- Average response time
- Common reply themes

**Where to find:**
1. Campaign dashboard > **Replies** tab
2. View individual conversations
3. Respond to messages from dashboard

### Button Click Tracking

For templates with interactive buttons:

**Metrics:**
- Total clicks
- Click rate by button
- Click timing patterns

**Available for:**
- Website URL buttons
- Quick reply buttons
- Call buttons (call initiated)

### Link Click Tracking

If using trackable links in your message:

**Metrics:**
- Total link clicks
- Unique clickers
- Click-through rate
- Device types

> **Note:** Link tracking requires using Waflow's link tracking feature.

## Campaign Reports

### Generating Reports

Create detailed reports for analysis:

1. Go to campaign dashboard
2. Click **Generate Report**
3. Select report type:
   - Summary report
   - Detailed delivery report
   - Engagement report
   - Failed messages report
4. Choose format (PDF, CSV, Excel)
5. Download or email report

### Report Contents

**Summary Report includes:**
- Campaign overview
- Key metrics
- Performance comparison
- Recommendations

**Detailed Delivery Report includes:**
- Every message with status
- Timestamps for each status change
- Recipient information
- Variable values used

**Engagement Report includes:**
- Read rates over time
- Reply analysis
- Button click data
- User engagement patterns

### Scheduled Reports

Set up automatic report generation:

1. Go to **Settings** > **Reports**
2. Click **Add Scheduled Report**
3. Select campaigns or campaign types
4. Set frequency (daily, weekly, monthly)
5. Add email recipients

## Comparative Analytics

Compare performance across campaigns.

### Campaign Comparison

Compare two or more campaigns:

1. Go to **Analytics** > **Compare**
2. Select campaigns to compare
3. View side-by-side metrics

**Comparison metrics:**
- Delivery rates
- Read rates
- Reply rates
- Failure rates
- Cost per message

### Trend Analysis

Track performance over time:

- Weekly/monthly trends
- Seasonal patterns
- Template performance ranking
- Audience segment comparison

## Notification and Alerts

Stay informed about campaign progress.

### Email Notifications

Receive emails for:
- Campaign started
- Campaign completed
- High failure rate detected
- Unusual patterns observed

**Configure:**
1. Go to **Settings** > **Notifications**
2. Select events to notify
3. Add email recipients
4. Set threshold for failure alerts

### In-App Notifications

Waflow shows notifications for:
- Status changes
- Completion alerts
- Issues requiring attention

### Webhook Notifications

For integrations, configure webhooks:

1. Go to **Settings** > **Webhooks**
2. Add endpoint URL
3. Select events to trigger
4. Webhooks fire in real-time

**Available events:**
- `campaign.started`
- `campaign.completed`
- `message.delivered`
- `message.failed`
- `message.read`

## Troubleshooting Tracking Issues

### Status Not Updating

**Possible causes:**
- Delay in WhatsApp status updates
- Dashboard not refreshing
- Network connectivity issues

**Solutions:**
- Wait a few minutes
- Click manual refresh
- Check Waflow status page

### Missing Read Status

**Possible causes:**
- Recipient disabled read receipts
- Message not yet opened
- Privacy settings on recipient's device

**Note:** This is normal behavior; not all reads can be tracked.

### Unexpected High Failure Rate

**Investigate:**
1. Check failure reasons breakdown
2. Review contact list quality
3. Verify template is still approved
4. Check account sending limits

**Actions:**
- Clean contact list
- Update invalid numbers
- Contact support if technical issue

### Engagement Data Not Showing

**Possible causes:**
- Too early (engagement takes time)
- Buttons/links not configured
- Tracking not enabled

**Solutions:**
- Wait 24-48 hours for engagement data
- Verify button configuration
- Enable link tracking for URLs

## Best Practices for Tracking

### Before Campaign

1. **Set benchmarks**: Know what success looks like
2. **Define KPIs**: Identify key metrics to track
3. **Prepare for failures**: Have a retry strategy

### During Campaign

1. **Monitor actively**: Watch for issues early
2. **Respond to replies**: Engage promptly
3. **Note observations**: Track unusual patterns

### After Campaign

1. **Wait for final status**: Allow 24-48 hours
2. **Generate reports**: Document performance
3. **Analyze results**: Identify improvements
4. **Clean lists**: Remove failed contacts
5. **Apply learnings**: Improve next campaign

## Next Steps

- [Campaigns Overview](https://edesy.in/docs/waflow/campaigns) - Campaign fundamentals
- [Campaign Scheduling](https://edesy.in/docs/waflow/campaigns/scheduling) - Timing optimization
- [Analytics Overview](https://edesy.in/docs/waflow/analytics) - Deeper analytics insights