ATC/Current/AdminGuide/Campaign Attributes

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 Genesys Predictive Engagement 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.

Important

UTM parameters are case-sensitive.

How Genesys Predictive Engagement handles multiple visits to the same campaign

Genesys Predictive Engagement tracks visits to a website in the following ways:

• When a user visits your website, Genesys Predictive Engagement starts a new visit.
• If the user leaves your website, or is inactive on that site for more than 30 minutes, Genesys Predictive Engagement closes the visit.
  
• If a user arrives at your website from different sources, Genesys Predictive Engagement 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, Genesys Predictive Engagement 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.

Important

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 Genesys Predictive Engagement 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, adWords,google	mktCampaign.source
Campaign medium	'utm_medium'	direct organicsocialppcwebsite-ppc	mktCampaign.medium
Campaign name	'utm_campaign'	test campaign Summer19	mktCampaign.name
Campaign content	'utm_content'
Campaign term	'utm_term'	device trialsubscription	mktCampaign.term
Campaign click ID	'gclid'	CjwKCAiA1ZDiBRAXEiwAIWyNC2J6QZBJYwXHJPsZkhECGKaZ7nRjmNEQzmn1Hqh8Labvn3FQ-Tn1pRoCEDYQAvD_BwE	mktCampaign.clickId
Campaign network	'network'	search network display network	mktCampaign.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 Genesys Predictive Engagement. 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, Genesys Predictive Engagement automatically assigns the SpringSale segment.

Important

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.