Руководство по созданию ссылок на статьи поддержки

Contributors Contributors Создано: 3 дня, 8 часов ago

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

Ссылки на SUMO в продуктах

Для ссылок, размещаемых в интерфейсе браузера Firefox или Firefox для Android, необходимо использовать определенную структуру URL-адресов. Эта структура позволяет команде CX Content Team корректировать назначение ссылок без нарушения функциональности Firefox. Мы установили конкретные целевые показатели для различных тем, что позволяет нам направлять пользователей к наиболее актуальным статьям, основываясь на таких факторах, как их операционная система или версия Firefox. Такая гибкость означает, что обновления или изменения можно вносить непосредственно в Kitsune, без необходимости внесения каких-либо изменений в код Firefox.

Вот формат для создания встроенных ссылок на статьи SUMO:

https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/TOPIC

Примечание: Секции %VERSION%/%OS%/%LOCALE%/ являются заполнителями. Инженеры отвечают за динамическое заполнение их в исходном коде.

Пример:

https://support.mozilla.org/1/firefox/13.0a2/Darwin/en-US/prefs-privacy

В этой структуре:

  • %VERSION% Относится к версии Firefox.
  • %OS% Представляет операционную систему пользователя.
  • %LOCALE% Определяет языковые и региональные настройки пользователя.
  • TOPIC Обозначает тему вспомогательной статьи, и это может быть любая текстовая строка.

Для ссылок, относящихся к Firefox для Android, URL-адрес должен содержать /1/mobile, чтобы отличать его от ссылок, предназначенных для настольной версии.

Примечание: При создании заполнителя SUMO для тестирования встроенной ссылки на продукт его необходимо опубликовать и сохранить в разделе administration, чтобы он функционировал должным образом. Как только содержание будет доработано и готово к публикации, статью следует удалить из системы администрирования, чтобы она была доступна конечным пользователям.
Создание ссылок внутри продукта должно быть согласовано с помощью Content Request Bugzilla, которым будет управлять команда CX Content Team. Пожалуйста, не пытайтесь создавать эти ссылки вручную, так как их необходимо настроить в Kitsune, прежде чем они смогут нормально функционировать.

Избегайте перенаправлений на якори

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

Ссылки на SUMO в веб-свойствах

При создании ссылок из веб-свойств, внешних по отношению к Firefox, не указывайте в URL-адресе языковую часть. Это позволяет системе SUMO автоматически определять и направлять пользователя к соответствующей языковой версии статьи на основе настроек его браузера.

Так, например, в случае ссылки на статью Обновление Firefox до последнего выпуска:

  • Используйте https://support.mozilla.org/kb/update-firefox-latest-release
  • Не используйте https://support.mozilla.org/en-US/kb/update-firefox-latest-release

Ссылка из другого места

Если вы размещаете ссылку не из Firefox или веб-сайта (например, приложения, продукта, электронной почты и т.д.), вы, вероятно, захотите использовать URL (без указания языка) и указать источник.

Пример:

https://support.mozilla.org/kb/update-firefox-latest-release?utm_source=nameofsource

Создание коротких ссылок mzl.la

Пожалуйста, обратитесь к статье Как сгенерировать ссылку mzl.la, чтобы узнать, как вы можете создать короткую ссылку mzl.la.

Вопросы?

Если вам нужно настроить ссылку внутри продукта, пожалуйста, заполните заявку Content Request Bugzilla. По любым вопросам пишите в этой теме поддержки.

Дополнительная инормация

Эти прекрасные люди помогли написать эту статью:

Illustration of hands

Станьте волонтёром

Растите и делитесь опытом с другими. Отвечайте на вопросы и улучшайте нашу базу знаний.

Подробнее