Crowdin als Messquelle
Erfasse Übersetzungsaktivitäten aus Crowdin in Radar und untersuche mit definierten Messungen die Texte und den Bearbeitungsprozess.
Erstelle Übersetzungen weiterhin in Crowdin und führe dort die Prüfung durch, während du mit Lingo.dev ihre Qualität untersuchst. Die Crowdin-Verbindung empfängt unterstützte Ereignisse auf Zeichenfolgenebene und stellt deren Texte als Datengrundlage für Messungen in Radar bereit. Deine Übersetzungen und dein Veröffentlichungs-Workflow bleiben in Crowdin.
Öffne in der Navigation von Studio 2.5 Studio 2.5 → Integrationen statt Einstellungen → Integrationen. Bestehende Verbindungs- und Einrichtungslinks funktionieren weiterhin.
Eine Änderung am Ausgangstext, ein neuer Vorschlag, eine Freigabe und eine Aktualisierung des exportierten Zieltexts stehen für unterschiedliche Arbeitsschritte. Die Verbindung bewahrt diese Unterschiede, damit jede Messung genau den Text oder die Änderung untersuchen kann, den oder die sie benötigt. Sie erzeugt keine Übersetzungen und sendet keine korrigierten Formulierungen an Crowdin zurück.
Quelle verbinden #
- Öffne in der gewünschten Lingo.dev-Organisation Einstellungen → Integrationen und wähle bei Crowdin Verbinden. Wenn diese Option nicht verfügbar ist, sieh nach, ob die Organisation Zugriff auf die Funktion hat.
- Gib einen Namen für die Verbindung ein. Lass Enterprise-Domain bei crowdin.com leer. Gib für Crowdin Enterprise den Teil vor
.crowdin.comein, zum Beispielacme, und wähle anschließend Verbinden. - Kopiere die bereitgestellte Webhook-URL. Öffne in jedem Crowdin-Projekt, das du messen möchtest, Werkzeuge → Webhooks und füge einen Webhook mit dieser URL, der Methode POST und JSON-Nutzdaten hinzu. Wähle die unten aufgeführten unterstützten Zeichenfolgenereignisse aus.
Behandle die Webhook-URL wie Zugangsdaten: Der Empfänger verwendet das darin enthaltene Geheimnis, um eingehende Ereignisse zu autorisieren. Gib die URL nicht in Tickets oder Repository-Dateien weiter. Eine Verbindung auf Organisationsebene kann Ereignisse aus mehreren Projekten empfangen; jedes Ereignis enthält seine Projektkennung. Halte fest, welche Projekte du konfiguriert hast, damit du später weißt, was ein Bericht abdeckt.
Benötigte Zeichenfolgenereignisse auswählen #
Abonniere in Crowdin die unterstützten Ereignisse auf Zeichenfolgenebene:
| Crowdin-Ereignisse | Bereitgestellte Datengrundlage |
|---|---|
string.added, string.updated, string.deleted | Aktivitäten an Ausgangszeichenfolgen. |
suggestion.added, suggestion.updated, suggestion.deleted | Aktivitäten an Übersetzungsvorschlägen. |
suggestion.approved, suggestion.disapproved | Aktionen zur Prüfung eines Vorschlags. |
translation.updated | Die Änderung vom alten zum neuen exportierten Zieltext. |
Bei einer exportierten Übersetzung zeigen ein leerer alter Wert und ein vorhandener neuer Wert eine Erstellung an. Zwei vorhandene Werte stehen für eine Aktualisierung; ein vorhandener alter Wert und ein leerer neuer Wert für eine Löschung. Die Freigabe eines Vorschlags ist ein eigenständiges Ereignis, getrennt von einer Änderung am exportierten Zieltext.
Ereignisse auf Dateiebene wie file.approved und file.translated liefern über diesen Adapter keine Datengrundlage auf Zeichenfolgenebene. Nicht unterstützte Ereignistypen und Ereignisse ohne Projekt- oder Zeichenfolgenkennung können übersprungen werden. Verwende für die erste Verifizierung ein unterstütztes Zeichenfolgenereignis: Eine erfolgreiche Webhook-Zustellung allein ist noch kein Nachweis für eine nutzbare Datengrundlage.
Eine Übersetzungsänderung bis zur Messung verfolgen #
Verwende für diesen ersten Test die integrierte Messung Editierdistanz. Sie wird bei der Erstellung und Aktualisierung von Zieltexten ausgeführt und vergleicht den neuen Zieltext mit der vorherigen Übersetzung der Zeichenfolge. Aktiviere die Messung in Radar, bevor du die Testaktivität auslöst.
- Wähle ein bekanntes Projekt, eine Zeichenfolge und eine Zielsprache aus, für die bereits eine Übersetzung vorliegt. Halte diese Übersetzung und den Text fest, den du freigeben wirst.
- Gib einen bearbeiteten Vorschlag über den üblichen Prüfungs-Workflow von Crowdin frei und sieh dir die Zustellung von
translation.updatedan den konfigurierten Webhook an. - Suche das entsprechende Zieltextereignis in Lingo.dev. Vergleiche dessen Projekt, lesbaren Schlüssel, Sprache und Zieltext mit dem festgehaltenen Textpaar. Wenn die von der Messung verwendete vorherige Übersetzung nicht die gewünschte Vergleichsgrundlage ist, sieh dir die früheren Ereignisse der Zeichenfolge an, bevor du die Distanz interpretierst.
- Öffne das Ergebnis der Editierdistanz. Kontrolliere die Definition und die verglichenen Texte und vergewissere dich, dass die numerische Antwort vollständig vorliegt. Die Referenz zu integrierten Messungen erläutert den Nenner und die Einschränkungen der verwendeten Zeicheneinheiten.
Dieser Test verknüpft eine Aktion beim Anbieter mit der Antwort, die du später interpretieren wirst. Für die erste Übersetzung einer Zeichenfolge gibt es keine frühere Version, daher liefert die Editierdistanz dafür die Antwort 0. Die Freigabe selbst wird als suggestion.approved erfasst und löst keine der Bearbeitungsmessungen aus. Die integrierten Glossar- und Regelkontrollen verarbeiten Ereignisse abgeschlossener Lokalisierungen, keine Crowdin-Bearbeitungen oder -Freigaben. Um einen anderen Ereignistyp zu messen, konfiguriere eine benutzerdefinierte Messung für genau dieses Ereignis und die dafür verfügbare Datengrundlage; integrierte Auslöser lassen sich nicht neu zuordnen.
Zeitstempel und Identitäten von Ereignissen helfen, einen Datensatz seiner Quelle zuzuordnen. Ihre Bedeutung hängt jedoch von der jeweiligen Aktivität ab. Übersetzungs- und Vorschlagsereignisse, einschließlich Freigaben, verwenden den Wert createdAt der Übersetzung; eine heute eingegangene Freigabe kann daher unter einem älteren Erstellungsdatum erscheinen. Anhand des Empfangszeitpunkts lassen sich wiederholte Ablehnungen desselben Vorschlags unterscheiden. Er dient außerdem als Ersatz für fehlende oder ungültige Zeitstempel; eine Freigabe wird einmal pro Vorschlag erfasst. Beachte den erfassten Wert eventAt, wenn du Ereignisse filterst oder einen historischen Messzeitraum auswählst. Bei einer späteren Textextraktion lässt sich ohne Zeitstempel nicht jedes Ereignis zuverlässig erneut zuordnen. Auch fehlende Angaben zur Urheberschaft rechtfertigen es nicht, ein Ereignis ohne Belege einem Menschen oder einem Modell zuzuordnen.
Ergebnisse im Kontext ihrer Abdeckung lesen #
Webhooks erfassen konfigurierte Aktivitäten ab dem Zeitpunkt ihrer Zustellung. Sie bilden nicht alle früheren Übersetzungen, Überarbeitungen des Ausgangstexts oder die gesamte Projekthistorie ab. Fehlender Text in den Nutzdaten, nicht unterstützte Ereignisse und nicht konfigurierte Projekte können die für Messungen verfügbare Datengrundlage einschränken. Wiederholte Zustellungen von Prüfungsereignissen können separate Datensätze erzeugen. Die Anzahl der Ereignisse entspricht daher nicht unbedingt der Anzahl der unterschiedlichen Übersetzungen, für die eine Prüfung durchgeführt wurde.
Trenne Datensätze, auf die ein Kriterium nicht anwendbar ist, von solchen, auf die es anwendbar ist, denen aber der erforderliche Text fehlt. Unterscheide bei Auswertungen zwischen abgeschlossenen Antworten, abgeschlossenen Antworten mit unbestimmtem Ergebnis und Vorgängen ohne abgeschlossene Antwort. Eine Antwort mit unbestimmtem Ergebnis dokumentiert eine abgeschlossene Auswertung, lässt aber weder auf ein Bestehen noch auf ein Nichtbestehen schließen.
Verwende bei der Angabe einer Bestehensquote Antworten mit eindeutigem Ergebnis als Nenner und gib an, welcher Anteil der dafür infrage kommenden Inhalte eine solche Antwort erhalten hat. Eine fehlende Auswertung belegt keine schlechte Übersetzungsqualität. Eine Crowdin-Freigabe beschreibt den Prüfungsprozess des jeweiligen Projekts, ist aber kein unabhängiger Nachweis für semantische Korrektheit. Eine Messung der Übersetzungsqualität entwerfen erläutert die Berechnung und Interpretation im Detail.
Zustellung wiederherstellen oder Quelle außer Betrieb nehmen #
Wenn keine neuen Messdaten mehr erscheinen, kontrolliere die Webhook-Abonnements des Projekts, den Ereignistyp, Zustellungsfehler und die Ziel-URL. Stelle sicher, dass der Webhook POST-Anfragen mit JSON an die aktuelle Webhook-URL der Verbindung sendet. Die Verbindung lädt verpasste Ereignisse nicht automatisch nach. Um bereits in Lingo.dev erfasste Ereignisse auszuwerten, verwende den Workflow für historische Messungen.
Wenn die Webhook-URL offengelegt wurde oder ersetzt werden muss, öffne die Verbindung unter Einstellungen → Integrationen, wähle Erneuern und bestätige mit URL erneuern. Die alte URL funktioniert ab diesem Moment nicht mehr. Kopiere die neue URL in jedes konfigurierte Crowdin-Projekt und vergewissere dich anschließend, dass ein unterstütztes Ereignis zugestellt wird und seine Datengrundlage in Radar erscheint.
Wenn du die Verbindung trennst, werden darüber keine neuen Messdaten mehr erfasst; bereits erfasste Messungen bleiben erhalten. Entferne die Webhooks der Crowdin-Projekte separat. Crowdin-Übersetzungen und Aktionen zur Prüfung bleiben unverändert. Berücksichtige bei Berichten, deren Zeitraum eine Trennung umfasst, die Lücke in der Datenerfassung, statt sie als Zeitraum ohne Übersetzungsarbeit zu interpretieren.