翻訳の作業量
生成単語数、イベント数、トークン数、リポジトリの変更数を、記録されたローカライズ作業を表すそれぞれ異なる指標として読み解きます。
作業量レポートでは、記録されたローカライズ活動がどこで行われているかを確認できます。レーダー → 概要の生成単語数は、Lingo.devが今月生成した量を示します。探索のイベント数指標では、記録された活動を時系列や言語別、エンジン別、プロバイダー別に集計できます。
比較する前に、単位を選んでください。1件のリクエストに多くの単語が含まれることもあれば、言語やモデルによってトークン数が異なることもあります。また、リポジトリの1つのコミットで、複数のロケールにわたる多数のキーが変更される場合もあります。
生成単語数 #
翻訳量は、記録された翻訳リクエストのうち、成功したものの単語数とリクエスト数を合計したものです。元のデータは、組織、協定世界時の1時間単位、ローカライゼーションエンジン、ソースロケール、ターゲットロケールごとにグループ化されています。wordsまたはrequestsを合計してください。行数を数えると、リクエスト数ではなく、1時間ごとのグループ数を数えることになります。
概要タイルには今月の単語数が表示され、月初から現在までの値を前月の同じ日付範囲と比較できます。比較対象の月は、vs Oct 1 – 2のように明示されます。レポートには組織のタイムゾーンが使われますが、元の集計データは協定世界時の1時間単位です。そのため、任意の分を区切りとする集計や、時差が1時間刻みではないタイムゾーンでの正確な現地日付の区切りは、このデータから必ずしも再現できません。
集計対象は、記録された処理のうち成功したものです。失敗したリクエスト、欠落した記録、このデータソースに含まれない外部の翻訳は集計されません。同じリクエストの繰り返しやサンプルによって、重複を除いたコンテンツ量が増えなくても集計値が増える場合があります。また、日々の単語生成量は、完了した多言語ジョブ数や公開済みのテキスト量とは異なります。
翻訳量を読み取るPOST /v2/organizations/:orgId/analytics/translation-volumeを利用するには、組織のメンバーである必要があります。概要タイルやその他の分析データの読み取りでは、レポートの利用権限も確認されます。表示できない画面がある場合は、1つのレポートにアクセスできればすべてにアクセスできるとは考えず、機能へのアクセスとロールと権限を確認してください。
期間ごとの増加率を求めるには、区切りをそろえた完全な期間同士を比較し、次の式で計算します。
(current volume − previous volume) / previous volume前期の値がゼロの場合、この増加率は定義できません。代わりに、新たに観測された量を報告してください。急増の要因には、リリース、対象ロケールの拡大、作業の繰り返しなどが考えられます。急増したという事実だけでは、品質を判断できません。
イベント数 #
データでイベント数を選択すると、記録された各イベントを1件ずつ数えられます。
集計する前に、イベント種別で絞り込んでください。ローカライズの開始と完了は、それぞれ別のイベントです。単語数を確認するには、概要の生成単語数を使用してください。
イベントの内訳は、イベント種別、ターゲットロケール、ソースロケール、エンジン、プロバイダー別に確認できます。たとえば、探索 → 例のターゲットロケール別イベント数では、記録された作業が各言語にどのように分布しているかを確認できます。
トークンとコストの詳細な分析には、使用状況ページを使用してください。イベント数、単語数、トークン使用量は、それぞれ異なる作業単位を表します。
リポジトリの変更 #
接続したGitHubリポジトリでは、既定のブランチにある、対応形式のローカライズキーへの変更が記録されます。各コミット時点の.lingo/config.jsonを使い、ソースファイルとターゲットファイルを識別します。ソースファイルからはsource.*イベント、ターゲットファイルからはtarget.*イベントが生成され、コミットの日時が付与されます。マージコミットとファイル名の変更では、キー変更イベントは生成されません。リアルタイム収集ではアプリ自身によるプッシュを除外しますが、履歴のインポートでは、アプリによる過去の翻訳コミットが含まれる場合があります。
レーダー → ログでソース → GitHubを選択し、リポジトリでフィードを絞り込みます。イベントを開き、リポジトリ、コミット、ファイル、ロケール、キーを、実際のリポジトリの差分とあわせて確認してください。1つのコミットから多数のイベントが生成されることがあるため、イベント数はリリース数やコミット数ではなく、変更されたキーの数を表します。
コミット履歴をインポートすると、過去のイベントを追加できます。対応形式と履歴の対象範囲については、GitHubの活動を収集するで説明しています。
人による編集量の測定では、下書きとターゲットテキストを比較します。一方、リポジトリのイベントでは、変更されたキーを数えます。変更されたキーや編集量が減っても、それだけでは翻訳品質の向上やレビュー時間の短縮を示すことにはなりません。判断には、追加の根拠が必要です。
繰り返し比較する際も条件をそろえる #
結果を再確認する際は、同じフィルター、単位、欠けのない時間区分を使用してください。概要の集計と探索のグラフでは、集計方法が異なる場合があります。すべての主要指標が同じ方法で比率を計算しているとは考えず、計算式を保存してください。
集計データの更新動作だけでは、リアルタイムデータがどの時点まで反映されているかは保証されません。比較を繰り返す必要がある場合は、結果とあわせて取得日を保存してください。保持すべき計算内容と集計対象の記録については、定期的な分析を保存するで説明しています。