Добавление кода скрипта на страницы сайта для поддержки телеметрии

Статья
03/08/2023

В этой статье описывается добавление клиентского кода скрипта на страницы сайта для поддержки сбора телеметрии на стороне клиента.

Веб-аналитика является важным средством, когда необходимо понять, как клиенты взаимодействуют с вашим сайтом, и принимать решения, которые помогут оптимизировать работу по максимальной конверсии. Доступно множество пакетов веб-аналитики, которые помогут достичь этих целей, такие как Google Analytics, Click, Moz Analytics и KISSMetrics. Для большинства пакетов веб-аналитики требуется добавить клиентский код сценария в элемент <head> кода HTML для всех страниц сайта.

Примечание

Инструкции, приведенные в этой статье, применимы также к другим пользовательским функциям на стороне клиента, которые Microsoft Dynamics 365 Commerce изначально не предлагает.

Создание повторно используемого фрагмента кода сценария

Фрагмент позволяет повторно использовать код встроенного или внешнего сценария на всех страницах сайта, независимо от используемого шаблона.

Создание повторно используемого фрагмента для кода встроенного сценария

Чтобы создать повторно используемый фрагмент для кода встроенного сценария в средстве построения сайтов, выполните следующие действия.

Перейдите к разделу Фрагменты, и затем выберите Создать.
В диалоговом окне Создать фрагмент выберите Встроенный сценарий.
В области Имя фрагмента введите имя фрагмента, затем выберите ОК.
Под созданным фрагментом выберите модуль Встроенный сценарий по умолчанию.
На панели свойств в правой части в разделе Встроенный сценарий введите клиентский сценарий. Затем настройте другие параметры нужным образом.
Выберите Сохранить, затем выберите Завершить правку.
Выберите Опубликовать.

Создание повторно используемого фрагмента для кода внешнего сценария

Чтобы создать повторно используемый фрагмент для кода внешнего сценария в средстве построения сайтов, выполните следующие действия.

Перейдите к разделу Фрагменты, и затем выберите Создать.
В диалоговом окне Создать фрагмент выберите Внешний сценарий.
В области Имя фрагмента введите имя фрагмента, затем выберите ОК.
Под созданным фрагментом выберите модуль Внешний сценарий по умолчанию.
На панели свойств в правой части в области Источник сценария добавьте внешний или относительный URL-адрес для источника внешнего сценария. Затем настройте другие параметры нужным образом.
Выберите Сохранить, затем выберите Завершить правку.
Выберите Опубликовать.

Примечание

Если для сайта активирована политика безопасности содержимого (CSP), убедитесь, что все внешние URL-адреса добавлены в директиву CSP script-src в конструкторе сайтов Commerce. Дополнительные сведения см. в разделе Управление политикой безопасности содержимого (CSP).

Добавление фрагмента, включающего код сценария, в шаблон

Чтобы добавить фрагмент, включающий код сценария, в шаблон в средстве построения сайтов, выполните следующие действия.

Перейдите к разделу Шаблоны и откройте шаблон для страниц, к которым необходимо добавить код сценария.
В левой области разверните иерархию шаблонов, чтобы отобразить слот Заголовок HTML.
В ячейке Заголовок HTML выберите кнопку с многоточием (...), затем выберите Добавить фрагмент.
Выберите фрагмент, который был создан для кода сценария.
Выберите Сохранить, затем выберите Завершить правку.
Выберите Опубликовать.

Добавление внешнего сценария или встроенного сценария непосредственно в шаблон

Если необходимо вставить встроенный или внешний сценарий непосредственно в набор страниц, управляемых одним шаблоном, не требуется сначала создавать фрагмент.

Добавление встроенного сценария непосредственно в шаблон

Чтобы добавить встроенный сценарий непосредственно в шаблон в средстве построения сайтов, выполните следующие действия.

Перейдите к разделу Шаблоны и откройте шаблон для страниц, к которым необходимо добавить код сценария.
В левой области разверните иерархию шаблонов, чтобы отобразить слот Заголовок HTML.
В ячейке Заголовок HTML выберите кнопку с многоточием (...), затем выберите Добавить модуль.
В диалоговом окне Добавить модуль выберите Встроенный сценарий.
На панели свойств в правой части в разделе Встроенный сценарий введите клиентский сценарий. Затем настройте другие параметры нужным образом.
Выберите Сохранить, затем выберите Завершить правку.
Выберите Опубликовать.

Добавление внешнего сценария непосредственно в шаблон

Чтобы добавить внешний сценарий непосредственно в шаблон в средстве построения сайтов, выполните следующие действия.

Перейдите к разделу Шаблоны и откройте шаблон для страниц, к которым необходимо добавить код сценария.
В левой области разверните иерархию шаблонов, чтобы отобразить слот Заголовок HTML.
В ячейке Заголовок HTML выберите кнопку с многоточием (...), затем выберите Добавить модуль.
В диалоговом окне Добавить модуль выберите Внешний сценарий.
На панели свойств в правой части в области Источник сценария добавьте внешний или относительный URL-адрес для источника внешнего сценария. Затем настройте другие параметры нужным образом.
Выберите Сохранить, затем выберите Завершить правку.
Выберите Опубликовать.