> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/advertisers/campaigns/macros.md).

# Dynamic Tokens

These are the **Dynamic tokens** that are used to track interesting data through the campaign URL and advertiser's tracking system:

* **{actual\_cost}**: The actual CPM / CPC paid for each impression / click.

{% hint style="info" %}
**Note:** Some third-party tracking solutions round or truncate very small decimal values passed in tracking URLs. When impression-based campaigns send very small cost values (for example 0.00002), certain trackers may round the number or remove leading zeros. This can cause the cost to appear as 0 or significantly lower inside the tracker, even though a valid value was sent. This behavior depends on the tracker's precision and is not a tracking issue.
{% endhint %}

* **{campaign\_id}**: The ID of the campaign.
* **{category\_id}**: The ID of the category detected.
* **{conversions\_tracking}**: The unique ID generated when customer clicks on the ad.
* **{cost}**: The cost of the click or impression.
* **{country}**: The 3-character country code of the visitor.
* **{email\_encoded}**: This token can be used to insert the emails of logged-in users into landing page URLs for all formats. 

{% hint style="info" %}
**Note**: {email\_encoded} is available only on request. Contact your account manager to enable it.
{% endhint %}

* **{format}**: The banner size. Example: 300×250.
* **{keyword}**: The keyword that was matched in case of campaigns targeting specific keywords. This will be empty if there is no match.
* **{language}**: The language of the visitor.
* **{pricing\_model}**: The pricing model of the campaign (1 = CPC, 2 = CPM, 4 = Smart CPM, 5=CPV, 7=Smart CPC).
* **{site\_id}**: The ID number of the site where the ad is displayed.
* **{src\_hostname}**: The site name that the Publisher submitted for displaying ads, not including the HTTP protocol at the beginning (e.g. examplesite.com).
* **{sub}**: The Publisher's Sub ID.
* **{tags}**: The list of keywords that have been identified for that ad impression.
* **{time}**: The timestamp, which is used as a cache buster.
* **{url}**: The full URL of the site that the Publisher submitted to the Admin Panel for displaying ads, including the HTTP protocol (e.g. ). 

{% hint style="info" %}
**Note**: This token will not display the URL where the ad was displayed to the user; only the URL that is registered in our platform.
{% endhint %}

* **{variation\_id}**: The ID of the variation (Banner or landing page).
* **{zone\_id}**: The ID of the ad zone where the ad is displayed.

## Using dynamic tokens in native ads and push notifications

If you are creating a campaign using native ads or push notifications in Step 2, you can add dynamic tokens that **display** **localized** **text** to the visitor based on their information, allowing you to target your ads more effectively.

<figure><img src="/files/vWiPWz49G0zK0Nl4l6rE" alt=""><figcaption></figcaption></figure>

These tokens are available for the **Title** and **Description** fields. To add a token, click the **"+Add Token"** button, then use the radio buttons to select how the token will be capitalized. The available tokens for this feature are the follwing:&#x20;

* **{country\_name}**: The localized country name of the visitor. e.g. España.
* **{region}**: The localized region name of the visitor: e.g. Cataluña.
* **{city}**: The localized city name of the visitor: e.g. Barcelona.
* **{language\_name}**: The localised language of the visitor. e.g. Español
* {**day}:** The localised day that the visitor is visiting the site on: e.g. Lunes, Martes, Miércoles.
* **{operating\_system}:** The operating system of the visitor: e.g. Windows 10.
* **{device}:** The device that the visitor is using: e.g. iPhone.
* **{carrier}:** The carrier that the visitor is using to access the site: e.g. Vodafone.
* **{browser}:** The browser that the visitor is using.

These dynamic tokens will display in the language that you set for the campaign. The language in the **Variations Text Language** drop-down menu next to the **Distribution Algorithm**. The default language is English.

<figure><img src="/files/RgNe9bAgKKGHMnve42f8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** You can only select one language for all the variations in a campaign. For ads in different languages, you should create separate campaigns for each language.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/advertisers/campaigns/macros.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.