Post Out Available Tokens

Relevant to: Demand Acceleration Platform

Discover how to use tokens in the Demand Acceleration Platform to format lead data and system generated metadata.

A token is a placeholder value that enables dynamic values to be added to leads (rather than a single static value).

Tokens are represented in the Demand Acceleration Platform with brackets around the value field name. For example, the token for a First Name field would be {{lead.FName}}. When the lead is generated, the token is replaced by the actual value that was submitted (eg. John).

Tokens available in the Demand Acceleration Platform

There are many different types of tokens available to be used in the Demand Acceleration Platform. Some tokens are available for all Campaign/Source types (CPL, Event, Webinar, Social), while others are only available for specific channels.

To view available tokens in the Demand Acceleration Platform, select a Campaign/Source and click on Integrations. Select the integration Settings by hovering over the tile and clicking Settings.

On the right hand side, you will see the Available Tokens panel.

Tokens are categorized to make them easier to find - you can filter by category using the drop-down menu (next to the Friendly Names toggle).

Tokens are categorized according to:

Token Category	Description
Campaign Details	Tokens consisting of system-generated information about the Demand Acceleration Platform Campaign. Commonly used tokens include: Campaign ID, Campaign name, Marketer ID, Marketer name.
Source Details	Tokens consisting of system-generated information about the Demand Acceleration Platform Source. Commonly used tokens include: Source ID, Source name, Source alias, Source tag.
List Mappers	Tokens consisting of the available list mappers based on the associated fields in the Campaign/Source. Only list mappers associated with the field lists in this specific Campaign/Source will be shown here.
Campaign/Source Fields	Tokens consisting of fields added in the Fields Tab for the Campaign/Source.

Available tokens

Category	Token (friendly name)	Token Code (Liquid Markup)
Campaign Details	Campaign ID	{{campaign.Id}}
	Campaign Name	{{campaign.Name}}
	Campaign Type	{{campaign.Type}}
	Campaign Short ID	{{campaign.ShortId}}
	Campaign Currency Code	{{campaign.CurrencyCode}}
Source Details	Source ID	{{source.Id}}
	Source Name	{{source.Name}}
	Source Type	{{source.Type}}
	Source Short ID	{{source.ShortId}}
	Source Alias	{{source.Alias}}
	Source Tag	{{source.Tag}}
	Source Currency Code	{{source.CurrencyCode}}
Campaign/ Source Details	Lead ID	{{lead.Id}}
	Created Timestamp	{{lead.Created}}
	Last Updated Timestamp	{{lead.Updated}}
	First Accepted Timestamp	{{lead.FirstAccepted}}
	Marketer ID	{{advertiser.Id}}
	Marketer Name	{{advertiser.Name}}
	Marketer Short ID	{{advertiser.ShortId}}
	Marketer Short Name	{{advertiser.ShortName}}
	Publisher ID	{{publisher.Id}}
	Publisher Short ID	{{publisher.ShortId}}
	Publisher Short Name	{{publisher.ShortName}}
Campaign/ Source Fields	Form fields	{{lead.yourFieldName}}

List Mapper tokens

List Mapper tokens are different because of how they work; they take a value and search a list in order to map it to another value.

In the Available Tokens section, the List is displayed in bold with the associated Mapper underneath.

List mapper tokens are formatted as:

{{lead.yourFieldName|map:"yourMapperIdString"}}

Example: Country List Mapper token

Supplement yourFieldName with field name token lead.Country.
Supplement "yourMapperIdString" with the List Mapper ID "1a2345b6-7890-1234-56c7-89012de34f56".
The final token is therefore:

{{lead.Country|map:"1a2345b6-7890-1234-56c7-89012de34f56"}}

When applied to a field, the Country List Mapper would take the input country value (eg. US) and search a list called Country List for a value match.
The Country List is associated with a mapping file called ISO2 to Full Country.
This would result in the value US being replaced with United States.

Tokens specific to Social Integrations

Social sources (ie. LinkedIn and Facebook forms) have their own extra category of tokens called Social Metadata tokens. These consist of information collected from the social platform that is automatically passed to the Demand Acceleration Platform alongside any lead data.

Tokens specific to Webinar Integrations

Webinar platforms (ie. ON24 and BrightTALK) pass system metadata with each lead to the Demand Acceleration Platform. These can be found in a Webinar Source under the Webinar Metadata category.

Using Tokens

Tokens can be used whenever a Custom Field is added to an integration mapping (in Integration Settings on a Campaign/Source).

1. Once you find the token you want to add, click the Copy Markup button to copy the token.

2. With your token copied, add a Custom Field to your mapping and select the appropriate output field. Then paste the token into the Custom column.

3. In the screenshot below, the Integrate Lead ID value will be sent to the integrated system field Integrate Lead ID.

Using multiple tokens

You can use more than one token in the Custom column.

For example, if you wanted to concatenate First Name and Last Name fields into a single Full Name field. Copy and paste both tokens into the Custom column.

In this instance, be sure to include a space between them as the system will output exactly what is added here.

Mapping Column	Field	Output	Custom
Value	Custom Field	Name	{{lead.first_name}} {{lead.last_name}}

Tokens in use

Using two tokens to concatenate street fields into one address field.

Mapping Column	Field	Output	Custom
Value	Custom Field	address	{{lead.street_1}} {{lead.street_2}}

Using static values and two tokens to pass data into a comments field.

Mapping Column	Field	Output	Custom
Value	Custom Field	Comments	Where are you in the buying cycle? {{lead.buying_cycle}} Opt-in to marketing? {{lead.opt_in)

In this article