Перейти к основному содержимому

Список поддерживаемых макросов и параметров

В этом разделе перечислены макросы и параметры, поддерживаемые нашей системой.

Макросы​

Макросы заменяются системой на конкретные значения на стороне нашего бэкенда во время генерации ссылки. Их не нужно заполнять вручную.

Уникальный идентификатор события exid​

Подставляет UUID конкретного события. Используется для отслеживания, аналитики, постбеков.

Пример:

https://example.com?sub1={exid}

Он является обязательным и должен располагаться первым в списке параметров.

Bundle ID мобильного приложения​

Подставляет bundle идентификатор мобильного приложения или хэш PWA.

https://example.com?sub1={exid}&sub2={bundle}

Макрос fbclid​

Макрос fbclid используется для автоматической подстановки идентификатора клика Facebook.

https://example.com?sub1={exid}&sub2={fbclid}

Макрос User Agent ua_raw​

Макрос ua_raw используется для подстановки оригинального user agent пользователя, т.е. информации о его устройстве, браузере и операционной системе.

https://example.com?sub1={exid}&sub5={ua_raw}

Макросы раздела Сплиты​

Идентификатор сработавшего правила rule_id​

Подставляет значение ID правила, которое сработало при событии.

Пример:

https://example.com?sub1={exid}&sub2={rule_id}

Наименование сработавшего правила rule_name​

Подставляет название правила, которое сработало.

Пример:

https://example.com?sub1={exid}&sub3={rule_name}

Параметры​

Параметры задаются вручную и применяются уже в итоговой ссылке для залива.

Идентификатор пикселя pixel_fb​

При создании потока указанный пиксель автоматически записывается в параметры итоговой ссылки. Но вы можете вручную указать на какой пиксель Facebook или Tiktok отправлять события.

важно

Перед использованием pixel_fb в ссылке, убедитесь, что нужный пиксель сохранен в разделе Пиксели в вашем кабинете ZM apps.

Пример:

https://example.com?sub2={sub2}&pixel_fb=384927561034275

Ключ приложения app​

Определяет, какое приложение должно быть показано. Используется для подстановки bundle нужного приложения или hash ID выбранного PWA.

Пример:

https://example.com?sub2={sub2}&app=id6746545668
важно

Если приложение указано с "хвостом" в bundle ID, например: id6747820731?ppid=9c8c173, то необходимо указывать полное значение в app.

Например: https://example.com?sub2={sub2}&app=id6747820731?ppid=9c8c173.

Если указать только id6747820731, то приложение не будет распознано.

к сведению

При использовании сплита приложений в потоке (когда трафик распределяется на разные приложения) параметр app перезаписывает логику сплита.

В результате все пользователи будут направлены на приложение, указанное в параметре app, независимо от настроек сплита.