Типове дефинирани от потребителите променливи за мрежата

Създавайте персонализирани, дефинирани от потребителя променливи за мрежата в Мениджър на маркери на Google, които да отговарят на определени изисквания, които може все още да не са обхванати от вградените променливи.

За да създадете нова, дефинирана от потребителя променлива:

1. В навигацията вляво кликнете върху Променливи.
2. В секцията „Дефинирани от потребителя променливи“ кликнете върху Нова.
3. Кликнете върху Конфигуриране на променлива и изберете тип на променливата.
4. Въведете опции за конфигуриране за избрания тип променлива.
5. Изберете име за променливата. Използвайте схема за именуване, която описва функцията на променливата, напр. „Име на променлива в слоя данни – Име на продукта“.
6. Кликнете върху Запазване.

Мениджър на маркери поддържа следните типове дефинирани от потребителя променливи за мрежата:

• Навигация
  • Препращащ URL адрес в HTTP
  • URL адрес
• Променливи за страницата
  • „Бисквитка“ на посещавания домейн
  • Персонализиран JavaScript
  • Слой данни
• Елементи в страницата
  • Променлива на автоматизираното събитие
  • Елемент от DOM
  • Видимост на елемента
• Помощни приложения
  • Константа
  • Персонализирано събитие
  • Име на средата
  • Настройки на Google Анализ
  • Маркер на Google: Настройки за конфигуриране
  • Маркер на Google: Настройки за събития
  • Справочна таблица
  • Случайно число
  • Таблица с рег. изрази
• Предоставени от потребителя данни
• Данни за контейнера
  • Идентификатор на контейнер
  • Номер на версията на контейнера
  • Режим за отстраняване на грешки

Навигация

Препращащ URL адрес в HTTP

Като стойност се задава препращащият URL адрес в НТТР, който е URL адресът на предходната страница, посетена от потребителя. Ако например посетител стигне до някоя от продуктовите Ви страници от началната страница, препращащият URL адрес ще бъде този на началната страница. Екземпляр от този тип променлива се създава автоматично от Мениджър на маркери на Google, но можете да създадете допълнителни екземпляри, ако искате да се изложи различни части от препращащия URL адрес.

URL адрес

Този тип променлива Ви дава възможност да правите синтактичен анализ и да излагате компоненти на URL адреса. Можете да създадете допълнителни екземпляри, ако искате да се изложат различни части от URL адреса. Компонентите на URL адреса, от които можете да избирате, са: пълен URL адрес, протокол, име на хост, порт, път, разширение на файловото име, заявка и фрагмент. Входящата стойност, зададена за променливи от този тип, е URL адресът на текущата страница, на която се намира потребителят (извлечен от document.location). Коригирайте Източник на URL адреса, за да укажете на Мениджър на маркери да използва друга променлива като стойност на източника на URL адреса.

Променливи за страницата

„Бисквитка“ на посещавания домейн

Като стойност се задава стойността на „бисквитката“ на посещавания домейн с името на домейна, на който в момента се намира потребителят. Ако в един и същ домейн бъде поставена повече от една „бисквитка“ със същото име, се избира първата стойност. Това е аналогично на извикване на document.cookie в страница и избиране на първия резултат.

Персонализиран JavaScript

Като стойност се задава резултатът от функцията на JavaScript. JavaScript трябва да приеме формата на анонимна функция, която извежда стойност. Можете например да създадете персонализирана променлива на JavaScript, която да преобразува всички екземпляри на предварително зададената променлива {{url}} в малки букви:

function () {
  return {{url}}.toLowerCase();
}

Слой данни

Стойността се задава, когато данните се изпращат на слоя данни посредством извикването dataLayer.push() call:
dataLayer.push({"Data Layer Name": "value"}).

Можете да посочите как Мениджър на маркери да интерпретира точките („.“) в името на ключа:

• Версия 1: разрешаване на точки в имената на ключовете. За dataLayer.push("a.b.c": "value") например името на ключа да се тълкува като „a.b.c“ (т.е. {"a.b.c": "value"}).
• Версия 2: интерпретиране на точките като вложени стойности. Например dataLayer.push({"a.b.c": "value"}) да се тълкува като три вложени нива: {a: {b: {c: "value"}}}.

Променлива в JavaScript

Като стойност се задава тази на посочената от Вас глобална променлива в JavaScript. Ако необходимата стойност не е била настроена в слоя данни (вижте променлива в слоя данни) и не се вижда в DOM (вижте също: променлива „Елемент от DOM“), съществува възможност стойността да се извлече от променлива в JavaScript. Използвайте този тип променлива, ако можете да намерите стойността в изходния код на страницата под формата на глобална променлива в JavaScript.

Елементи в страницата

Променлива на автоматизираното събитие

Улавя информация относно елемент, който е задействал събитие (напр. кликвания, изпращания на формуляри, видимост на елемента и т.н.).

• Element: Връща обекта от елемента. Може да се разглежда като обект за персонализиран JavaScript, напр. {{Element}}.title или CSS селектори, напр. {{Element}} съответства на CSS селектор div.foo.
• Element Type: Връща стойността element.tagName, напр. „A“, „BUTTON“, „IMG“.
• Element Attribute: Посочва име на атрибута, като тази опция връща стойността на този атрибут.
• Element Classes: Връща списъка с класове, намиращи се в атрибута class на елемента.
• Element ID: Връща стойността на атрибута id.
• Element Target: Връща стойността на атрибута target, напр. „_blank“.
• Element Text: Връща стойността на текстовото съдържание на елемента.
• Element URL: Връща URL адреса на елемента, събран от атрибутите href или action.
• History New URL Fragment: Връща фрагмента на новия URL адрес от историята на сърфирането, напр. „#summary“.
• History Old URL Fragment: Връща фрагмента на стария URL адрес от историята на сърфирането, напр. „#intro“.
• History New State: Обектът на новото състояние на историята, управляван от извикванията на сайта към pushState.
• History Old State: Обектът на старото състояние на историята, управляван от извикванията на сайта към pushState.
• History Change Source: Връща събитието, причинило промяната в историята, напр. „pushState“, „replaceState“ и т.н.

Елемент от DOM

Като стойност се задава текстът на елемента от DOM (Модел на обекти на документи) или стойността на посочения атрибут на елемента от DOM. Ако търсената от Вас стойност не е настроена в слоя данни (вижте променлива в слоя данни), съществува възможност стойността да се извлече от DOM. Използвайте този тип променлива, ако можете да намерите стойността в DOM.

Ако се зададе незадължителното име на атрибут, стойността на променливата ще изведе тази, посочена от съответния атрибут (напр. data-food="cupcake"). В противен случай стойността на променливата ще бъде текстът на елемента от DOM.

Видимост на елемента

Стойността се задава въз основа на видимата част на конкретния елемент от DOM. За разлика от задействането тип „Видимост на елемента“ една променлива от този тип може да подава сигнал за видимостта само на един елемент. Решете дали да изберете елемент въз основа на идентификационния му номер или на CSS селектор. Ако на определен CSS селектор съответстват няколко елемента, ще се използва първият съвпадащ елемент.

За тази променлива можете да изберете типа изходни данни:

• Вярно/невярно: Булева стойност, посочваща дали избраният елемент е видим при използването на променливата.
• Процент: Процентна стойност между 0 и 100, посочваща какъв процент от избрания елемент е видим на екрана при използването на променливата.

Ако за тип на изходните данни изберете Вярно/невярно, можете да посочите и Минимален процент видимост, който да указва какъв процент от избрания елемент трябва да бъде видим на екрана, за да може променливата да върне стойност „вярно“.

Помощни приложения

Константа

Като стойност се задава посоченият от Вас низ. Променливите „Константен низ“ се използват обичайно, когато има няколко маркера, използващи един и същ номер на сметка. Вижте също: Настройки на Google Анализ.

Персонализирано събитие

Като стойност се задава името на персонализираното събитие, изпратено в слоя данни.

Име на средата

Връща името на средата, която се вижда в режим на визуализация.

Настройки на Google Анализ

Променливата в „Настройки на Google Анализ“ се използва в маркери на Universal Analytics в уеб и мобилни (Firebase) контейнери за централно конфигуриране и споделяне на общи настройки на Google Анализ, които се използват от няколко маркера. Когато създадете маркер на Google Анализ, като използвате Universal Analytics, Мениджър на маркери ще Ви подкани да изберете или създадете променлива в „Настройки на Google Анализ“. Научете повече.

Маркер на Google: Настройки за конфигуриране

Тази променлива Ви дава възможност да задавате параметри на ниво конфигурация, когато маркерът на Google се зарежда.

Да приемем например, че публикувате уебсайта си на няколко езика и искате да сегментирате аудиторията си според езика, на който чете. Можете да създадете променлива за конфигуриране с параметър language, която да използвате за маркерите си на Google, вместо да актуализирате всеки маркер ръчно.

Научете как да използвате повторно настройките за конфигуриране.

Маркер на Google: Настройки за събития

Тази променлива Ви дава възможност да задавате параметри на ниво събитие, така че да изпращате допълнителни данни със събитие в GA4.

Да предположим например, че притежавате онлайн магазин и имате разпродажба. Бихте искали да проследявате колко хора използват кода за отстъпка, който сте им предоставили. Вместо да добавяте параметъра discount към всеки от маркерите си ръчно, можете да използвате повторно параметъра с променлива за Маркер на Google: Настройки за събития.

Научете как да използвате повторно настройките за конфигуриране.

Справочна таблица

Стойността се задава съгласно указанията в справочната таблица. Тя съдържа две графи: (Таблицата е празна, за да се илюстрира как данните се използват по-късно):

Когато [изберете променлива] е равно на	Задайте [тази променлива] на

Справочната таблица Ви дава възможност да създадете променлива, за която стойността да варира според стойността в друга променлива. Това е полезно, ако уебсайтът Ви е настроен по такъв начин, че съответната стойност (например идентификационен номер на реализацията) може да се съпостави към URL адреса, елемента в DOM или друга част от страницата. В този пример се създава променлива на име Идентификационен номер на реализацията. Ако URL адресът съдържа „/thanks/buy1.html“, като стойност се задава „12345“; ако URL адресът съдържа „thanks/buy2.html“, като стойност се задава „34567“.

Когато {{url}} съдържа	Задайте {{Идент. № на реал.}} на
/thanks/buy1.html	12345
/thanks/buy2.html	34567
/thanks/buy3.html	56789

Случайно число

На стойността се присвоява случайно число между 0 и 2147483647.

Таблица с рег. изрази

Променливата „Таблицата с регулярни изрази“ е подобна на променливата Справочна таблица, с добавената възможност за изпълнение на образци за регулярни изрази за елементите, за които искате да намерите съответствие.

За тази конфигурация на таблица с регулярни изрази:

Образец	Изходяща стойност
.*/page[1-3]\.html.*	foo
.*/page[4-6]\.html.*	бар
.*/page[7-9]\.html.*	baz

Изходящата стойност на променливата ще бъде, както следва:

Съвпадащ резултат	Стойност
http://example.com/page1.html	foo
http://www.example.com/page1.html	foo
http://example.com/page2.html#detail	foo
http://example.com/page5.html	бар
http://example.com/page5.html?status=new	бар
http://example.com/page6.html	бар
https://example.com/page9.html	baz

Търсенията в таблицата с регулярните изрази се извършват в последователност от горната част на списъка към долната. Когато бъде намерено съвпадение, се връща съответната изходяща стойност.

Изберете Задаване на основната стойност, за да зададете изходяща стойност за случаите, когато не е намерено съвпадение.

По подразбиране образците трябва да съответстват напълно на въведения низ и отчитат регистъра на буквите. Това поведение може да се коригира в Разширени настройки:

• Пренебрегване на регистъра на буквите: Образците ще съответстват на съвпадения с главни и малки букви, без да е необходимо това да се вгражда изрично в регулярен израз.

• Само точни съответствия: Ако е активирана, образците трябва да съответстват напълно на въведеното. Това е равностойно на наличието по подразбиране на котви за начало (^) и край ($) около образеца Ви. Ако е деактивирана, образците ще съответстват, където и да се намират във входящата стойност.

• Функции за прихващане и заместване на групи: Ако са активирани, можете да използвате синтаксиса за заместване със знак на долар, за да включите части от въведеното (напр. от прихващане на групи в съответстващия образец) в изходящата стойност. Ако например съответстващият регулярен израз е /(news)/page(2)\.html, можете да използвате $1 за препращане към първата група – („news“) и $2 за препращане към втората група („2“).

Използването на „Функции за прихващане и заместване на групи“ заедно с деактивирана опция „Само точни съответствия“ може да доведе до неочаквано поведение (т.е. може да върне цялата входяща стойност със заместване на съответстващата част).

Предоставени от потребителя данни

Събира информация от формуляри за връзка, като имейл, телефон, име и адрес. Посочете информацията, която да събира, като използвате един от следните режими:

• Автоматично конфигуриране: Автоматично открива полета във формуляри на уебсайта Ви и нови записи.
• Ръчно конфигуриране: Дава Ви възможност да установите съответствие между съществуващите променливи в Мениджър на маркери и полетата за предоставените от потребителя данни, като например имейл, телефонен номер, име и адрес.
• Код: Дава Ви възможност да посочите променлива в слоя данни или персонализирана променлива в JavaScript, която връща структурирания Ви обект с предоставените от потребителя данни.

Данни за контейнера

Идентификатор на контейнер

Връща идентификатора на контейнера на Мениджър на маркери, напр. „GTM-101010“.

Номер на версията на контейнера

Когато контейнерът е в режим на визуализация, променливата за неговата версия извежда номера на визуализираната версия. В противен случай извежда номера на активната версия на контейнера.

Режим за отстраняване на грешки

Като стойност се задава true, ако контейнерът е в режим визуализация и отстраняване на грешки, и false, ако не е в такъв режим.