Tracking macros for FroggyAds campaigns.
Tracking macros are placeholders FroggyAds replaces with real values at click time. Here is what each value is for, where to place macros, how to encode them, and how to fix placeholders that do not resolve.
What a tracking macro is
A tracking macro is a placeholder you add to your destination URL that FroggyAds replaces with a real value at click time. Instead of hard-coding a source or creative into every link, you add a macro once and FroggyAds fills in the actual value for each click. That is how a single campaign URL can report which source, creative and visit produced each click and conversion.
Where macros are placed
Macros go into the destination URL or tracker click URL you set on the campaign, usually as query parameters. When a user clicks, FroggyAds substitutes each macro with its value, and the visitor arrives at a URL that carries those values for your tracker or landing page to read.
Supported dynamic values
FroggyAds can pass a range of dynamic values through macros. The table describes the value each macro carries and shows a generic placeholder. Always confirm the exact token in your dashboard.
| Dynamic value | Purpose | Generic placeholder |
|---|---|---|
| Click ID | Unique ID for the visit, required for postbacks | {click_id} |
| Campaign identifier | Identifies the campaign | {campaign_id} |
| Source identifier | Identifies the traffic source or zone | {source_id} |
| Creative identifier | Identifies the creative or ad | {creative_id} |
| GEO | Country or region of the visit | {geo} |
| Device | Device type | {device} |
| Operating system | OS of the visit | {os} |
| Browser | Browser of the visit | {browser} |
| Carrier | Mobile carrier where available | {carrier} |
This list is generic. Your campaign setup shows the exact macros FroggyAds supports and their precise names.
The click-ID macro
The click-ID macro is the most important one, because it is what postback tracking uses to match a conversion back to its click. Pass it into your tracker and store it so you can return it on conversion. See Postback Tracking for the full flow.
Campaign, creative and source identifiers
Campaign, creative and source macros let your tracker break performance down by exactly which campaign, ad and traffic source produced each click. Pairing creative and source data is what makes source-level optimization possible: you can see which creative works on which source and cut the rest.
GEO, device and other dynamic values
GEO, device, OS, browser and carrier macros let you segment performance and tune landing pages by context. For example, you can route mobile visitors to a mobile-optimized page or compare conversion rates by country, all from values carried in the URL.
URL encoding
Any value that may contain spaces or special characters should be URL encoded so the link and your tracker parse it correctly. Most trackers handle standard parameters cleanly, but custom values you append yourself should be encoded to avoid broken links and misread parameters.
https://your-tracker.example/click?cid={click_id}&src={source_id}&cr={creative_id}&geo={geo}
Passing macros into trackers and landing pages
To send values to a tracker, map each macro to the tracker's matching parameter in the campaign click URL. To use a value on your own landing page, read it from the query string after the visitor lands. Keep parameter names consistent so reporting stays clean.
Safe example URL structures
A clean structure keeps one parameter per value, uses lowercase parameter names, and encodes dynamic values. Avoid stuffing multiple values into one parameter, which makes parsing fragile.
https://your-landing.example/offer?froggy_click={click_id}&source={source_id}&creative={creative_id}
Troubleshooting unresolved placeholders
If your tracker logs the literal placeholder text instead of a value, the macro did not resolve. The usual causes are a macro name that does not match what FroggyAds expects, a typo in the braces, or copying a placeholder from a generic example rather than the exact token from your dashboard. Replace it with the verified macro and test one click.
Case sensitivity
Some macro systems treat tokens as case sensitive, so a macro typed in the wrong case may not resolve. Match the exact case shown in your FroggyAds dashboard or official guide rather than retyping from memory.
Frequently asked questions
What is a tracking macro?
A tracking macro is a placeholder you add to your destination URL that FroggyAds replaces with a real value, such as the click ID or source ID, at click time. It lets one campaign URL report which source, creative and visit produced each click.
Which macros does FroggyAds support?
FroggyAds can pass values such as click ID, campaign, source, creative, GEO, device, OS, browser and carrier. The exact macro names are shown in your campaign setup and official guides; the placeholders on this page are generic examples.
Why is my macro showing as literal text?
The macro did not resolve, usually because the name or case does not match what FroggyAds expects, or because a generic placeholder was copied instead of the exact token. Replace it with the verified macro from your dashboard and test one click.
Do I need to URL encode macro values?
Yes. Any value that may contain spaces or special characters should be URL encoded so links and trackers parse it correctly. Custom values you append yourself should always be encoded.
Launch a tracked campaign from $50
Create a free account, set up tracking, and optimize to real conversions with SmartCPC and Adscore on every impression.
