Add custom link tracking parameters to messages

You can add link tracking parameters to all links in both campaign and journey text and email messages to help you better track performance and subscriber actions.

For example, you can add a link tracking parameter like event=holiday_sale to a campaign message announcing a holiday sale to differentiate it from other kinds of campaign messages, like those for newsletters or product announcements.

In addition to freeform text, you can also use variables like {{message.messageId}} as values in link tracking parameters.

Add link tracking parameters to a text message

Follow these steps to add link tracking parameters to a text message:

  1. Create or edit a text message in a campaign or journey.
  2. Add or edit a shortlink in a campaign or journey text message.
  3. Click + Add a custom link parameter.
  4. Enter a parameter Name and Value. For example, to add a parameter to track an email message for a holiday sale, enter event as its Name and holiday_sale as its Value.
    • In addition to static values, you can also add variables, like {{subscriber.email}}. Click { } to add a variable.
    • If Enable Google Analytics Link Tracking is turned on, a parameter named utm_campaign is automatically created for you. Click the checkbox to turn it on or off. If it’s turned on, be sure to add a value.
    • You can combine freeform text and multiple variables in a value. For example: holiday_sale_{{message.messageId}}_{{message.messageName}}
  5. (Optional) Click + Add a custom link parameter to create additional parameters.
  6. (Optional) Click the X next to a parameter to remove it.
  7. Click Save.
Animation showing creation of a link tracking parameter for a text message for a seasonal campaign.

Add a link tracking parameter to an email message

  1. Create or edit a text message in a campaign or journey.
  2. For campaigns, click Add or Edit in the Email details section for the message you want to add parameters to. For journeys, click the Send email step for the message you want to add parameters to.
  3. Under Link tracking, click + Add a custom link parameter.
  4. Enter a parameter Name and Value. For example, to add a parameter to track an email message for a holiday sale, enter event as its Name and holiday_sale as its Value.
    1. In addition to static values, you can also add variables, like {{subscriber.email}}. Click { } to add a variable.
    2. If Enable Google Analytics Link Tracking is turned on, the UTM campaign (optional) field appears and is prepopulated with a value, which you can change.
    3. You can combine freeform text and multiple variables in a value. For example: holiday_sale_{{message.messageId}}_{{message.messageName}}
  5. (Optional) Click + Add custom link parameter to create additional parameters.
  6. (Optional) Click the X next to a parameter to remove it.
  7. Click Save.
Animation showing creation of a link tracking parameter for an email message for a seasonal campaign.

Add variables to link tracking parameters

In addition to static values, you can also add variables to link tracking parameter values. This allows you to track performance of specific messages and by individual subscribers.

The following variables are supported:

Variable Description
{{message.messageId}} The individual ID of the message in Attentive that this parameter is appended to.
{{message.messageName}} The name of the message at send time in Attentive that this parameter is appended to.
{{message.messageType}} The type of message this parameter is appended to (concierge, marketing, or transactional).
{{subscriber.email}} The email address of the subscriber an individual message was sent to.

For example, a text message is sent with the following link tracking parameters:

Name Value
event holiday_sale
id {{message.messageId}}
email {{subscriber.email}}

If the messageID is 1234567 and the subscriber’s email address is firstname@test.com, then the URL will look like this:

https://www.yoursite.com?utm_medium=sms&utm_source=attentive&event=holiday_sale&id=1234567&email=firstname@test.com

Articles in this section

Was this article helpful?
0 out of 0 found this helpful