<!-- https://docs.youtarget.com/advertiser/reference/macros.html -->

# Макросы

> Какие значения подставляются в ссылку кампании и креатива при клике, в каком формате и когда макрос остаётся пустым.

Макрос — слово в фигурных скобках в ссылке, например `{click_id}`. Когда пользователь кликает по объявлению, кабинет заменяет макрос значением и только потом открывает вашу страницу. Так в трекер или аналитику попадают ID клика, кампании, источника и данные об устройстве.

## Где использовать

Макросы работают в двух полях:

- **Конечный URL** в настройках кампании;
- **Страница перехода** в креативе. Если в креативе отмечено **Совпадает с URL в настройках рекламной кампании**, используется ссылка кампании.

Под каждым из этих полей есть список **Доступные макросы**. Клик по макросу вставляет его в поле.

## Список макросов

| Макрос | Что подставляется | Пример значения | Когда пусто |
| --- | --- | --- | --- |
| `{click_id}` | ID клика: уникальная строка из 36 символов. Её же трекер возвращает в [постбэке](https://docs.youtarget.com/advertiser/glossary/postback.md) | `3f1c9a2e-5b7d-4c1a-9e2f-0a1b2c3d4e5f` | Всегда заполнен |
| `{campaign}` | ID кампании | `1038` | Всегда заполнен |
| `{creative}` | ID креатива | `7712` | Всегда заполнен |
| `{zone_id}` | Где был показ: ID источника трафика и ID места размещения у него, через двоеточие. Значение кодируется для ссылки, поэтому двоеточие передаётся как `%3A` | `1201%3Aa7f3c9` | ID места размещения может быть пустым: `1201%3A` |
| `{cpc}` | Стоимость клика в валюте аккаунта, четыре знака после точки. Для Pop с оплатой за показы — цена одного показа | `0.0500` | При оплате за показы (CPM) у всех форматов, кроме Pop |
| `{language}` | Язык пользователя: две строчные латинские буквы | `de` | Язык не определился |
| `{device}` | Тип устройства: `mobile`, `tablet`, `pc`, `ctv` (Smart TV) или `bot` | `mobile` | Тип не определился |
| `{browser}` | Браузер: `Chrome`, `ChromeMobile`, `Safari`, `Firefox`, `Edge`, `Opera`, `YandexBrowser`, `SamsungInternet` и другие | `ChromeMobile` | Браузер не определился |
| `{platform}` | Операционная система: `android`, `ios`, `windows`, `macos`, `linux` или `symbian` | `android` | ОС не определилась |
| `{random}` | Случайная строка из 8 символов: латинские буквы, цифры, `_` и `-`. Новая при каждом клике. Помогает обойти кеш трекера. В списке **Доступные макросы** подписан «Генерация случайного числа», но подставляется именно строка | `aZ3_kP9x` | Всегда заполнен |
| `{sub_age}` | Только для Push: сколько дней назад пользователь подписался на уведомления | `12` | `0`, если источник не передал возраст подписки или формат не Push |

Макрос `{sub_age}` появляется в списке **Доступные макросы** только у Push-кампаний и Push-креативов.

## Пример

Ссылка в поле **Конечный URL**:

```text
https://example.com/sale?click_id={click_id}&campaign={campaign}&source={zone_id}&os={platform}
```

Так её увидит сайт после клика:

```text
https://example.com/sale?click_id=3f1c9a2e-5b7d-4c1a-9e2f-0a1b2c3d4e5f&campaign=1038&source=1201%3Aa7f3c9&os=android
```

## Правила

- **Пишите макрос точно как в списке.** Регистр важен: `{Click_ID}` не заменится. Неизвестный макрос, например с опечаткой, останется в ссылке как есть.
- **Ставьте макросы в значения параметров** после `?` и `&`, как в примере. Значения, кроме `{zone_id}` и `{language}`, подставляются без кодирования.
- **Для учёта конверсий нужен `{click_id}`.** Трекер должен сохранить его и вернуть в постбэке без изменений. Конверсия засчитывается, если она пришла не позже чем через 60 дней после клика. Подробнее — в инструкции [«Настроить postback и учёт конверсий»](../cases/postback.md).
- **В ссылке постбэка макросы кабинета не нужны.** Её заполняет трекер своими макросами.
