Campaign attributes

From Genesys Documentation
Jump to: navigation, search
This topic is part of the manual Altocloud Administrator's Guide for version Current of Altocloud.

Learn about the types of attributes that allow you to use UTM parameters to track web activity for a specific campaign.

About campaign attributes


When you create action maps, segments, and outcomes, you use operators to define attributes.

If you use Google Analytics, you can target visitors coming from a marketing campaign where you track URL parameters. To do this, create a segment and define the segment conditions using the campaign attributes, which are located in the Visitor attributes section.

Syntax guidelines

This example illustrates how UTM parameters appear in the address bar for a website.


To create an expression in Altocloud that segments visitors based on these parameters, follow these syntax guidelines:

If your UTM parameter includes this... Type this in Altocloud... Example
a hyphen a hyphen UTM parameter: Existing-Customers

Attribute value in Altocloud: Existing-Customers

%20 a space UTM parameter: Mortgage%20High%20Credit%20Score

Attribute value in Altocloud: Mortgage High Credit Score.

UTM parameters are case-sensitive.

How Altocloud handles multiple visits to the same campaign

Altocloud tracks visits to a website in the following ways:

  • When a user visits your website, Altocloud starts a new visit.
  • If the user leaves your website, or is inactive on that site for more than 30 minutes, Altocloud closes the visit.
  • If a user arrives at your website from different sources, Altocloud creates a new visit for each source and immediately closes any previously open visit to the site.

For example, suppose your company posts a campaign ad on Facebook and Twitter. A user sees the ad on Facebook and clicks it to arrive at your website. A few minutes later, the user sees a similar ad on Twitter and clicks the link, causing them to arrive at your website a second time. In this case, Altocloud ends the user's visit that originated from the Facebook ad and begins a visit for the user's visit that originated from the Twitter ad.

Altocloud tracks each visit to the website as a separate visit. This is true even if the existing visit is still open (that is, less than 30 minutes have elapsed since the last time Altocloud detected user activity on the tracked website).

Types of campaign attributes

Attribute name UTM parameter name as it appears in a webpage URL or search string Example API attribute
Campaign source 'utm_source' direct,


Campaign medium 'utm_medium' direct


Campaign name 'utm_campaign' test campaign

Campaign content 'utm_content'    
Campaign term 'utm_term' device


Campaign click ID 'gclid' CjwKCAiA1ZDiBRAXEiwAIWyNC2J6QZBJYwXHJPsZkhECGKaZ7nRjmNEQzmn1Hqh8Labvn3FQ-Tn1pRoCEDYQAvD_BwE mktCampaign.clickId
Campaign network 'network' search network

display network

Enable campaign tracking


To enable UTM tracking for your website:

  1. Work with your ad network to set up your ad campaigns and identify the UTM parameters you will track. For example, suppose you want to create a new ad campaign called, "SpringSale'.
  2. For each UTM parameter you want to track, create a corresponding segment in Altocloud. For example, create a segment called SpringSale. For the visitor attribute, specify "Campaign name like SpringSale".
  3. When a visitor arrives at a site via a campaign link, Altocloud automatically assigns the SpringSale segment.
UTM parameters are specific to campaign tracking. If you want to use UTM capabilities, be sure to select a parameter with a name that starts with Campaign.