Referencing Program Token in Email Scripting Token | Community
Skip to main content
L
LP_IMS_KJB_7016
Level 2
November 14, 2024
Solved

Referencing Program Token in Email Scripting Token

  • November 14, 2024
  • 1 reply
  • 1811 views

Good afternoon,

 

I would like to understand how to reference a Text Token within an Email Script Token, both within the same Email Program.

 

The Email Program contains 3 Text tokens that are used to set UTM values - {{my.UTM-Campaign}}, {{my.UTM-Source}}, & {{my.UTM-Medium}} - and each token contains a string value, e.g. em_20241113, mkto & email-organic.

 

These tokens are used elsewhere within the Program and email content but I would also like to utilise them in an Email Script token also within the same Program.

 

For context, the Email Script Token builds href URLs to be inserted into HTML, using a combination of hard coded elements, lead fields (language & country) and Product IDs, which are extracted from a SFDC Custom Product Object linked to the Person object, i.e. each person can have multiple product preferences and the email displays an image and Product name for each associated product both with the constructed URL included to allow recipients to navigate to the relevant product webpage.

 

Once the URL has been constructed, I want to append the UTM parameters and want to understand how those Text Tokens can be referenced within the Email Script Token.

 

I am currently hard-coding the values as follows and this method works when I use those variable further into the script to construct the appended UTM string:

 

## Set UTM values from Program tokens
#set( $utmSource = "marketo" )
#set( $utmMedium = "email-organic" )
#set( $utmCampaign = "em-reports")

 ## Set URL
#set( $uRLFull = "www.webpage.com/" )
#set( $uRLUTM = "?utm_source=${utmSource}&utm_medium=${utmMedium}&utm_campaign=${utmCampaign}" )
#set( $uRLBuild = "${uRLFull}${uRLUTM}" )

<a href="https://${uRLBuild}" target="_blank" style="font-weight:700; color:#16293F; text-decoration:none">

 

I have attempted the following approaches to retrieve the token values from the Text Program tokens but to no avail:

 

## 1st Attempt - Failed
#set( $utmSource = ${my.UTM-Source} )
#set( $utmMedium = ${my.UTM-Medium} )
#set( $utmCampaign = ${my.UTM-Campaign})

## 2nd Attempt - Failed
#set( $utmSource = $my.UTM-Source )
#set( $utmMedium = $my.UTM-Medium )
#set( $utmCampaign = $my.UTM-Campaign)

## 3rd Attempt - Failed
#set( $utmSource = {{my.UTM-Source}} )
#set( $utmMedium = {{my.UTM-Medium}} )
#set( $utmCampaign = {{my.UTM-Campaign}} )

 

Could you please advise on how I can correctly reference the 3 text Program tokens within the Email Script token and create the full required URL, including the 3 UTM parameters?

 

Regards

This post is no longer active and is closed to new replies. Need help? Start a new post to ask your question.
Best answer by SanfordWhiteman

Nope, that won’t work. That’s a reference to the Velocity object $my with property UTM-campaign, which will not exist.

 

You need to output the Text {{my.token}} in-between Velocity #define and #end, known among experts as the “defineburger” technique.

 

Velocity token {{my.grab utm_campaign}}:

 

#define( $my_utm_campaign )

 

 

Velocity token {{my.end grab token}}:

 

#end

 

 

Then include in this order:

 

{{my.grab utm_campaign}} {{my.utm_campaign}} {{my.end grab token}}

 

 

1 reply

A
AudreonBa
Level 2
November 15, 2024

Hi @lp_ims_kjb_7016,

 

It has been a while since I set up something similar, but it looks like you are missing quotations on your second attempt.

Try the below:

#set($utmSource = "${my.UTM-Source}")
#set($utmMedium = "${my.UTM-Medium}")
#set($utmCampaign = "${my.UTM-Campaign}")
SanfordWhiteman
SanfordWhitemanAccepted solution
Level 10
November 15, 2024

Nope, that won’t work. That’s a reference to the Velocity object $my with property UTM-campaign, which will not exist.

 

You need to output the Text {{my.token}} in-between Velocity #define and #end, known among experts as the “defineburger” technique.

 

Velocity token {{my.grab utm_campaign}}:

 

#define( $my_utm_campaign )

 

 

Velocity token {{my.end grab token}}:

 

#end

 

 

Then include in this order:

 

{{my.grab utm_campaign}} {{my.utm_campaign}} {{my.end grab token}}

 

 

L
LP_IMS_KJB_7016Author
Level 2
November 20, 2024

Hi @sanfordwhiteman & @audreonba,

 

thank you both for your replies and apologies for the delayed response.

 

As per your advice @sanfordwhiteman, I created the following:

 

{{my.grab utm-source}}:

#define( $my_utm_source )

 

{{my.end grab token}}:

#end

 

And the existing {{my.UTM-Source}}:

marketo

I incorporated all of the above as stipulated and attempted to reference the defined variable ($my_utm_source ) in a subsequent #set statement in the {{my.Product-Preferences}} token as follows:

## Set the UTM values from Program tokens ## Retrieve the UTM-Source token value to be used below {{my.grab utm_source}} {{my.UTM-Source}} {{my.end grab token}} #set( $utmMedium = "email-organic" ) #set( $utmCampaign = "em-investment-reports") #set( $uRLUTM = "?utm_source=${my_utm_source}&utm_medium=${utmMedium}&utm_campaign=${utmCampaign}" )

 

However, when I reference that token in the email, the literal values appear as per the defineburger statements

Please advise where I am going amiss?

 

Regards

 

 

 

 

Terms & ConditionsAccessibility statement

Loading footer...