Friendly Names in Hyperlinks

From Enterprise Help
This is the approved revision of this page, as well as being the most recent.
Jump to: navigation, search

"Friendly Names" are optional descriptive labels for hyperlinks in mailings. They are for your administrative and organizational purposes and are not visible in any way to your recipients. Friendly names are supported for hyperlinks that begin with "http://" and "https://" but not for those that begin with "mailto:". Friendly names serve two purposes:

  1. They allow you to supply meaningful labels to cryptic URLs in the context of reports such as the Mailing Summary Report. For example, the URL "", which is probably meaningless to viewers of the Mailing Summary Report, could be given the friendly name "2009 Music Event".
  2. They allow you to group different URLs together for segmentation purposes (see "Clicked on a Named Hyperlink in any Mailing" and "Did not click on a Named Hyperlink in any Mailing" in "Building a Filter based on Response Data"). For instance, the URL listed above may change -- for technical reasons -- from one mailing to the next even though the page it represents does not. By assigning the friendly name "2009 Music Event" to any URLs representing 2009 music events, you allow yourself to create a Segment to target Members who have clicked on a 2009 Music Event hyperlink in any mailing, regardless of the actual URL.

When building a mailing using a template, friendly name support is integrated into the user interface. The Image Editor screen contains a box for entering URL and friendly name, though both are optional. The Text Editor screen contains a separate dialog box for inserting a hyperlink and corresponding friendly name.

When creating a mailing without using a template, however, specifying a friendly name is more involved. There are two options in this case:

  1. Add friendly names to your hyperlinks after the mailing is sent, as described in the section Managing Hyperlinks.
  2. Add friendly names as parameters to the "query" portion of each URL. This query parameter must follow standard URL encoding rules and can be included along with any existing query parameters (Enterprise automatically strips FriendlyName parameters out of URLs before sending messages). For example, this original URL...

... would be modified as follows to include the friendly name "2009 Music Event":

URLs containing no "query" portion but ending in a filename would be modified as follow:

URLs containing neither "query" portion nor filename must be modified as follows, making sure to add a forward-slash character before the question mark: