Macros are tags that you can set in to the text fields of your campaigns, ad sets and ads. They will be replaced with an actual value when you publish. These can be useful to have a standard way of naming you assets, or for using standard URL parameters in all your ads.
For example, you can name your ad set the following:
{{campaign.name}} - Norway
In this case it will take the campaign's name and place it into the ad set's name. If campaign is named "Acquisition", then the ad set's name will become "Acquisition - Norway".
Or, you can have a standard set of url parameters to identify which campaign, ad set and ad lead to a conversion:
https://www.example.com/?utm_campaign={{snapchat.campaign.id}}&utm_adset={{snapchat.adSet.id}}&utm_ad={{snapchat.ad.id}}
You can use the same parameters for every ad, and it will automatically plug in the ids of campaign, ad set and ad.
Use macros for naming
To use a macro in the name of a campaign, ad set, or ad:
- Place your cursor in the field where you want to add the macro.
- Either click
or type {{ in the field, and select a macro on the list.
For example, to include the campaign objective in a campaign's name, add {{campaign.objective}} in the name. When you publish the campaign, Smartly.io automatically replaces the macro part of the name with the objective you selected in the campaign.
Smartly.io macros and Snapchat macros
Both Smartly.io and Snapchat have their own set of macros. Smartly.io's macros can be used in most text fields, while Snapchat's macros are reserved from URL fields
If you use a Smartly.io macro, then the value of the macro will be evaluated on Smartly.io's side before sending it to Snapchat. From Snapchat's point-of-view, a macro was not used.
If you use a Snapchat macro, then the macros will be sent to Snapchat as-is and Snapchat will evaluate the actual value.
There's a significant overlap on the two sets. For example, both provides {{campaign.name}} as a macro. Because of this, if you wish to use any of Snapchat macros, you should prepend it with "snapchat.", so for example {{snapchat.campaign.name}}. This will tell the Smartly.io system to not to evaluate the macro and send it forward to Snapchat.
Available Smartly.io macros
You can use the following macro values exclusively in Smartly.io when you're setting up a new campaign, ad set, or ad, or when you're editing existing campaigns.
The availability of these macros depends on which entity you're working with. You can always use a macro that refers to itself or to a parent object. That means:
- In a campaign, you can use campaign macros
- In an ad set, you can use campaign or ad set macros
- In an ad, you can use campaign, ad set, or ad macros
Macro | Description |
---|---|
{{campaign.name}} |
The campaign's name. |
{{campaign.objective}} |
The campaign's objective with capitalization and underscores instead of space characters. For example: WEB_CONVERSION |
{{adSet.name}} |
The ad set's name. |
{{adSet.optimizationGoal}} | The ad set's optimization goal with capitalization and underscores instead of space characters. For example: VIDEO_VIEWS |
{{ad.callToAction}} | The ad's Call To Action (CTA) with capitalization and underscores instead of space characters. For example: SHOP_NOW |
{{ad.creativeName}} | The name of the creative that the ad uses |
{{ad.mediaName}} | The media's name |
{{ad.name}} | The ad's name |
Available Snapchat macros
Snapchat has it's own macros as well, which can be used in URL fields. These macros are not resolved on Smartly.io's side, but sent to Snapchat as is, for them to decide the values for. Note that both Smartly.io and Snapchat support many of the same macros, like {{campaign.name}}. To be able to signal that you mean the Snapchat macro , you should prepend them with snapchat., for example {{snapchat.campaign.name}}.
Macro when used in Smartly.io | Macro when used in Snapchat Ads Manager | Description |
---|---|---|
{{snapchat.campaign.name}} |
{{campaign.name}} |
Campaign name* |
{{snapchat.campaign.id}} |
{{campaign.id}} |
Campaign ID* |
{{snapchat.adSet.name}} |
{{adSet.name}} |
Ad set name* |
{{snapchat.adSet.id}} |
{{adSet.id}} |
Ad set ID* |
{{snapchat.ad.id}} |
{{ad.id}} |
Ad ID* |
{{snapchat.creative.name}} |
{{creative.name}} |
Creative name |
{{snapchat.creative.headline}} |
{{creative.headline}} |
Creative headline |
{{snapchat.site_source_name}} |
{{site_source_name}} |
Site source name |
*Available for use with Dynamic Ads campaigns.
You can find more details in Snapchat's article Add URL Macros to Your Ads.