Интеграция Customer Voice на страницы сайта электронной коммерции

2024-07-30

В этой статье описывается, как интегрироваться Microsoft Dynamics 365 Customer Voice в Dynamics 365 Commerce страницы сайта электронной коммерции.

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

Интеграция службы Customer Voice

Чтобы создать учетную запись Customer Voice, перейдите на Customer Voice и следуйте инструкциям.

После создания учетной записи Customer Voice и входа следующий шаг — выбор шаблона проекта для типа отзывов, которые необходимо собирать.

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

Перейдите на страницу шаблона проекта Customer Voice.
Выберите Начало работы.
Выберите шаблон проекта, соответствующий типу отзывов, которые вы хотите собирать, а затем выберите Далее.
На вкладке Отправить в области Выберите формат внедрения выберите формат внедрения. В поле Код внедрения отображается код, который должен быть внедрен в конструктор сайтов Commerce.

В примерах этой статьи используется шаблон проекта Периодический опрос клиентов и формат внедрения Кнопка.

На следующей иллюстрации в качестве примера показана страница шаблона проекта Периодический опрос клиента, где в качестве формата внедрения выбран вариант Кнопка, а код внедрения для этого варианта отображается в поле Код внедрения. Для внедрения предоставленного кода на страницы сайта необходимо выполнить три отдельных действия, как описано в следующих разделах.

Страница «Периодический опрос клиентов», где выбран вариант «Кнопка».

Внедрение URL-адреса внешнего сценария

На все страницах сайта, где должен присутствовать опрос Customer Voice, необходимо внедрить URL-адрес внешнего сценария, предоставленный Customer Voice в качестве кода внедрения. Лучшим способом внедрения сценария на несколько страниц сайта является создание в конструкторе сайтов фрагмента, содержащего URL-адрес внешнего сценария и последующее добавление этого фрагмента к шаблонам соответствующих страниц. После публикации обновленного шаблона код внешнего сценария на затронутых страницах сайта будет похож на приведенный ниже пример.

<script src=https://mfpembedcdnmsit.azureedge.net/mfpembedcontmsit/Embed.js type="text/javascript"></script>

Дополнительные сведения о фрагментах см. в разделе Работа с фрагментами.

Примечание

Все, что вам нужно сделать — добавить URL-адрес к фрагменту. Модуль внешнего сценария добавит остальной код сценария.

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

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

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

Внедрение кода внешней таблицы стилей

Далее, на всех страницах сайта, где должен присутствовать опрос Customer Voice, необходимо внедрить код внешней таблицы стилей, предоставленный Customer Voice в качестве кода внедрения. Как и в предыдущем разделе, лучшим способом внедрения кода внешней таблицы стилей на несколько страниц сайта является создание в конструкторе сайтов фрагмента, содержащего код внешней таблицы стилей и последующее добавление этого фрагмента к шаблонам соответствующих страниц. Внедренный код внешней таблицы стилей будет походить на следующий пример кода.

<link rel="stylesheet" type="text/css" href=https://mfpembedcdnmsit.azureedge.net/mfpembedcontmsit/Embed.css />

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

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

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

Внедрение встроенного кода сценария

Далее, на всех страницах сайта, где должен присутствовать опрос Customer Voice, необходимо внедрить встроенный сценарий, предоставленный Customer Voice в качестве кода внедрения. Как и в предыдущих разделах, лучшим способом внедрения встроенного сценария на несколько страниц сайта является создание в конструкторе сайтов фрагмента, содержащего код встроенного сценария и последующее добавление этого фрагмента к шаблонам соответствующих страниц.

В следующем примере кода встроенного сценария SURVEY_KEY — это заполнитель. Значение SURVEY_KEY должно соответствовать фактическому ключу опроса, указанному Customer Voice в коде внедрения. Последняя строка вызывает код, который через одну секунду отображает кнопку опроса, и это гарантирует наличие достаточного времени для загрузки сценариев. В зависимости от выбранного опроса может также потребоваться добавить или изменить другие метаданные, например название компании.

function renderSurveyButton() {
    var se = new SurveyEmbed("SURVEY_KEY","https://customervoice.microsoft.com/","https://mfpembedcdnmsit.azureedge.net/mfpembedcontmsit/","true");

    var context = {
        "First Name":"",
        "Last Name": "",
        "locale": "en-us",
        "companyname": "Adventure Works"
    };
    se.renderButton(context);
}

setTimeout(renderSurveyButton, 4000);

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

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

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

Добавление фрагментов в шаблон

По завершении создания фрагментов, содержащих внедренный код Customer Voice, их необходимо добавить в шаблоны страниц, связанные со страницами сайта, туда, где они должны использоваться. На следующей иллюстрации с примером показаны три примера фрагментов, добавленные в шаблон страницы сведений о продукте (PDP).

Примеры фрагментов, добавленных к шаблону PDP.

После публикации обновленного шаблона опрос Customer Voice будет отображаться на всех страницах, управляемых шаблоном.

Дополнительные сведения о шаблонах см. в разделе Работа с шаблонами.

Настройка политики безопасности содержимого

По умолчанию политика безопасности содержимого (CSP) не разрешает совершать вызовы других служб без дополнительных настроек. Таким образом, после публикации обновленных шаблонов, опрос, скорее всего, не будет загружаться на соответствующих страницах сайта. Чтобы просмотреть ошибки, связанные с CSP, откройте средства разработчика в браузере (F12), а затем перейдите на страницу, на которой присутствует опрос. Ошибки, связанные с CSP, появятся в выводе консоли.

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

Перейдите к Параметры сайта > Расширения.
На вкладке Политика безопасности содержимого добавьте https://customervoice.microsoft.com/ в директиву child-src.
Добавьте https://customervoice.microsoft.com/ в директиву frame-src.
Добавьте https://mfpembedcdnmsit.azureedge.net и .azureedge.net в директиву img-src.