Wie Orbit-Produkte die Kennzahlen hinter einem Preis, etwa Distanz und Fahrzeit, auf Produktkarten und in den Order-Details in Orbit MissionControl anzeigen.
Fragen Sie Luna oder schreiben Sie unserem Support-Team.
Note
Produktmetriken zeigen die wichtigsten Kennzahlen hinter einem Preis, etwa die Distanz und die Fahrzeit, auf denen ein Angebot beruht. Sie erscheinen direkt auf Produktkarten und in den Order-Details in Orbit MissionControl.
Orbit-Produkte berechnen Preise aus Routen- und Zeitdaten. Bevor diese Werte in den Preis eingehen, passt ein Produkt sie oft an: Es rundet Werte, rechnet Meter in Kilometer um, schlägt Zuschläge auf oder richtet sich nach Preiszonen. Das Ergebnis sind Tarifwerte, etwa eine Tarifdistanz und eine Tariffahrzeit. Sie bestimmen den Endpreis, bleiben aber sonst für die Leser des Angebots unsichtbar.
Produktmetriken machen diese Werte sichtbar. Ein Produkt (Product) gibt die Werte, mit denen es einen Preis gebildet hat, als einheitliche Liste aus Bezeichnung und Wert aus. Operator sehen dann genau, worauf ein Preis beruht, und können das später prüfen. Sie müssen es nicht aus rohen Routendaten ableiten, die vielleicht nicht zu den berechneten Werten passen.
Das Wichtigste im Überblick:
Transparente Preise: Jede Metrik zeigt einen Wert, der den Preis geformt hat, etwa Tarifdistanz oder Fahrzeit. So ist die Grundlage eines Angebots auf einen Blick sichtbar.
Vom Produkt festgelegt: Ein Produkt entscheidet, welche Metriken es ausgibt. Distance und Duration sind standardmäßig dabei, und ein Produkt kann eigene hinzufügen, etwa Maut, Emissionen, Gewicht oder Anzahl der Stopps.
Bis zur Order mitgeführt: Metriken werden auf dem Angebot (Offer) und auf der daraus entstehenden Order gespeichert. So bleiben die Werte hinter einem Preis lange nach der Buchung verfügbar.
Übersetzte Bezeichnungen: Jede Metrik hat eine übersetzte Bezeichnung und erscheint in der Sprache des Lesers.
Über die API verfügbar: Metriken erscheinen in den Antworten zu Angeboten und Orders und können mitgegeben werden, wenn eine Order über die Orbit-API angelegt wird.
Eine Metrik ist ein einfaches Paar: eine Bezeichnung und ein Wert. Die Bezeichnung ist übersetzt, jeder Leser sieht sie also in seiner Sprache. Der Wert ist freier Text. So kann ein Produkt ihn so formatieren, wie er am besten lesbar ist: 420 km, 6h 30m, €42.00 oder 3 stops.
Metriken beschreiben nur. Sie halten die Werte fest, auf denen ein Preis aufgebaut wurde, ändern den Preis aber nicht selbst. Den Preis bestimmen immer die Positionen des Produkts.
Wer ein Produkt baut, entscheidet, welche Metriken es ausgibt. Metriken entstehen in den ProductBricks eines Produkts, den kleinen Funktionen, aus denen ein Produkt besteht. Jeder Brick kann Metriken beitragen, ob er Kontext, Machbarkeit, Preis oder Terminierung behandelt. Ein Wert kann also von dort kommen, wo er berechnet wird.
Ein Brick gibt Metriken aus, indem er sie innerhalb seines Ergebnisobjekts zurückgibt, neben dem, was der Brick ohnehin zurückgibt. Diesen Schritt übersieht man leicht: Eine metrics-Liste außerhalb des zurückgegebenen Objekts wird ohne Meldung verworfen. Wie das Objekt aussieht, hängt vom Brick ab.
Feasibility- und Context-Bricks geben bereits ein Objekt zurück. Sie nehmen einfach ein Feld metrics neben ihre anderen Felder auf.
Jeder Eintrag hat einen title und einen value. Der title ist ein übersetztes Objekt mit einem Wert pro Sprache (en, de). Der value ist immer ein String mit Einheit: "420 km", nicht 420. Es gibt kein eigenes Feld für Einheit oder Format. Deshalb kann ein Produkt jeden Wert so formatieren, wie er am besten lesbar ist.
Orbit sammelt die Metriken aller Bricks des Produkts und fasst sie zu einer Liste zusammen. Geben zwei Bricks eine Metrik mit derselben Bezeichnung aus, gilt der Brick, der später läuft. So kann ein späterer Schritt einen früher berechneten Wert verfeinern.
Die Standard-Pricing-Bricks geben Distance und Duration ohne jede Konfiguration aus. Ein Brick, der nur seine Positionen (oder nur seinen Zeitplan) zurückgibt, funktioniert unverändert weiter und gibt einfach keine zusätzlichen Metriken aus. Wechseln Sie nur dann zur oben gezeigten Objektform, wenn Sie Metriken hinzufügen wollen. Das ist ganz freiwillig.
Bevor Sie eine neue Version veröffentlichen, können Sie in Orbit MissionControl in der Testansicht eines Bricks eine Vorschau seiner Metriken sehen. Mehr zum Prüfen der Ausgabe eines Produkts finden Sie unter Produkte testen.
Ein Logistik-Operator bei Orion Industries in Paris bereitet eine Zustellung am selben Tag an ACME Ltd in Lyon vor. In Orbit MissionControl öffnet er den TransportComposer und wählt ein Kurier-Produkt. Die Produktkarte zeigt ein Tachometer-Symbol. Fährt er mit der Maus darüber, sieht er Distance 465 km und Duration 4h 40m. Das sind die Tarifwerte, auf denen das Angebot beruht, bereits von der rohen Route an die Art angepasst, wie dieses Produkt Distanz und Zeit bepreist. Der Operator ist sicher, dass der Preis der echten Fahrt entspricht, und bucht den Transport. Sieht sich eine Kollegin später die entstandene Order an, erscheinen dieselben Werte Distance und Duration im Abschnitt „Preis“. Die Grundlage des Preises ist damit klar, ohne dass jemand eine Berechnung neu starten muss.
Produktmetriken sind Teil der öffentlichen Orbit-API. Eine Integration kann sie also lesen und mitgeben, nicht nur in Orbit MissionControl ansehen:
Jedes Angebot in der Antwort mit den Angeboten enthält eine metrics-Liste, und jede Order enthält die Metriken, mit denen sie angelegt wurde.
Wenn Sie eine Order über die API anlegen, können Sie eine metrics-Liste mitgeben, um die Werte hinter einem Preis festzuhalten, den Ihr eigenes System berechnet hat.
Jede Metrik besteht aus einem übersetzten title und einem value als String. Das vollständige Schema finden Sie in der Orbit API Reference.
Kann ich wählen, welche Metriken ein Produkt zeigt?
Ja. Ein Produkt gibt die Metriken aus, die seine Bricks erzeugen. Bearbeiten Sie den Pricing-Brick des Produkts so, dass er die gewünschten Metriken zurückgibt. Distance und Duration werden standardmäßig ausgegeben.
Ändern Metriken den Preis?
Nein. Metriken dienen nur der Information. Den Preis bestimmen immer die Positionen des Produkts. Metriken dokumentieren nur die Werte dahinter.
Lassen sich die Bezeichnungen von Metriken übersetzen?
Ja. Jede Bezeichnung ist übersetzt und erscheint in der Sprache des Lesers.
Was passiert, wenn eine Order keine Metriken hat?
Der Abschnitt „Preis“ lässt sie weg. Ein Produkt, das keine Metriken ausgibt, oder eine Order, die ohne Metriken angelegt wurde, zeigt keine Metrik-Zeilen und verhält sich ganz normal.
Gibt es das auch in Orbit Hub, Orbit Connect oder Orbit Cockpit?
Metriken erscheinen in Orbit MissionControl: auf den Produktkarten im TransportComposer und im Abschnitt „Preis“ einer Order. Die anderen Orbit-Apps zeigen sie nicht an.
Kann ich über die API auf Metriken zugreifen?
Ja. Metriken erscheinen in den Antworten zu Angeboten und Orders und können beim Anlegen einer Order mitgegeben werden. Details finden Sie in der Orbit API Reference.
