51ºÚÁϲ»´òìÈ

DocumentationJourney Optimizer B2BJourney Optimizer B2B Edition Documentation

Custom tokens for email personalization

Last update: Mon Apr 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Content personalization uses tokens as placeholders or variables that are populated when the content artifact is generated. Standard personalization tokens are available for emails, landing pages, fragments, and templates. You can also define a set of custom tokens with values that are specific to the account journey. This set of custom tokens is called My Tokens and any of these custom tokens are for personalization when authoring journey emails.

In addition to My Tokens, which are specific to the account journey, you can use any of the standard (built-in) tokens for email personalization.

Manage My Tokens my-tokens

The My Tokens are custom variables that you create or modify for an account journey in Draft status. This custom token set currently support text and number token definitions.

When you add a custom token to an email, it is displayed as {{my.TokenName}}. For example, you might have {{my.EventDate}} or {{my.WebinarSpeaker}} tokens created to manage email content related to upcoming webinars.

To access the custom tokens for an account journey:

  1. Open the draft account journey.

  2. Click the ²Ñ´Ç°ù±ð… menu at the top right and choose My Tokens.

    Click More at the top right {width="450"}

    The My Tokens page lists all custom tokens that are defined for the journey.

    My tokens {width="700" modal="regular"}

Create a token

  1. In the My Tokens page, click Create and choose the token type that you want to define:

    • Text - Use this type to define a token with a basic text string value.

    • Number - Use this type to define a token with a numeric value.

  2. In the dialog, enter the Name and Value for the token.

    Enter a name and value for the text token {width="400"}

    You cannot use spaces or special characters in the token name. You can use camel case, such as EventType, to use a multi-word name that is easily identified.

    If you are defining a Number token, the value can contain only numeric characters. You can use a decimal value.

    Enter a name and value for the number token {width="400"}

  3. Click Add.

Edit a token

While the account journey remains in draft status, you can edit any of the defined My Tokens.

  1. In the My Tokens page, click the More actions icon (…) next to the token name and choose Edit.

    Token More actions menu {width="430"}

  2. In the dialog, change the Name and Value as needed for the journey.

    Change the name and value for the token {width="400"}

  3. Click Edit.

Delete a token

You can delete a custom token from the My Tokens list, but you should make sure that it is not currently used in your journey email content.

  1. In the My Tokens page, click the More actions icon (…) next to the token name and choose Delete.

  2. In the confirmation dialog, click Delete.

Use custom tokens in your content

When you are authoring email content for your account journey, you can use any of the tokens from the My Tokens list when you use the personalization tools in the visual design space.

  1. Select the text component and click the Add personalization ( Add personalization icon ) icon in the toolbar.

    Click the Add personalization icon {width="600"}

    This action opens the Edit Personalization dialog. The dialog includes a My tokens folder in the Personalization Tokens library if there are custom tokens defined for the account journey.

  2. Expand the My tokens folder, then click + or … to add one of your custom tokens to the blank space.

    You can add any additional static text as needed.

    Construct personalized text using My tokens {width="700" modal="regular"}

  3. Click Save.

recommendation-more-help
6ef00091-a233-4243-8773-0da8461f7ef0