Skip to Content
Author's profile photo Michael Rey

Multiple url parameters in email templates in SAP Marketing Cloud

Context

Emails sent out within a campaign often include links to web pages / shops / product pages, for example a link to order the particular product. To track the success usually parameters are added to the link.

On the UI in the message editor of SAP Marketing Cloud one can add one parameter that can carry either a constant or a personalized value. Additionally a tracking ID (or SAP Outbound ID) can be added that can be used e.g. to prefill landing pages.

In some cases it is necessary to add multiple parameters to an url in the email, for example Google Analytics has up to 5 parameters. In this blog we describe how these parameters can be added to the email.

 

Multiple parameters

All static parameters need to be assembled to a long url string and inserted it into the field <URL or fallback URL> on the message app.

When the email is sent, this url with all the parameters is added to the message.

Google Analytics parameters

To measure the success of the campaign with Google Analytics various parameters need to be added to the links in the email.

With the email editor this integration comes out of the box.

In the link properties area there is a checkbox (that is defaulted) that triggers appending the url when sending the email.

When checked the parameters of Google Analytics are filled like this:

  • utm_source : SAPHybris
  • utm_medium : email
  • utm_campaign : campaign ID.  Note that the campaign ID is used as the campaign name isn’t unique. 
  • utm_content: language of email___name of condition block (if defined).  Here we insert the language of the email and the name of the condition where the link is contained. this two pieces of information are separated by three underscores.
  • utm_term: email name___link name___ product or offer recommendation. In this parameter we insert the name of the email and the name of the link to support a tracking which link drove a conversion. All the pieces of information are separated by three underscores.

See this example:

The link for the picture in the email would look like this:

http://www.hybris.com/en/?utm_source=SAPHybris&utm_medium=email&utm_campaign=1234&utm_term=SAP%2520Hybris%2520Marketing%25201708___Link%2520to%2520Hybris.com&utm_content=EN

(Note: the %2520 represents the blank character)

Note that when loading data from Google Analytics into SAP Marketing Cloud we check the utm_medium on email and then we add the campaign ID, the email name and the link name to the business document (the sales order). By doing this SAP Marketing Cloud is able to track email open, email clicks, link clicks (natively from SAP Marketing Cloud) and conversion on granularity of links in emails (delivered via Google Analytics).

Note: To use the tracking down to link level, you must avoid using triple underscores in the names of email or the link.

In case your web analytics experts need different parameter information, please use the BADI to adapt to your needs. However keep in mid that on SAP Marketing Cloud there is an implemented logic for campaign ID, email name and link name as described in the paragraph above.

When the email is sent the url with all the parameters is added to the message.

More about Google Analytics can be found here: Google Analytics Integration

 

Multiple personalized parameters

Multiple personalized parameters might be of interest if you want to pass information to the web page, for example you want to add the gender and the first name of the contact. The message app currently supports to select a single personalized parameter, but with this little workaround it is possible to add as many personalized parameters as you like.

We start again as before, but add one personalized parameter using the UI:

Now you must switch to the source code tab of the email and find the technical parameter personalization:

In our case the technical personalization is: |%BO-CUAN_INTERACTION_CONTACT-NAME_FIRST%| . Note that this technical name is also dependent on the segmentation profile you have chosen for personalization in the Settings tab.

If you want to have more personalized parameters, you need to add this parameter to the url that you have in the URL or fallback URL field:

www.yourshop.com/yourproductpage?FirstName=|%BO-CUAN_INTERACTION_CONTACT-NAME_FIRST%|

Then select the next personalized parameter (e.g. gender):

To add even more personalized parameters, you need to go to the Source Code Tab again, find the technical name of the personalization, add it to the url and select a third personalized parameter.

When the email is sent, within the execution these personalization parameters are filled, eg. I would get an email including a link like this:

www.yourshop.com/yourproductpage?FirstName=Michael&gender=male

 

 

 

Assigned Tags

      3 Comments
      You must be Logged on to comment or reply to a post.
      Author's profile photo Joyca Vervinckt
      Joyca Vervinckt

      Hi,

      How can you add multiple personalized parameters in case you work with a Personalized URL and not with the fallback url? Then you cannot type the litteral technical field codes in your url; because you do not type your url...

      Author's profile photo Carsten Brune
      Carsten Brune

      Hello Joyca,

      the UI field "Personalized URL" is supposed to support situations where the URL is provided completely as the
      value of one personalization field.
      Let's assume you're designing a product block and you want to use the link to the product page in your webshop.
      In this case you could have a personalization attribute at your product object that contains/provides the URL
      to the product page in your web shop.

      For your situation you could use the UI field "Fallback URL" in the following way (possible with release 1608 or newer):
      Example:
      |%BO_PRODUCT-ZZ_WEB_SHOP_BASE_URL%|?PROD_ID=|%BO_PRODUCT-ZZ_EXTERNAL_ID%|&LOCALIZATION=|%CUAN_CONTACT-COUNTRY_ID%|
      Where |%BO_PRODUCT-ZZ_WEB_SHOP_BASE_URL%| could contain:
      https://www.shop1.com or https://www.shop2.com depending on the specific product.

      Please respect the URL syntax that requests the first URL parameter to be introduced by a question mark while further URL parameters
      have to be introduced by an ampersand.

      With release 1708 we introduced also a business addin that can be implemented to dynamically attach parameters to URLs.
      See the enhancement option with name 'Adjust Hyperlink Parameters While Sending Emails' as referred
      in our documentation at:
      https://help.sap.com/viewer/b88f770e4b7c4ecead5477e7a6c7b8f7/1708%20500/en-US/e04d27551ae78b43e10000000a423f68.html

      If you have more detailed questions please send me an email to carsten.brune@sap.com.

      Best regards,
      Carsten

       

      Author's profile photo Joyca Vervinckt
      Joyca Vervinckt

      Thanks for your explanation Carsten!

      I'm on onprem 1702 so can't use the new functionality yet; but the workaround with the technical field code in the fallback url is helpful!

       

      Kind regards,

      Joyca