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. First, create a segment and then define the segment conditions using the campaign attributes. For more information, see the campaign attributes in the Visitor attributes table.

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 Genesys Predictive Engagement...	Example
a hyphen	a hyphen	UTM parameter: Existing-Customers Attribute value in Genesys Predictive Engagement: Existing-Customers
%20	a space	UTM parameter: Mortgage%20High%20Credit%20Score Attribute value in Genesys Predictive Engagement: 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 visitor visits your website, Genesys Predictive Engagement starts a new visit.
• If the visitor leaves your website, or is inactive on your site for more than 30 minutes, Genesys Predictive Engagement closes the visit.
• If a visitor arrives at your website from different sources, Genesys Predictive Engagement creates a new visit for each source and closes any previously open visit to the site.

For example, suppose your company posts a campaign ad on Facebook and Twitter. Someone sees the ad on Facebook and clicks it to arrive at your website. A few minutes later, the visitor 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 visit that originated from the Facebook ad and begins a visit for the one that originated from the Twitter ad.

Important

Genesys Predictive Engagement tracks each visit to the website as a separate visit, even if the existing visit is still open. An open visit means that less than 30 minutes have elapsed since the last time Genesys Predictive Engagement detected visitor 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 to track. For example, suppose you want to create a new ad campaign called, "SpringSale'.
2. For each UTM parameter that 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 through a campaign link, Genesys Predictive Engagement assigns the SpringSale segment.

Important

UTM parameters are specific to campaign tracking. To use UTM capabilities, select a parameter with a name that starts with Campaign.