Relevant to: Demand Acceleration Platform | Content Syndication | Event Lead Management | Webinar Integrations | Social Integrations
Discover how to use tokens in the Demand Acceleration Platform to customize your Lead Reports.
A token is a placeholder for a lead or system value. Tokens enable dynamic values to be exported as lead data (rather than a single static value). They are particularly useful to customize the output of Source fields (eg. concatenating multiple fields) and to add system metadata.
Tokens are represented in the Data Acceleration Platform with brackets around the value’s field name. For example, the token for a First Name field is {{lead.FName}}. When the Lead Report is generated, the token is replaced by the actual value that was submitted (eg. John).
Access to some report types may be restricted within a user's permissions. You can read more about permissions in User Management Settings. If you are unsure about your permissions, speak with our Support team or your Customer Success Manager. |
In this article
Tokens available in the Demand Acceleration Platform
There are many different types of tokens available that can be used when creating lead reports in the Demand Acceleration Platform. To view available tokens in the Demand Acceleration Platform, go to Insights and select a lead report. Click on Fields to open the field mapping interface - you will see the list of Available Tokens on the right.
Tokens are categorized to make them easier to find - you can filter by category using the drop-down menu.
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 initially selected Campaign/Source will be shown here.
|
Campaign/Source Fields | Tokens consisting of fields added in the Fields Tab for the Campaign/Source. |
Outbound |
A token that enables you to include the Marketo Lead ID within the Lead Report.
|
Social Metadata |
Social platforms (ie. LinkedIn and Facebook forms) pass system metadata with each lead to the Demand Acceleration Platform. These can be found in a Social Source under the Social Metadata category. For a list of available tokens, read more in Social Metadata Overview. |
Webinar Metadata |
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. For a list of available tokens, read more in Webinar Metadata Overview. |
Available tokens
This table is a directory of the tokens that are available to use in the Demand Acceleration Platform.
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}} |
Outbound | Marketo ID |
{{append.marketo.id}} |
List Mapper tokens
List Mapper tokens are different to other tokens due to 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.
To locate list mappers not associated, use the Search functionality that appears above the initial list of mapper names. |
List mapper tokens are formatted as:
{{lead.yourFieldName|map:"yourMapperIdString"}}
Example: Country List Mapper token
{{lead.Country|map:"1a2345b6-7890-1234-45c6-78901de23f45"}}
|
Using Tokens
Tokens can be used whenever a Custom Field is added to a Lead Report.
Once you find the token you want to add, click the Copy Markup button to copy the token.
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.
In the screenshot below, the Publisher ID value will be exported in the Lead Report column titled Publisher 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.
Recommended Reading
- Creating Reports
- Generating & Scheduling Reports
- Lead Reports
- Customizing Lead Reports - Fields
- Customizing Lead Reports - Liquid Markup
- Report Types in the Demand Acceleration Platform