Campaign attributes

From Genesys Documentation
Jump to: navigation, search

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

About campaign attributes

1

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.

UTMParms.png

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

1

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.