Tracking for cloud app templates

For cloud app templates, you can manually include UTM parameters and custom tracking attributes in the links within the template.

Impression and click callback URLs can also be explicitly added to enable tracking of user impressions and clicks.

UTM and custom tracking parameters

You can manually append the UTM parameters to the links within the cloud app template.

Use the {{tracking_params}} Liquid variable to access available parameters.

Option 1:

Specify each tracking parameter individually using the following Liquid variables:

• utm_campaign: {{tracking_params.utm_campaign}}
• utm_source: {{tracking_params.utm_source}}
• utm_medium: {{tracking_params.utm_medium}}

Here’s an example of appending tracking parameters to the action_web_target URL:

"action_web_target": "https://www.demosite.com/whatsnew?nwmsgid={{message_uuid}}&utm_campaign={{tracking_params.utm_campaign}}&utm_medium={{tracking_params.utm_medium}}&utm_source={{tracking_params.utm_source}}"

Option 2:

You can alternatively convert the entire {{tracking_params}} payload into a JSON string and encode it in base64 to use it as a single attribute.

    "tracking_params": "{{tracking_params | json | base64_strict_encode}}"

After receiving the payload, decode the base64 string and parse the JSON to extract the complete hash of tracking parameters for orchestration.

Impression and click tracking

Blueshift enables impression and click tracking for cloud app templates using impression and click callback URLs. Unlike emails, these URLs are not automatically tracked and must be included in the message payload.

• Impression URL: {{tracking.impression_url}}
• Click URL: {{tracking.click_url}}

An impression or click is recorded when an HTTP GET request is made to the respective URL.