https://doc.ruscomtech.ru/index.php?action=history&feed=atom&title=%D0%A1%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5_%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D1%81%D0%BA%D0%B8%D1%85_%D0%B8%D0%BC%D0%B5%D0%BD_%D0%B4%D0%BB%D1%8F_%D0%B4%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B9_%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D0%B5%D0%B9_%D0%B2%D0%B5%D0%B1-%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B9 2026-09-16T16:43:36Z История изменений этой страницы в вики MediaWiki 1.43.9 https://doc.ruscomtech.ru/index.php?title=%D0%A1%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5_%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D1%81%D0%BA%D0%B8%D1%85_%D0%B8%D0%BC%D0%B5%D0%BD_%D0%B4%D0%BB%D1%8F_%D0%B4%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B9_%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D0%B5%D0%B9_%D0%B2%D0%B5%D0%B1-%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B9&diff=6384&oldid=prev 2026-05-25T20:56:26Z

<p>Новая страница: «= Создание пользовательских имен для действий пользователей веб-приложений = Имена дейс...»</p> <p><b>Новая страница</b></p><div>= Создание пользовательских имен для действий пользователей веб-приложений =<br /> <br /> Имена действий пользователей генерируются автоматически на основе вызванных &#039;&#039;&#039;URL&#039;&#039;&#039;-адресов загрузки или &#039;&#039;&#039;XHR&#039;&#039;&#039; и зачастую сложны для восприятия и запоминания. Если ваше приложение обрабатывает множество пользовательских запросов и взаимодействий в день, отслеживание действий пользователей становится затруднительным без возможности логически их группировать. Правила именования действий пользователей позволяют генерировать единообразные и удобочитаемые названия действий, которые можно легко группировать и отслеживать в рамках всего приложения. Эти правила можно создавать и настраивать индивидуально для каждого приложения, после чего использовать в Ключ-АСТРОМ в:<br /> <br /> * диаграммах пользовательского опыта;<br /> * графиках;<br /> * целях конверсии (например, &lt;code&gt;addToCart&lt;/code&gt; и &lt;code&gt;newsletterSubscription&lt;/code&gt;);<br /> * ключевых действиях пользователей;<br /> * списке основных потребителей.<br /> <br /> Для простого создания и поддержки правил именования действий пользователей можно использовать заполнители, входные параметры и даже разные правила для действий загрузки и &#039;&#039;&#039;XHR&#039;&#039;&#039;.<br /> <br /> == Определение имени действия ==<br /> Ключ-АСТРОМ пытается присвоить действиям осмысленные имена. Для этого проверяется несколько свойств действия, таких как внутренний &#039;&#039;&#039;HTML&#039;&#039;&#039;, заголовок и подсказка &#039;&#039;&#039;HTML&#039;&#039;&#039;-элемента, инициирующего действие. Этим элементом может быть кнопка или ссылка. Также предпринимается попытка получить заголовок при более сложной структуре &#039;&#039;&#039;HTML&#039;&#039;&#039; с несколькими вложенными тегами. &#039;&#039;&#039;RUM JavaScript&#039;&#039;&#039; использует несколько методов для выбора имени, наилучшим образом соответствующего действию. Начиная с самого внутреннего узла &#039;&#039;&#039;HTML&#039;&#039;&#039;, по которому щёлкнули (кнопка, тег изображения или ссылка), выполняется проверка в следующем порядке приоритета:<br /> <br /> * атрибут &lt;code&gt;data-dtname&lt;/code&gt;;<br /> * &lt;code&gt;nodeName&lt;/code&gt; (например, изображение, ссылка или &lt;code&gt;input&lt;/code&gt;). Проверка останавливается при обнаружении тега &lt;code&gt;html&lt;/code&gt;, &lt;code&gt;body&lt;/code&gt;, &lt;code&gt;head&lt;/code&gt; или &lt;code&gt;document&lt;/code&gt;;<br /> * &lt;code&gt;innerText&lt;/code&gt; или &lt;code&gt;textContent&lt;/code&gt;.<br /> <br /> Если ни один из этих способов не даёт приемлемого результата, &#039;&#039;&#039;RUM JavaScript&#039;&#039;&#039; запускает рекурсивный алгоритм, который проверяет различные параметры в зависимости от &lt;code&gt;nodeName&lt;/code&gt; текущего проверяемого &#039;&#039;&#039;HTML&#039;&#039;&#039;-узла. Если ничего не найдено, проверяется родительский узел.<br /> <br /> == Добавление и использование заполнителей ==<br /> Заполнители позволяют добавлять динамические элементы в пользовательские правила именования. Они полезны, когда требуется включить в имена действий динамические входные значения (например, &#039;&#039;&#039;URL&#039;&#039;&#039;-адреса посещённых пользователями записей блога) или удалить/заменить определённые части входного значения (например, динамические идентификаторы сессий пользователей) и сгруппировать их под общим именем действия. Заполнитель состоит из следующих трёх элементов:<br /> <br /> * входное значение (например, &#039;&#039;&#039;URL&#039;&#039;&#039;-адрес страницы);<br /> * этап обработки, извлекающий или заменяющий части входного значения (необязательно);<br /> * имя заполнителя, используемое в правиле именования действий пользователей.<br /> <br /> Для удобства Ключ-АСТРОМ предоставляет набор предопределённых заполнителей, таких как &lt;code&gt;pageUrl&lt;/code&gt;, &lt;code&gt;sourceUrl&lt;/code&gt;, &lt;code&gt;xhrUrl&lt;/code&gt;, &lt;code&gt;Top XHR URL&lt;/code&gt; и &lt;code&gt;pageTitle&lt;/code&gt;. Чтобы лучше понять принцип работы заполнителей, рассмотрим следующий пример: &#039;&#039;&#039;XHR&#039;&#039;&#039;-действие инициирует выбор кнопки подтверждения на странице оформления заказа. За выбором кнопки подтверждения (исходное действие) следует одно из целевых действий:<br /> <br /> * несколько цепочечных &#039;&#039;&#039;XHR&#039;&#039;&#039;-запросов, вызванных первым веб-запросом, например &lt;code&gt;xhrUrl&lt;/code&gt; или &lt;code&gt;Top XHR URL&lt;/code&gt;;<br /> * новое действие загрузки, перенаправляющее на страницу подтверждения. В этом случае у вас есть &lt;code&gt;sourceUrl&lt;/code&gt; — &#039;&#039;&#039;URL&#039;&#039;&#039;-адрес, с которого был завершён процесс оформления заказа, и &lt;code&gt;pageUrl&lt;/code&gt; — &#039;&#039;&#039;URL&#039;&#039;&#039;-адрес страницы с подтверждением оформления заказа.<br /> <br /> Такие цепочки и корреляции действий лучше всего просматривать на &#039;&#039;&#039;каскадной диаграмме&#039;&#039;&#039;. Для правильного именования действий в подобных случаях можно использовать &lt;code&gt;sourceUrl&lt;/code&gt; и &lt;code&gt;pageUrl&lt;/code&gt; либо их &#039;&#039;&#039;XHR&#039;&#039;&#039;-эквиваленты &lt;code&gt;xhrUrl&lt;/code&gt; и &lt;code&gt;Top XHR URL&lt;/code&gt;. Предоставленный набор заполнителей не подлежит настройке, но может быть немедленно использован для создания собственных правил именования. Также можно создавать собственные заполнители.<br /> <br /> === Создание заполнителя ===<br /> Чтобы создать заполнитель:<br /> <br /> # Перейдите в раздел &#039;&#039;&#039;Веб&#039;&#039;&#039;.<br /> # Выберите приложение, которое хотите настроить.<br /> # В правом верхнем углу страницы обзора приложения выберите &#039;&#039;&#039;Дополнительно&#039;&#039;&#039; (…) &gt; &#039;&#039;&#039;Редактировать&#039;&#039;&#039;.<br /> # В настройках приложения выберите &#039;&#039;&#039;Захват&#039;&#039;&#039; &gt; &#039;&#039;&#039;Действия пользователей&#039;&#039;&#039;.<br /> # В разделе &#039;&#039;&#039;Заполнители&#039;&#039;&#039; выберите &#039;&#039;&#039;Добавить заполнитель&#039;&#039;&#039; и укажите тип входных данных.<br /> # Для типов данных &#039;&#039;&#039;CSS-селектор&#039;&#039;&#039;, &#039;&#039;&#039;переменная JavaScript&#039;&#039;&#039;, &#039;&#039;&#039;мета-тег&#039;&#039;&#039; и &#039;&#039;&#039;значение cookie&#039;&#039;&#039; необходимо также указать значение.<br /> # Добавьте заполнитель.<br /> # При необходимости добавьте этапы обработки и условия, а затем предварительно просмотрите заполнитель, чтобы убедиться в его корректной работе.<br /> # Если вы добавили этап обработки &#039;&#039;&#039;Extract&#039;&#039;&#039; или &#039;&#039;&#039;Extract with regular expression&#039;&#039;&#039;, выберите, следует ли возвращать пустой результат (по умолчанию) или выбранное входное значение.<br /> # Присвойте заполнителю имя и выберите &#039;&#039;&#039;Сохранить&#039;&#039;&#039;.<br /> <br /> Можно добавить до 50 заполнителей на приложение.<br /> <br /> === Этапы обработки ===<br /> Для эффективного использования заполнителей предусмотрены следующие этапы обработки:<br /> <br /> * &#039;&#039;&#039;Extract&#039;&#039;&#039;: Требует указания начального разделителя, с которого должно начинаться извлечение, и конечного разделителя, на котором оно должно заканчиваться. Разделители не входят в извлечённую часть. Если начальный разделитель отсутствует, извлечение начинается с начала входного значения. Если конечный разделитель отсутствует, извлечение продолжается до конца входного значения. При необходимости можно вернуть пустой результат (по умолчанию) или выбранное входное значение.<br /> * &#039;&#039;&#039;Replace&#039;&#039;&#039;: Требует указания начального разделителя, с которого должна начинаться замена, и конечного разделителя, на котором она должна заканчиваться. При необходимости можно указать замещающий текст. Если замещающий текст не указан, совпадающие символы удаляются.<br /> * &#039;&#039;&#039;Replace text&#039;&#039;&#039;: Требует указания текста, который необходимо идентифицировать и сопоставить. При необходимости можно указать замещающий текст. Если замещающий текст не указан, совпадающий текст удаляется.<br /> * &#039;&#039;&#039;Replace IDs&#039;&#039;&#039;: Требует указания идентификатора, который необходимо идентифицировать и сопоставить. При необходимости можно указать замещающие идентификаторы. Если замещающий идентификатор не указан, совпадающий идентификатор удаляется.<br /> * &#039;&#039;&#039;Extract with regular expression&#039;&#039;&#039;: Требует указания регулярного выражения для идентификации и извлечения. При необходимости можно вернуть пустой результат (по умолчанию) или выбранное входное значение.<br /> * &#039;&#039;&#039;Replace with regular expression&#039;&#039;&#039;: Требует указания регулярного выражения для идентификации заменяемой строки. При необходимости можно указать замещающее регулярное выражение. Если оно не указано, совпадающее регулярное выражение удаляется. В настоящее время поддерживается только одна группа захвата &lt;code&gt;(.*)&lt;/code&gt;.<br /> <br /> Если к заполнителю применяется несколько этапов обработки, они выполняются последовательно: первый этап применяется к выбранному входному значению, а каждый последующий — к результату предыдущего этапа.<br /> <br /> == Создание имён действий ==<br /> Ключ-АСТРОМ предоставляет возможность создания пользовательских действий как для загрузки, так и для &#039;&#039;&#039;XHR&#039;&#039;&#039;. Можно использовать новые заполнители или существующие, доступные в списке заполнителей, для создания новых правил именования.<br /> <br /> В этом примере мы используем &lt;code&gt;CampaignID&lt;/code&gt; для создания нового пользовательского правила именования, которое идентифицирует загрузку страницы как просмотр кампании с добавлением &lt;code&gt;CampaignID&lt;/code&gt; к имени действия.<br /> <br /> # Перейдите в раздел &#039;&#039;&#039;Веб&#039;&#039;&#039;.<br /> # Выберите приложение, которое хотите настроить.<br /> # В правом верхнем углу страницы обзора приложения выберите &#039;&#039;&#039;Дополнительно&#039;&#039;&#039; (…) &gt; &#039;&#039;&#039;Редактировать&#039;&#039;&#039;.<br /> # В настройках приложения выберите &#039;&#039;&#039;Захват&#039;&#039;&#039; &gt; &#039;&#039;&#039;Действия пользователей&#039;&#039;&#039;.<br /> # Прокрутите вниз до раздела &#039;&#039;&#039;Правила именования действий пользователей&#039;&#039;&#039; и выберите вкладку &#039;&#039;&#039;Правила именования для действий загрузки&#039;&#039;&#039; или &#039;&#039;&#039;Правила именования для XHR-действий&#039;&#039;&#039;.<br /> # Выберите &#039;&#039;&#039;Добавить правило именования&#039;&#039;&#039;.<br /> # Введите шаблон имени, используя заполнитель. Убедитесь, что заполнитель заключён в фигурные скобки (например: &lt;code&gt;{CampaignID}&lt;/code&gt;).<br /> # При необходимости определите условия, в которых также можно использовать заполнители для дальнейшего уточнения применимости правил. В нашем примере для создания пользовательского правила именования действий, применяемого только к специальной рекламной кампании с &lt;code&gt;CampaignID&lt;/code&gt; равным 3, можно использовать условия и заполнители для сопоставления только нужных действий, которые должны быть названы соответствующим образом.<br /> # При необходимости используйте раздел &#039;&#039;&#039;Предварительный просмотр правила&#039;&#039;&#039;, чтобы проверить, работает ли новое правило именования должным образом.<br /> # Выберите &#039;&#039;&#039;Сохранить&#039;&#039;&#039;.<br /> # Используйте элементы управления &#039;&#039;&#039;Вверх/Вниз&#039;&#039;&#039;, чтобы изменить приоритет правил. Первое подходящее правило в таблице применяется первым.<br /> <br /> Можно добавить до 250 правил именования действий пользователей на приложение.<br /> <br /> == Расширенная конфигурация имён действий ==<br /> Для имён действий пользователей доступны следующие дополнительные параметры конфигурации:<br /> <br /> * &#039;&#039;&#039;Разделять действия пользователей по домену&#039;&#039;&#039;: Отключите этот параметр, если разные домены не должны приводить к созданию отдельных действий пользователей. Например, если приложение доступно по адресам &lt;code&gt;www.domain-one.com&lt;/code&gt; и &lt;code&gt;www.domain-two.com&lt;/code&gt; и разделение по домену включено, загрузка страницы &lt;code&gt;/index&lt;/code&gt; для &lt;code&gt;www.domain-one.com&lt;/code&gt; приведёт к созданию действия пользователя, отличного от загрузки страницы &lt;code&gt;/index&lt;/code&gt; для &lt;code&gt;www.domain-two.com&lt;/code&gt;.<br /> * &#039;&#039;&#039;Регистронезависимое именование&#039;&#039;&#039;: Отключите этот параметр, если имена действий пользователей должны сохраняться с учётом регистра. Регистронезависимое именование позволяет выполнять поиск по всем регистрам. Например, действия пользователей с именами &lt;code&gt;Loading of Page /&lt;/code&gt; и &lt;code&gt;Loading of PAGE /&lt;/code&gt; будут сопоставлены с &lt;code&gt;loading of page /&lt;/code&gt;.<br /> * &#039;&#039;&#039;Приоритет действий загрузки и использование значения последнего обнаруженного&#039;&#039;&#039;: Включите этот параметр, если требуется использовать улучшенное распространение действий загрузки. При наличии загрузки (которая по сути является запросом документа) во время действия, действие помечается как действие загрузки. Кроме того, включите этот параметр, чтобы использовать значения заполнителей, такие как &lt;code&gt;pageUrl&lt;/code&gt;, из последнего действия загрузки для именования действий пользователей. В качестве примера рассмотрим первоначальное действие пользователя, такое как щелчок &lt;code&gt;/easytravel/search&lt;/code&gt;, которое вызывает перезагрузку страницы с &lt;code&gt;/easytravel&lt;/code&gt; на &lt;code&gt;/easytravel/search&lt;/code&gt; и, следовательно, действие загрузки &lt;code&gt;loading of page /easytravel/search&lt;/code&gt;, которое, в свою очередь, запускает ещё один &#039;&#039;&#039;XHR&#039;&#039;&#039;-вызов. При включённом параметре используется последнее обнаруженное действие загрузки, и поэтому эта цепочка действий помечается как &lt;code&gt;loading of page /easytravel/search&lt;/code&gt;. При отключённом параметре действие помечается как &lt;code&gt;click /easytravel/search&lt;/code&gt;, поскольку в предыдущей версии распространения загрузки действие загрузки не распространялось в сценариях с одновременным присутствием &#039;&#039;&#039;XHR&#039;&#039;&#039;-запросов.<br /> <br /> == Примеры использования ==<br /> В следующих разделах приведены примеры правил именования действий пользователей, созданных в более ранней версии, и показано, как эквивалентные правила можно создать с помощью новой, улучшенной версии правил именования действий пользователей.<br /> <br /> === Извлечение ценной информации из входных данных ===<br /> Примеры из более ранней версии правил именования действий пользователей:<br /> <br /> * Extract &lt;code&gt;/some-path-before/(.*).some-defined-text-after&lt;/code&gt; from path<br /> * Extract &lt;code&gt;Loading of page /sales/(.*)&lt;/code&gt; from action name<br /> * Extract &lt;code&gt;(.*)&lt;/code&gt; from page title<br /> * Extract &lt;code&gt;(.*)&lt;/code&gt; from XHR URL<br /> <br /> Теперь того же результата можно достичь с помощью заполнителей и этапа обработки. С помощью этапа обработки &#039;&#039;&#039;Extract&#039;&#039;&#039; можно определить начальный и конечный разделители, точно указывающие, откуда следует извлекать значения. Таким образом, можно заменить многие правила именования, которые ранее требовали регулярных выражений.<br /> <br /> === Именование действий на основе URL-адреса или пути ===<br /> Примеры из более ранней версии именования действий пользователей:<br /> <br /> * Design phase: if action name contains &lt;code&gt;design&lt;/code&gt;<br /> * Configuration data call: action name matches regular expression &lt;code&gt;*/config/*&lt;/code&gt;<br /> * Product: path starts with &lt;code&gt;/product/&lt;/code&gt;<br /> * Search: XHR URL starts with &lt;code&gt;/api/search/dynamic&lt;/code&gt;<br /> <br /> В более ранней версии правил именования действий пользователей имя действия обычно использовалось в качестве входного значения для переименования действий, автоматически обнаруженных Ключ-АСТРОМ. Это часто приводило к путанице, поскольку пользователи не понимали, что имена действий используются в качестве входных значений в том виде, в котором они были определены. Здесь важно различать автоматически обнаруженное имя действия, присвоенное Ключ-АСТРОМ (возможное входное значение), и окончательное имя действия, определённое пользователем с помощью правила именования. Во всех этих случаях пользователь мог бы просто использовать путь страницы, &#039;&#039;&#039;URL&#039;&#039;&#039;-адрес или &#039;&#039;&#039;XHR URL&#039;&#039;&#039;. В новой версии можно использовать стандартный заполнитель в правиле именования, например &lt;code&gt;pageUrlPath&lt;/code&gt; или &lt;code&gt;pageUrl&lt;/code&gt;, для получения той же информации с последующим условием «начинается с» или «содержит» для достижения того же результата.<br /> <br /> С другой стороны, для большей гибкости можно использовать условие «соответствует регулярному выражению». Например, правила из более ранней версии именования действий пользователей: Customer contact request for UFO: XHR URL matches regular expression &lt;code&gt;.*/api/request/.*/contact?category=UFO&lt;/code&gt;.<br /> <br /> === Удаление или маскировка частей входных данных ===<br /> Примеры из более ранней версии именования действий пользователей:<br /> <br /> * Remove identifier: &lt;code&gt;(\\?|&amp;)_id=:*?(?=&amp;|$)&lt;/code&gt;<br /> * Remove conversation: &lt;code&gt;(\\?|&amp;)conversation=:*?(?=&amp;|$)&lt;/code&gt;<br /> * Remove parameters: &lt;code&gt;\?.*&lt;/code&gt;<br /> * Remove searched car: &lt;code&gt;(?&lt;=search-results\/cars\/)[a-zA-Z0-9]*&lt;/code&gt;<br /> <br /> Теперь удаление и маскировку частей данных можно выполнить проще с помощью подхода «удалить между». Если требуется удалить значение определённого параметра строки запроса, который может быть идентификатором пользователя, определите ключ как конечный разделитель, а &lt;code&gt;&amp;&lt;/code&gt; — как следующий символ, вводящий другие параметры. Если во входных данных отсутствует конечный разделитель, вы получите уведомление. Для большей гибкости или, например, для удаления всех параметров &#039;&#039;&#039;URL&#039;&#039;&#039;-адреса используйте замену с регулярным выражением.<br /> <br /> === Консолидация правил именования с помощью заполнителей ===<br /> Рассмотрим процесс оформления заказа в электронной коммерции. Чтобы именовать действия загрузки для каждого шага в более ранней версии, требовалось сначала определить по одному правилу именования действий для каждого отдельного шага. В данном случае на каждый шаг оформления заказа назначается одно правило:<br /> <br /> * Load page &quot;Enter personal details&quot;: action name starts with &lt;code&gt;/checkout/index.php?step=details&lt;/code&gt;<br /> * Load page &quot;Select payment method&quot;: action name starts with &lt;code&gt;/checkout/index.php?step=payment&lt;/code&gt;<br /> * Load page &quot;Order summary&quot;: action name starts with &lt;code&gt;/checkout/index.php?step=summary&lt;/code&gt;<br /> * Load page &quot;Order confirmation&quot;: action name starts with &lt;code&gt;/checkout/index.php?step=confirmation&lt;/code&gt;<br /> <br /> В новой версии можно создать заполнитель, использующий переменную JavaScript с именем &lt;code&gt;adobePageName&lt;/code&gt; в качестве входных данных, которая уже может быть доступна в существующем уровне данных аналитического инструмента, например &#039;&#039;&#039;Adobe Analytics&#039;&#039;&#039;. Используя возможности ранее определённого заполнителя, можно затем создать единое правило именования действий, которое охватывает все правила именования, созданные в более ранней версии, и приводит к тем же именам действий.<br /> <br /> == Установка имени действия через data-dtname ==<br /> Если стандартное определение имени действия не подходит, можно установить пользовательский атрибут &lt;code&gt;data-dtname&lt;/code&gt; в &#039;&#039;&#039;HTML&#039;&#039;&#039;-тегах и использовать его в качестве заголовка. Например, действию &lt;code&gt;Firstname&lt;/code&gt; можно присвоить заголовок &lt;code&gt;click on &quot;Firstname Text Input&quot;&lt;/code&gt;. Чтобы пользовательский атрибут отображался в качестве имени действия пользователя, также необходимо настроить правило именования, включающее заполнитель &lt;code&gt;{elementIdentifier (default)}&lt;/code&gt;. Если для разных инструментов используются разные имена атрибутов, можно задать альтернативу &lt;code&gt;data-dtname&lt;/code&gt;, которую Ключ-АСТРОМ сможет использовать для именования действий пользователей.</div>

IKuznetsov