Categories help organize your email analytics by enabling you to tag emails by type.

Just as you can view the statistics on all your activity under the ’Statistics’ tab, you can go a step further and view the statistics on a particular category.

The events that can be associated with category include:

  • Emails sent
  • Clicks
  • Opens
  • Bounces
  • Spam Reports
  • Unsubscribes

The actual statistics included vary depending upon the set of enabled Apps. Emails sent, bounces and spam reports will always get tracked. Unsubscribes, Clicks, and Opens require that the associated App is enabled.

Categories must be in 7bit encoding using the US-ASCII character set.
Currently, there is no limit to the number of categories you can track.
Categories should be used to group messages together. If you need to attach unique data or identifiers to a message, use Unique Arguments instead.

Example

You can use SendGrid’s SMTPAPI to add these categories to your email. The following should be added to the email’s header:

1
2
3
{
  "category": "Example Category"
}

In this example, SendGrid would associate statistics for the email containing that header with the category Example Category.

You can assign multiple categories per message, up to 10:

1
2
3
4
5
6
7
8
{
  "category": [
    "dogs",
    "animals",
    "pets",
    "mammals"
  ]
}