Метки

Owned by Татьяна Чадий
Last updated: 2020 Aug 03 by Anton Yankovskyi
3 min read

При рендеринге кода инициализации Маркетинговой системы или Обработчика событий (для статических событий) есть возможность указать метку вида {paramName;paramType} которая будет автоматически заменена на значение paramName и приведена к типу paramType

Доступные типы данных (paramType)

Тип данныхОписание
stringОбычная строка. Если указывать метку без указания типа, либо если указанный тип данных отсутствует в данной таблице то будет использовать этот тип данных
intЦелое число. Любое значение будет приведено в целое число. Если значение переменной не соответствует число то будет отображаться цифра 0
integerТоже самое что и int
longТоже самое что и int
floatЧисло с плавающей точкой/дробное число (1.25). Любое значение будет приведено к дробному числу. Если значение переменной не соответствует число то будет отображаться цифра 0
booleanЛогический тип данных. Доступны значения: 1, 0, true, false
jsonДанные переданные по указанной метке будут приведены к типу JSON (wikipedia)
rawДанные будут отображены в том виде, в котором были добавлены без каких либо преобразований
jsТоже самое что и raw

В качестве paramName можно указывать строковое значение с разделителями в виде нижнего подчеркивания "_" или без него. Также можно указывать цифры в названии, но только НЕ в начале.

Также параметры могут быть многоуровневыми, в таком случае каждый последующий уровень разделяется символом точки "." (например {product.article;string})

Доступные метки в шаблоне данных "Маркетинговые системы"

МеткаОписание
{SYSTEM_ID}Идентификатор отслеживания
{EVENT_CODE;raw}Расположение кода инициализации статических событий внутри кода инициализации Маркетинговой системы.

Примечание. Метка {SYSTEM_ID} также всегда доступна в шаблоне данных "Маркетинговые системы: обработчики событий"

Доступные метки в шаблоне данных "Маркетинговые системы: обработчики событий"

СобытиеПосещение страницы товара
Метки

{article;string} - уникальный артикул товара

{article_for_display;string} - артикул товара, отображаемый на сайте

{title;string} - полное название товара

{category;string} - строковое представление категории в виде хлебных крошек (например "Телефоны/Iphone")

{brand_title;string} - название бренда

{price;int} - стоимость товара

{in_stock;boolean} - наличие товара

ОписаниеСодержит все скалярные (простые) поля из шаблона Каталог (доступ по полю name)
Пример
<script type="text/javascript">
var products = {products;json};// Тут мы указали что все товары необходимо преобразовать в JSON формат
for (var i = 0, l = products.length; i < l; ++i) { // Тут идет проход по товарам и их регистрация в Google
    var product = products[i];
    ga('ec:addImpression', {
        'id': product.article,
        'name': product.title,
        'category': product.category_string,
        'brand': product.brand_title,
        'list': 'Catalog Page',
        'position': i + 1
    });
}
ga.send('pageview');
</script>
Событие

Посещение страница каталога

Посещение страница поиска

Метка{products;json}
ОписаниеСодержит массив товаров, которые необходимо передать обработчику по надобности. Например для Google Расширенная электронная коммерция
Пример
<script type="text/javascript">
var products = {products;json};// Тут мы указали что все товары необходимо преобразовать в JSON формат
for (var i = 0, l = products.length; i < l; ++i) { // Тут идет проход по товарам и их регистрация в Google
    var product = products[i];
    ga('ec:addImpression', {
        'id': product.article,// article, title и названия других полей смотреть в предыдущем разделе (указывать без фигурных скобок тут)
        'name': product.title,
        'category': product.category_string,
        'brand': product.brand_title,
        'list': 'Catalog Page',
        'position': i + 1
    });
}
ga.send('pageview');
</script>



СобытиеНачало оформления заказа
Метка

{cart.products;json} - товары в корзине, необходимо преобразовать в массив, а потом в цикле привести в формат Маркетинговой системы

{currency_iso} - ISO код валюты заказа

{cart.total.discount.discount_percent} - относительная скидка действующая на заказ

{cart.total.discount.discount_value} - фактическия скидка действующая на заказ (в валюте заказа)

{cart.total.coupon_data.sum} - сумма скидки по купону

{cart.total.coupon_data.percent} - относительная величина скидки по купону

{cart.total.coupon_data.type} - тип купона (0 - без купона, 1 - подарочный сертификат, 2 - купон на скидку)

{cart.total.coupon_data.code} - код купона

{cart.total.total.default} - сумма заказа без учета наценок и скидок (в т. ч. доставки)

{cart.total.total.sum} - итоговая стоимость заказа без учета доставки

{cart.total.total.quantity} - общее количество заказанных товаров

ОписаниеСодержит все локальные данные о текущем заказе
Пример
<script type="text/javascript">
var cartProductsData = {cart.products;json},
    cartProducts = [];

for (var i = 0, l = cartProductsData.length; i < l; ++i) {
    cartProducts.push(cartProductsData[i].article);
}

var google_tag_params = {
dynx_itemid: cartProducts,
dynx_pagetype: 'conversionintent',
dynx_totalvalue: {cart.total.total.sum;float},
};
</script>
СобытиеУспешное оформление заказа
Метка

{order_id} - номер заказа

{cart} - объект корзине (см. выше)

{name} - имя пользователя

{email} - email пользователя

{phone} - телефон пользователя

ОписаниеСодержит все локальные данные о текущем заказе
Пример
var items = [],
products = cart.products,
ids = [];

for (var i = 0, l = products.length; i < l; ++i) {
  var product = products[i];

  items.push({
    "id": product.article,
    "name": product.title + " (артикул: " + product.article_for_display + ")",
    "quantity": product.quantity * 1,
    "price": product.price * 1
  });

  ids.push(product.article);
}

gtag('event', 'purchase', {
  "transaction_id": order_id,
  "affiliation": GLOBAL.SITE_NAME,
  "value": cart.total.total.sum,
  "currency": GLOBAL.currency.iso,
  "tax": 0,
  "shipping": cart.delivery_price,
  "coupon": cart.total.coupon_data.code,
  "items": items,
  'ecomm_prodid' : ids,
  'ecomm_pagetype' : 'purchase',
  'ecomm_totalvalue': cart.total.total.sum
});