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).
In this article
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
{{lead.Country|map:"1a2345b6-7890-1234-56c7-89012de34f56"}}
|
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.
Read more in Social Metadata Overview.
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.
Read more in Webinar Metadata Overview.
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}} |
Recommended Reading