Skip to main content
Dimensions let you break down reports by different attributes. Analyze performance by creative, offer, geography, and more.

​
Built-In Dimensions

DimensionDescription
DateDaily breakdown
WeekWeekly breakdown
MonthMonthly breakdown
CreativeBy message template
OfferBy affiliate offer
Sending ListBy phone number
CampaignBy schedule
Schedule Send TypeType of scheduled send
Is Local TimeWhether send used local time zone
Message Send TypeHow the message was triggered (API, schedule, journey)
Selection MethodCreative selection method (manual, algorithmic)
Offer TypeCategory of affiliate offer
CarrierRecipient mobile carrier
Delivery SuccessWhether message was delivered successfully
Error ReasonReason for delivery failure
Segment IDsAudience segments the contact belongs to

​
Custom Dimensions

Create dimensions from contact custom fields:

​
Setting Up

  1. Go to Account Settings > Reporting
  2. Click Add Dimension
  3. Select a custom field
  4. Name the dimension
  5. Save

​
Example: State

If contacts have a state field:
  1. Add dimension: “State”
  2. Field: state
  3. Reports can now break down by state

​
Cardinality

Dimensions work best with:
  • Low cardinality (few unique values)
  • Meaningful groupings
  • Complete data
Examples:
  • ✅ State (50 values)
  • ✅ Plan type (3 values)
  • ❌ Email (too many unique values)

​
Using Dimensions in Reports

​
Performance Report

  1. Go to Reports > Performance
  2. Select dimension from dropdown
  3. View metrics broken down

​
Example Output

By State: 
California: 10,000 sends, 12% click rate, $2,400 revenue
Texas: 8,000 sends, 11% click rate, $1,760 revenue
Florida: 6,000 sends, 13% click rate, $1,560 revenue

​
Dimension Coverage

Not all contacts may have data for a dimension: 
State dimension:
- Has value: 85%
- Missing: 15%
Missing values appear as “(not set)” in reports.

​
Improving Coverage

  • Require field at signup
  • Enrich data from external sources
  • Default values for common cases

​
Multi-Dimensional Analysis

Combine dimensions for deeper analysis: 
Date + Creative:
Shows how each creative performed each day
Note: More dimensions = more rows = slower reports.

​
Dimension Refresh

Custom dimension stats are calculated periodically:
  • Coverage percentage
  • Unique value count
  • Last updated timestamp
Click Refresh to recalculate.

​
Best Practices

Date, Creative, Offer cover most needs. Add custom only when needed.
Dimensions with 50+ values become hard to analyze. Group values if needed.
Dimensions are only as useful as the underlying data. Validate custom fields.

​
Next Steps

Metrics

Available metrics

Exports

Export data