Токены источника и параметры ссылки
Как токены источника превращают параметры рекламной ссылки в макросы и sub_id и как перенести их в ссылки кампаний.
Токен источника связывает параметр рекламной ссылки со слотом трекера: значение параметра записывается в клик под именем слота и доступно как макрос и в отчётах. Таблица Токены источника находится в карточке источника в разделе Источники. Менять её могут владелец и администратор; остальные роли с доступом к разделу видят токены без правки.
Колонки таблицы
Одна строка таблицы — один параметр ссылки.
| Колонка | Что указать | Пример |
|---|---|---|
| Слот | Имя, под которым трекер хранит значение: системный слот или sub_id_1 … sub_id_30 | sub_id_2 |
| Название | Алиас — своё имя значения. Макрос по нему работает наравне с макросом слота | camp_id |
| Параметр | Имя параметра в ссылке для трафика. Регистр учитывается | camp_id |
| Placeholder | Значение параметра в ссылке: макрос рекламной площадки, который она заменит своими данными | {{campaign.id}} |
После переноса в кампанию строка из примера даёт в ссылке для трафика camp_id={{campaign.id}}. Когда придёт клик, значение параметра camp_id запишется в sub_id_2 и будет доступно как {sub_id_2} и {camp_id}.
В ссылках и на страницах макрос по названию работает, если название начинается с латинской буквы и состоит из латинских букв, цифр и знака _. В отчёте с условием по одной кампании название подписывает группировку sub_id — см. Конструктор отчётов.
- + Токен добавляет строку и ставит в неё первый свободный слот
sub_id. Когда все тридцать заняты, выберите слот в списке сами: строка без слота не сохраняется. - ✕ удаляет строку.
- Сохранить записывает карточку источника вместе с токенами.
Что происходит при сохранении:
- строки с пустым полем Параметр не сохраняются;
- пустой Placeholder заполняется макросом по названию, а если названия нет — по слоту:
{camp_id}или{sub_id_2}; - у параметров
fbclid,gclid,ttclidиmsclkidпустой Placeholder остаётся пустым.
Таблица на экране после сохранения остаётся прежней: результат виден после обновления страницы.
Новые токены начинают действовать на клики всех кампаний источника в течение примерно 15 секунд после сохранения. Параметры в ссылках кампаний при этом не меняются — см. перенос в кампанию.
Если токенов нет, в таблице показано «Токенов нет». Источник из каталога шаблонов создаётся с токенами шаблона; у части шаблонов токенов нет.
Слоты
Системные слоты
| Слот | Что в нём хранить | Где используется |
|---|---|---|
external_id | ID клика на стороне источника | Макрос {external_id}, в том числе в постбэке в источник; поиск кликов; группировка и фильтр отчёта External ID |
cost | Стоимость клика | Расход клика — см. Стоимость из параметра cost |
currency | Валюта, которую передаёт источник | Хранится в клике. На расход не влияет; макрос {currency} всегда даёт USD |
keyword | Ключевое слово | Макрос {keyword}; группировка и фильтр отчёта Ключевик |
creative_id | ID объявления или креатива | Макрос {creative_id}; группировка и фильтр отчёта Creative ID |
ad_campaign_id | ID или название рекламной кампании | Макрос {ad_campaign_id}; фильтр отчёта Ad Campaign ID |
sub_id_1 … sub_id_30
Тридцать слотов для любых значений: площадка, группа объявлений, сайт, ID пикселя. Значения доступны как {sub_id_1} … {sub_id_30} и в группировках отчёта sub 1 … sub 30.
В условиях потока из списка выбирается sub_id_1. Условия по остальным sub_id и по слотам keyword, creative_id, ad_campaign_id задаются через API или импорт потока — см. Дополнительные поля.
Слоты с другими именами
В шаблонах каталога встречаются слоты с другими именами, например source. Такой слот показан в списке Слот своей строки и работает как макрос {source}. Если выбрать в этой строке другой слот, прежнее имя из списка исчезнет.
Группировки отчёта Adset (назв.) и Ad (назв.) берут значения по именам adgroup_name и advert_name: так должны называться параметр ссылки или название токена. В шаблоне Facebook Ads это токены со слотами sub_id_5 и sub_id_6.
Полный список макросов — на странице Макросы в ссылках и страницах.
Порядок обработки клика
- Трекер читает параметры из ссылки, по которой пришёл посетитель.
- Если параметр не пришёл или пришёл пустым, а в кампании для него задано готовое значение, трекер берёт значение из кампании — см. Значения по умолчанию.
- Трекер проходит по токенам источника, выбранного в кампании. Значение параметра каждого токена записывается в слот и под названием.
Значение из ссылки важнее значения по умолчанию из кампании. Токен срабатывает, когда у его параметра есть непустое значение — из ссылки или из кампании.
Пример: токен со слотом sub_id_2, названием camp_id и параметром camp_id. Значения по умолчанию в кампании нет.
| Запрос | {sub_id_2} | {camp_id} |
|---|---|---|
https://track.example.com/abc1234?camp_id=777 | 777 | 777 |
https://track.example.com/abc1234?camp_id= | пусто | пусто |
https://track.example.com/abc1234 | пусто | остаётся текстом {camp_id} |
Параметры без токена
Параметр, для которого токена нет, тоже сохраняется в клике. Он доступен как макрос по своему имени: ?placement=feed даёт {placement}. Параметры с именами sub_id_1 … sub_id_30 попадают в свои слоты напрямую. Встроенный макрос важнее одноимённого параметра или названия токена — см. Синтаксис.
Стоимость из параметра cost
Если у источника есть токен со слотом cost, значение его параметра записывается как расход клика вместо расчёта по модели расхода кампании.
- Принимается число от
0до1000. Дробная часть — через точку:0.035. - Значение считается суммой в USD. Слот
currencyна него не влияет. - Если параметр не пришёл, пришёл не числом или вне диапазона, расход клика считается по модели кампании.
Пример: токен со слотом cost и параметром cost, в ссылке cost=0.035 — расход клика равен 0,035 USD.
Как стоимость из параметра сочетается с моделями и с поправкой на недошедший трафик — на странице Модели расхода кампании.
Click-id площадок и секретные параметры
Параметры fbclid, gclid, ttclid и msclkid рекламная площадка дописывает к ссылке сама. Токен для такого параметра записывает пришедшее значение в слот; в шаблонах Facebook Ads, Google Ads и TikTok Ads это слот external_id. В ссылку для трафика параметр не выводится, если его значение в кампании пустое или записано макросом вида {fbclid}.
Параметры с именами token, access_token и capi_token в ссылку для трафика тоже не выводятся: трекер берёт их значения из кампании. Точные условия для обоих случаев — на странице Ссылка кампании, домен и параметры.
Перенос токенов в кампанию
Параметры ссылки задаются в кампании: Кампании → кампания → вкладка Источник и параметры.
- Выберите источник в списке справа от заголовка Источник и параметры ссылки. Если таблица параметров пуста, трекер заполнит её токенами источника.
- Если параметры в кампании уже есть, нажмите ↓ из источника.
- Проверьте колонку Значение: впишите свои значения там, где нужны не макросы площадки.
- Нажмите Сохранить параметры.
Как токен становится строкой параметров кампании:
| Колонка кампании | Откуда берётся |
|---|---|
| Название | Название токена, а если оно пустое — Слот |
| Параметр | Параметр токена |
| Значение | Placeholder токена. Уже введённое значение не заменяется |
Что кнопка ↓ из источника делает с уже заполненной таблицей — на странице Ссылка кампании, домен и параметры.
После правки токенов параметры существующих кампаний остаются прежними. Обновить их сразу во всех кампаниях источника можно кнопкой Параметры кампаний… в карточке источника — см. Применение источника к кампаниям.
Проверка
- Откройте ссылку кампании с параметрами в браузере.
- Вернитесь в кампанию и нажмите Статистика.
- Откройте вкладку Лог кликов.
- Нажмите строку своего клика.
В окне клика блок Параметры (sub_id) показывает значения слотов sub_id, блок Токены — остальные слоты, названия и параметры ссылки.
Лимиты и ошибки
| Что | Предел |
|---|---|
| Токенов в одном источнике | 128 |
| Слот | до 64 байт |
| Название | до 160 байт |
| Параметр | до 128 байт |
| Placeholder | до 1024 байт |
Латинская буква и цифра занимают 1 байт, кириллическая буква — 2. Сообщения об ошибках сохранения появляются вверху страницы Источники.
Некорректный список токенов (не более 128)
В источнике больше 128 токенов. Удалите лишние строки и нажмите Сохранить.
У токена должны быть имя и параметр допустимой длины
Одно из полей строки длиннее предела из таблицы или в поле Параметр только пробелы. Сократите значение или впишите имя параметра.
Параметры URL в токенах не должны повторяться
Одно и то же имя стоит в колонке Параметр у двух строк. Имена, которые отличаются только регистром, считаются разными. Оставьте по одной строке на параметр.