Объём работы по переводу
Узнайте, как сгенерированные слова, события, токены и изменения в репозитории отражают разные стороны учтённой работы по локализации.
Отчёты об объёме работы показывают, где зафиксирована активность по локализации. Показатель Сгенерированные слова в подразделе Обзор раздела Радар отражает объём текста, который Lingo.dev сгенерировал за этот месяц. Показатель События в разделе Исследование позволяет отслеживать зарегистрированную активность во времени, по языкам, движкам или провайдерам.
Перед сравнением выберите единицу измерения. Один запрос может содержать много слов, число токенов зависит от языка и модели, а один коммит в репозитории может изменить множество ключей в разных локалях.
Сгенерированные слова #
Объём перевода рассчитывается по числу слов и запросов в успешно выполненных запросах на перевод, которые были зарегистрированы. Исходные данные сгруппированы по организации, часу UTC, движку локализации, исходной и целевой локалям. Суммируйте words или requests. Если считать строки, вы получите число часовых групп, а не запросов.
Карточка в обзоре показывает число слов за месяц и сравнивает прошедшую часть месяца с теми же датами предыдущего. Название предыдущего месяца указано на карточке, например vs Oct 1 – 2. В отчётах используется часовой пояс организации, но исходные сводные данные сгруппированы по часам UTC. По ним не всегда можно восстановить произвольные границы интервала с точностью до минуты или точные границы местных суток в часовых поясах со смещением на неполное число часов.
В выборку входят только успешно выполненные зарегистрированные запросы. Неудачные запросы, отсутствующие записи и внешние переводы, которых нет в этом источнике, не учитываются. Повторные запросы и генерация вариантов могут увеличить счётчик, не увеличивая объём уникального контента. Число сгенерированных за день слов также не равнозначно числу завершённых многоязычных заданий или объёму опубликованного текста.
Чтобы читать данные об объёме перевода через POST /v2/organizations/:orgId/analytics/translation-volume, нужно состоять в организации. Для карточки в обзоре и других запросов аналитики также проверяется право доступа к отчётам. Если представление недоступно, загляните в разделы Доступ к функциям и Роли и разрешения. Не стоит считать, что доступ к одному отчёту даёт доступ ко всем.
Чтобы рассчитать рост за период, сравните полные интервалы с согласованными границами и используйте формулу:
(current volume − previous volume) / previous volumeЕсли предыдущее значение равно нулю, этот коэффициент роста не определён. Вместо него укажите впервые зарегистрированный объём. Всплеск может быть связан с релизом, расширением списка локалей или повторной работой. Сам по себе он ничего не говорит о качестве.
Количество событий #
В разделе Данные выберите События, чтобы каждое зарегистрированное событие учитывалось один раз.
Перед подсчётом задайте фильтр Тип события: начало локализации и её завершение — это два события. Чтобы узнать объём в словах, используйте показатель Сгенерированные слова в обзоре.
Группируйте события по полям Тип события, Целевая локаль, Исходная локаль, Движок или Провайдер. Например, график События по целевой локали в подразделе Примеры раздела Исследование показывает, как учтённая работа распределяется по языкам.
Подробный анализ токенов и стоимости доступен на странице «Использование». Число событий, число слов и использование токенов отражают разные единицы работы.
Изменения в репозитории #
В подключённом репозитории GitHub регистрируются изменения поддерживаемых ключей локализации в ветке по умолчанию. При каждом коммите для определения исходных и целевых файлов используется .lingo/config.json. Изменения исходных файлов создают события source.*, а целевых — события target.*. Дата событий соответствует дате коммита. Коммиты слияния и переименования файлов не создают событий изменения ключей. При сборе текущей активности отправки самого приложения пропускаются, но импорт истории может включать его более ранние коммиты с переводами.
В подразделе Журналы раздела Радар выберите GitHub в поле Источник, затем отфильтруйте ленту по полю Репозиторий. Откройте событие и сопоставьте указанные в нём репозиторий, коммит, файл, локаль и ключ с фактическими изменениями в репозитории. Один коммит может создать много событий, поэтому число событий отражает количество изменённых ключей, а не релизов или коммитов.
Импорт Истории коммитов позволяет добавить более ранние события. В статье Как собирать активность GitHub описаны поддерживаемые форматы и охват истории.
Метрики ручных правок сравнивают черновой и целевой текст. События репозитория учитывают изменённые ключи. Без дополнительных данных ни уменьшение числа изменённых ключей, ни сокращение числа правок не доказывает, что переводы стали лучше или проверка занимает меньше времени.
Сравнивайте по одним и тем же правилам #
Когда возвращаетесь к результату, используйте те же фильтры, единицы измерения и полные временные интервалы. Сводки в обзоре и графики в разделе «Исследование» могут по-разному агрегировать данные. Поэтому сохраняйте формулу: не стоит считать, что во всех основных показателях коэффициенты рассчитываются одинаково.
Порядок обновления сводных данных не гарантирует, что вы сможете определить, на какой момент текущие данные полны. Если сравнение нужно будет повторить, сохраните дату получения данных вместе с результатом. В статье Как сохранить повторяемый анализ описано, какие сведения о расчёте и выборке нужно сохранить.