Message Tagging with the MailingID and MessageID Parameters

SocketLabs enables advanced reporting and tracking of your messages by allowing you to tag them with your own user-defined Message and Mailing(Campaign) identifiers.

Two identifiers are supported: MessageId and MailingId. The MessageID can be unique per message and is used to identify a specific message or a recipient of a message. The MailingID is designed to identify a batch, job, campaign, or other group of messages. SocketLabs automatically aggregates performance data across the MailingID parameter, but does not aggregate data cross the MessageID parameter. Both identifiers are exposed by the API to help you match email events with source data.

Message and Mailing ID's are automatically added into messages sent from the SocketLabs Email Marketing Center. However, test messages sent from within the Content Creator will not be tagged in this way.

To tag your outbound messages with these identifiers, include this data in standard email headers. The following headers are supported:

X-xsMessageId - Specifies a message id. Valid characters include 0-9, A-Z, a-z and hyphen.

X-xsMailingId - Specifies a mailing/campaign id. Valid characters include 0-9, A-Z, a-z and hyphen.

Using excessive (100k+) X-xsMailingId values (such as specifying a unique value per individual message) could degrade performance and your experience with the SocketLabs Control Panel. This value should be used as a grouping code and should not be set to a value that changes with every message.

Here are examples of what the headers could look like:

X-xsMessageId: 35649f94-1e2d-4f65-a500-f1640927cea1

X-xsMailingId: WebOrderConfirmation