The AMPscript Guide - CloudPagesURL

CloudPagesURL

This function provides a convenient method of linking to landing pages (created in CloudPages) from email messages.

When an email is sent that includes a link to a landing page with this function, a URL link is generated to the landing page and is appended with an encrypted query string.

This encrypted query string provides a reference to the email, which means that system personalization strings can be used on a landing page to retrieve values related to the sent email. And as the string is encrypted, no Subscriber information is passed in clear text.

Arguments

CloudPagesURL(1,2,3,[4a,4b]...)

Ordinal	Type	Required	Description
1	Number	True	Page identifier of the CloudPage landing page, available from Page Properties in the CloudPages Collection
2	String	False	Parameter name included in encrypted query string
3	String or number	False	Parameter value included in encrypted query string
4a	String	False	Additional parameter name (see note)
4b	String or number	False	Additional parameter value (see note)

NOTE: Additional parameter name and value pairs can be appended as arguments.

Not a subscriber? Subscribe now.

Example 1

An email is sent that includes the following link to a landing page using the CloudPagesURL function:

<a href="%%=CloudPagesURL(123)=%%">click here to visit your landing page</a>

The following HTML is used on the landing page. The _subscriberKey personalization string is used to retrieve a corresponding value from a Data Extension.

%%[

var @firstName
set @firstName = Lookup("Members", "First Name", "Subscriber Key", _subscriberKey)

]%%

<!DOCTYPE html>
<html>
   <body>
      <h2>Hello %%=v(@firstName)=%%,</h2>
      <p>Welcome to your personalized landing page.</p>
   </body>
</html>

Output

The CloudPagesURL function returns the page URL of the landing page appended with an encrypted query string with Subscriber data. For example: https://pub.exacttarget.com/adytgmabc?qs=bfd0bc86b7b0dc08be758fc47e321b5e

The page is personalized with a Data Extension field value, which is based on the Subscriber Key of the email sent to the Subscriber.

<!DOCTYPE html>
<html>
   <body>
      <h2>Hello Andrew,</h2>
      <p>Welcome to your personalized landing page.</p>
   </body>
</html>

Example 2

Not a subscriber? Subscribe now.