Abonnementpakete
Abonnementpakete ermoeglichen es Kunden, im Voraus fuer gebuendelte Fahrtvorteile ueber einen festgelegten Zeitraum zu zahlen. Diese Anleitung behandelt, wie Sie Abonnementplaene erstellen, konfigurieren und verwalten, die Ihren Fahrern wiederkehrenden Mehrwert bieten.
Ueberblick
Abonnementpakete sind vorausbezahlte Plaene, die Kunden Kontingente fuer Entsperrungen, Fahrtminuten, Pausenminuten und/oder Strecke ueber einen definierten Zeitraum gewaehren. Im Gegensatz zu einmaligen Fahrtpaketen koennen Abonnements optional automatisch verlaengert werden und bieten treuen Kunden fortlaufende Vorteile.
Hauptfunktionen
- Flexible Kontingente - Beinhalten Entsperrungen, Minuten, Pausenminuten und/oder Strecke
- Zwei Limit-Typen - Tageslimits (taegliche Zuruecksetzung) oder Gesamtlaufzeit-Limits (gesamt fuer Abonnementzeitraum)
- Auto-Verlaengerungs-Unterstuetzung - Optionale automatische Verlaengerung bei Abonnementablauf
- Standort-Einschraenkung - Pakete auf bestimmte Unterkonten (Standorte) beschraenken
- Fahrzeugtyp-Targeting - Vorteile auf bestimmte Fahrzeugmodelle begrenzen
- Internationalisierte Inhalte - Titel und Beschreibungen in mehreren Sprachen
- Anzeigereihenfolge - Anzeigereihenfolge in der mobilen App kontrollieren
Zugang zu Abonnementpaketen
Zur Preisgestaltung navigieren
Gehen Sie zum Dashboard und klicken Sie in der Seitennavigation auf Preisgestaltung.
Abonnements-Bereich finden
Scrollen Sie zum Bereich Abonnementpakete.
Pakete verwalten
Klicken Sie auf Paket hinzufuegen, um ein neues Abonnement zu erstellen, oder verwenden Sie Bearbeiten-/Loeschen-Symbole fuer bestehende.
Standortspezifisch
Abonnementpakete werden pro Standort verwaltet. Wechseln Sie zum entsprechenden Unterkonto, bevor Sie Pakete erstellen.
Paketkonfiguration
Basisinformationen
Titel (i18n)
Der Anzeigename fuer Kunden, mit Uebersetzungen fuer mehrere Sprachen.
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Englischer Titel | Paketname auf Englisch | "Weekly Unlimited" |
| Spanischer Titel | Paketname auf Spanisch | "Ilimitado Semanal" |
Best Practices:
- Titel kurz halten (2-4 Woerter)
- Hauptvorteil hervorheben
- Konsistente Benennung ueber Pakete hinweg
Beschreibung (i18n)
Optionale erweiterte Beschreibung der Paketvorteile.
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Englische Beschreibung | Vollstaendige Details auf Englisch | "Unlimited rides for 7 days" |
| Spanische Beschreibung | Vollstaendige Details auf Spanisch | "Viajes ilimitados por 7 dias" |
Schrittnummer
Kontrolliert die Anzeigereihenfolge in der mobilen App und im Dashboard.
| Wert | Anzeigeposition |
|---|---|
| 1 | Erste (oben) |
| 2 | Zweite |
| 3+ | Niedrigere Positionen |
Niedrigere Zahlen erscheinen zuerst. Verwenden Sie dies, um Ihre beliebtesten oder empfohlenen Pakete hervorzuheben.
Preisgestaltung
Preis (Cent)
Der Betrag, den Kunden fuer das Abonnement zahlen, in Cent gespeichert.
| Eingabe | Gespeicherter Wert | Anzeige |
|---|---|---|
| 999 | 999 Cent | 9,99 $ |
| 2499 | 2499 Cent | 24,99 $ |
| 4999 | 4999 Cent | 49,99 $ |
Gaengige Preispunkte:
- Wochenpass: 9,99 $ - 14,99 $
- Monatspass: 24,99 $ - 49,99 $
- Saisonpass: 99,99 $ - 149,99 $
Laufzeit
Laufzeit in Tagen
Wie lange das Abonnement nach dem Kauf aktiv bleibt.
| Tage | Entsprechung |
|---|---|
| 7 | 1 Woche |
| 14 | 2 Wochen |
| 30/31 | 1 Monat |
| 90/93 | 3 Monate |
| 365/366 | 1 Jahr |
Die mobile App formatiert diese automatisch in benutzerfreundliche Strings (z.B. "1 Woche", "1 Monat").
Limit-Typ
Waehlen Sie, wie Kontingente waehrend des Abonnementzeitraums verbraucht werden:
Tageslimit
Kontingente werden jeden Tag um Mitternacht zurueckgesetzt.
| Verhalten | Beispiel |
|---|---|
| Taegliche Zuruecksetzung | 60 Minuten/Tag × 30 Tage = 1.800 potenzielle Minuten |
| Pro-Tag-Obergrenze | Kunde kann taeglich bis zu 60 Minuten nutzen |
| Ungenutzt verfaellt | Tag 1 ungenutzte Minuten werden nicht zu Tag 2 uebertragen |
Am besten fuer:
- Pendlerpaesse (taegliche Nutzungsmuster)
- Fair-Use-Durchsetzung
- Vorhersehbare taegliche Vorteile
Gesamte Laufzeit
Kontingente sind ein Gesamtpool fuer den gesamten Abonnementzeitraum.
| Verhalten | Beispiel |
|---|---|
| Gesamtpool | 500 Minuten fuer den gesamten 30-Tage-Zeitraum |
| Flexible Nutzung | Kunde kann an einem Tag 100 Minuten nutzen, am naechsten 0 |
| Jederzeit nutzbar | Volle Flexibilitaet innerhalb des Zeitraums |
Am besten fuer:
- Gelegenheitsfahrer mit variablen Zeitplaenen
- Urlaubs-/Touristenpaesse
- Maximale Flexibilitaetsangebote
Auto-Verlaengerung
Aktivieren Sie automatische Verlaengerung bei Abonnementablauf.
| Einstellung | Verhalten |
|---|---|
| Aktiviert | Belastet Kunden automatisch und verlaengert Abonnement |
| Deaktiviert | Abonnement endet; Kunde muss manuell neu kaufen |
Hinweise zur Auto-Verlaengerung
Auto-Verlaengerung erfordert eine gespeicherte Zahlungsmethode. Kunden koennen die Auto-Verlaengerung jederzeit kuendigen. Fehlgeschlagene Verlaengerungen benachrichtigen den Kunden per Push-Benachrichtigung und E-Mail.
Enthaltene Kontingente
Konfigurieren Sie, welche Vorteile das Abonnement bietet. Lassen Sie Felder leer/null fuer nicht enthaltene Vorteile.
Enthaltene Entsperrungen
Anzahl der kostenlosen Entsperrungen im Abonnement enthalten.
| Wert | Verhalten |
|---|---|
| null | Entsperrgebuehr nicht abgedeckt |
| 1 | Eine Gratis-Entsperrung pro Zeitraum (oder pro Tag) |
| 10 | Zehn Gratis-Entsperrungen gesamt (oder pro Tag) |
| 999 | Im Wesentlichen unbegrenzte Entsperrungen |
Mit daily_limit: Entsperrungen werden taeglich zurueckgesetzt
Mit whole_duration: Entsperrungen sind ein Gesamtpool
Fahrtminuten
Enthaltene Minuten aktiver Fahrt.
| Wert | Verhalten |
|---|---|
| null | Keine Minutenabdeckung |
| 60 | 60 Minuten pro Zeitraum (oder pro Tag) |
| 300 | 300 Minuten gesamt (oder pro Tag) |
| 9999 | Im Wesentlichen unbegrenzt |
Pausenminuten
Enthaltene Minuten pausierter Zeit.
| Wert | Verhalten |
|---|---|
| null | Pausengebuehren werden normal berechnet |
| 30 | 30 Pausenminuten pro Zeitraum (oder pro Tag) |
| 120 | 120 Pausenminuten gesamt (oder pro Tag) |
Fahrtstrecke (KM)
Enthaltene Kilometer an Strecke.
| Wert | Verhalten |
|---|---|
| null | Strecke nicht abgedeckt |
| 50 | 50 km pro Zeitraum (oder pro Tag) |
| 500 | 500 km gesamt (oder pro Tag) |
Streckenpreise
Streckenkontingente gelten nur fuer Fahrzeuge mit Streckenpreisen. Wenn Ihre Fahrzeuge Minutenpreise verwenden, werden Streckenkontingente nicht verbraucht.
Einschraenkungsoptionen
Standort (Unterkonto)
Standardmaessig sind Pakete an das Unterkonto gebunden, wo sie erstellt wurden.
| Einstellung | Verhalten |
|---|---|
| Unterkonto-spezifisch | Paket nur an diesem Standort gueltig |
| Global (null) | Paket an jedem Standort gueltig |
Anwendungsfaelle:
- Stadtspezifische Paesse
- Campus-exklusive Abonnements
- Multi-Standort-Reisepaesse
Fahrzeugtypen
Beschraenken Sie das Abonnement auf bestimmte Fahrzeugmodelle.
| Einstellung | Verhalten |
|---|---|
| null | Gilt fuer alle Fahrzeugtypen |
| [e-bike-id] | Gilt nur fuer E-Bikes |
| [scooter-id, bike-id] | Gilt fuer Roller und Fahrraeder |
Anwendungsfaelle:
- E-Bike-Premium-Paesse
- Roller-exklusive Pendlerplaene
- Fahrzeugspezifische Aktionen
Aktivierungsstatus
Aktiviert
Kontrolliert, ob das Paket zum Kauf verfuegbar ist.
| Status | Verhalten |
|---|---|
| Nicht aktiviert (false) | Paket ist Entwurf; fuer Kunden nicht sichtbar |
| Aktiviert (true) | Paket ist live; Kunden koennen kaufen |
Unveraenderbar nach Aktivierung
Sobald ein Paket aktiviert ist, wird es unveraenderbar. Sie koennen ein aktiviertes Paket nicht bearbeiten - Sie muessen es deaktivieren und ein neues erstellen. Dies schuetzt bestehende Abonnements vor unerwarteten Aenderungen.
Erstellen eines Abonnementpakets
Schritt 1: Basisinformationen
- Schrittnummer - Anzeigereihenfolge festlegen (1 = erste)
- Titel - Titel in unterstuetzten Sprachen eingeben
- Beschreibung (Optional) - Erweiterte Beschreibung hinzufuegen
Schritt 2: Preise und Laufzeit
- Preis - Preis in Cent eingeben (z.B. 999 fuer 9,99 $)
- Laufzeit - Anzahl der Tage festlegen
- Limit-Typ -
daily_limitoderwhole_durationwaehlen - Auto-Verlaengerung - Falls gewuenscht aktivieren
Schritt 3: Kontingente
Konfigurieren Sie, was enthalten ist:
- Entsperrungen - Anzahl der Gratis-Entsperrungen
- Minuten - Enthaltene Fahrtminuten
- Pausenminuten - Enthaltene Pausenminuten
- Strecke - Enthaltene Strecke (km)
Lassen Sie Felder leer, wenn nicht enthalten.
Schritt 4: Targeting (Optional)
- Fahrzeugtypen - Bestimmte Fahrzeugmodelle auswaehlen oder fuer alle leer lassen
- Standort wird automatisch auf Ihr aktuelles Unterkonto gesetzt
Schritt 5: Als Entwurf speichern
Klicken Sie auf Erstellen, um zu speichern. Das Paket bleibt im Entwurf (nicht aktiviert), bis Sie bereit sind.
Schritt 6: Aktivieren
Wenn Sie bereit sind, live zu gehen:
- Alle Einstellungen sorgfaeltig ueberpruefen
- Aktiviert auf wahr schalten
- Klicken Sie auf Speichern
Vor Aktivierung ueberpruefen
Sie koennen aktivierte Pakete nicht bearbeiten. Ueberpruefen Sie alles vor der Aktivierung. Wenn Sie Aenderungen vornehmen muessen, muessen Sie deaktivieren und ein neues Paket erstellen.
Wie Abonnements angewendet werden
Waehrend der Abrechnung
Abonnements werden in Phase 3 der Abrechnungspipeline angewendet, nach Stufen-Vorteilen und vor Fahrtpaketen:
Basiskosten -> Stufen-Vorteile -> ABONNEMENT -> Pakete -> Dynamisch -> Aktion -> Endpreis
Verbrauchslogik
- Aktive Abonnements finden fuer den Kunden
- Nach Standort filtern - Unterkonto-spezifischer Abgleich zuerst, dann global
- Nach Startdatum sortieren - Aeltestes Abonnement wird zuerst verwendet
- Zuruecksetzung pruefen - Bei Tageslimits pruefen, ob Mitternacht vergangen ist
- Kontingente verbrauchen - Entsperrungen, Minuten, Pause, Strecke nach Bedarf abziehen
- Rabatt berechnen - Gesamtwert der verbrauchten Vorteile
- Tracking aktualisieren - Nutzung erfassen und verbleibende Kontingente aktualisieren
Tageslimit-Zuruecksetzung
Fuer daily_limit-Abonnements:
- System prueft
last_reset_at-Zeitstempel - Wenn ein neuer Tag begonnen hat, werden Kontingente auf volle Werte zurueckgesetzt
- Zuruecksetzung erfolgt bei erster Fahrt des neuen Tages
Nutzungsverfolgung
Jeder Abonnementkauf verfolgt:
remaining_minutes- Noch verfuegbare Minutenremaining_pause_minutes- Noch verfuegbare Pausenminutenremaining_distance_km- Noch verfuegbare Streckeremaining_unlocks- Noch verfuegbare Entsperrungenusage_events- Array der Nutzungseintraege pro Fahrttotal_value_applied_cents- Gesamter angewendeter Rabattwert
Abonnements verwalten
Pakete anzeigen
Die Paketliste zeigt:
| Spalte | Beschreibung |
|---|---|
| Schritt | Anzeigereihenfolge |
| Titel | Paketname |
| Preis | Kosten in Dollar |
| Laufzeit | Abonnementdauer |
| Limit-Typ | Taeglich oder gesamt |
| Auto-Verlaengerung | Aktiviert/deaktiviert |
| Status | Aktiviert oder Entwurf |
Pakete bearbeiten
Entwurfspakete (nicht aktiviert):
- Klicken Sie auf Bearbeiten-Symbol
- Beliebige Felder aendern
- Klicken Sie auf Speichern
Aktivierte Pakete:
- Koennen nicht bearbeitet werden
- Muessen zuerst deaktiviert werden
- Neues Paket mit gewuenschten Aenderungen erstellen
Pakete deaktivieren
Um neue Kaeufe zu stoppen:
- Klicken Sie auf Bearbeiten-Symbol
- Aktiviert auf falsch schalten
- Klicken Sie auf Speichern
Bestehende aktive Abonnements funktionieren weiterhin. Nur neue Kaeufe werden verhindert.
Pakete loeschen
- Klicken Sie auf Loeschen-Symbol
- Loeschung bestaetigen
Weiches Loeschen
Geloeschte Pakete werden weich geloescht (mit deleted_at markiert). Bestehende Kaeufe bleiben gueltig und funktionieren bis zum Ablauf.
Mobile-App-Integration
Paketanzeige
Die mobile App zeigt Abonnementpakete mit:
- Titel (lokalisiert)
- Beschreibung (lokalisiert)
- Preis (formatiert, z.B. "9,99 $")
- Laufzeit (formatiert, z.B. "1 Woche")
- Enthaltene Kontingente
- Standortanwendbarkeit
- Bereits-gekauft-Anzeige
Kaufablauf
Paket auswaehlen
Kunde waehlt ein Abonnementpaket aus den verfuegbaren Optionen.
Zahlung waehlen
Kunde waehlt Zahlungsmethode (Guthaben oder Karte).
Zahlung verarbeiten
System erstellt Stripe PaymentIntent (fuer Kartenzahlung) oder zieht vom Guthaben ab.
Kauf bestaetigen
Kunde bestaetigt Zahlungsdetails.
Abonnement aktivieren
subscription_package_purchases-Eintrag wird erstellt und Vorteile sind sofort verfuegbar.
Aktive Abonnements anzeigen
Kunden sehen ihre aktiven Abonnements mit:
- Paketname und Beschreibung
- Verbleibende Kontingente
- Ablaufdatum
- Nutzungsstatistiken
- Kuendigen/Verwalten-Optionen
Haeufige Szenarien
Szenario 1: Woechentlicher Pendlerpass
Ziel: Taeglicher Pendler mit vorhersehbarer Nutzung
Einrichtung:
- Titel: "Woechentlicher Pendler"
- Preis: 14,99 $ (1499 Cent)
- Laufzeit: 7 Tage
- Limit-Typ: daily_limit
- Enthaltene Entsperrungen: 2/Tag
- Fahrtminuten: 60/Tag
- Pausenminuten: 15/Tag
- Auto-Verlaengerung: Ja
Ergebnis: Kunde erhaelt taeglich 2 Gratis-Entsperrungen und 60 Minuten fuer eine Woche.
Szenario 2: Monatliche Flatrate
Ziel: Vielnutzer mit variablem Zeitplan
Einrichtung:
- Titel: "Monatliche Flatrate"
- Preis: 49,99 $ (4999 Cent)
- Laufzeit: 30 Tage
- Limit-Typ: whole_duration
- Enthaltene Entsperrungen: 100
- Fahrtminuten: 2000
- Pausenminuten: 500
- Auto-Verlaengerung: Ja
Ergebnis: Kunde erhaelt einen Pool von 2000 Minuten zur beliebigen Nutzung waehrend des Monats.
Szenario 3: Touristen-Tagespass
Ziel: Besucher erkunden fuer einen Tag
Einrichtung:
- Titel: "Explorer-Tagespass"
- Preis: 9,99 $ (999 Cent)
- Laufzeit: 1 Tag
- Limit-Typ: whole_duration
- Enthaltene Entsperrungen: 5
- Fahrtminuten: 120
- Pausenminuten: 60
- Auto-Verlaengerung: Nein
Ergebnis: Tourist erhaelt 2 Stunden Fahrt mit 5 Entsperrungen fuer einen einzelnen Tag.
Szenario 4: E-Bike Premium
Ziel: Nur Premium-E-Bike-Fahrer
Einrichtung:
- Titel: "E-Bike Elite"
- Preis: 29,99 $ (2999 Cent)
- Laufzeit: 30 Tage
- Limit-Typ: daily_limit
- Enthaltene Entsperrungen: 3/Tag
- Fahrtminuten: 90/Tag
- Fahrzeugtypen: [e-bike-modell-id]
- Auto-Verlaengerung: Ja
Ergebnis: Vorteile gelten nur beim Fahren von Premium-E-Bikes.
Best Practices
Paketdesign
- Gestufte Optionen anbieten - Budget, Standard und Premium
- Nutzungsmuster abgleichen - Pendler vs. Gelegenheitsfahrer
- Limit-Typen beruecksichtigen - Taeglich fuer Vielnutzer, Gesamtlaufzeit fuer Flexibilitaet
- Aussagekraeftige Schrittnummern verwenden - Empfohlene Pakete zuerst hervorheben
Preisstrategie
- Break-Even berechnen - Sicherstellen, dass Paketwert regulaere Preise bei Zielnutzung uebersteigt
- Ersparnis bieten - Abonnements klar besser machen als Einzelfahrt-Zahlung
- Preispunkte testen - A/B-Tests mit verschiedenen Preisen
- Auto-Verlaengerung erwaegen - Vorhersehbare Einnahmen vs. Kundenpraeferenzen
Aktivierung
- Gruendlich testen - In Staging-Umgebung vor Aktivierung verifizieren
- Aenderungen kommunizieren - Neue Pakete bei Kunden ankuendigen
- Unveraenderbarkeit planen - Nach Aktivierung koennen Einstellungen nicht geaendert werden
- Sorgfaeltig versionieren - Neue Pakete erstellen statt zu bearbeiten
Monitoring
- Kaeufe verfolgen - Abonnement-Adoptionsraten ueberwachen
- Nutzung analysieren - Verstehen, wie Kunden Kontingente nutzen
- Abwanderung beobachten - Kuendigungsmuster identifizieren
- LTV berechnen - Lebenszeitwert von Abonnementkunden
Technische Referenz
Datenbanktabelle: subscription_packages
| Spalte | Typ | Beschreibung |
|---|---|---|
id | UUID | Eindeutige Kennung |
subaccount_id | UUID | Standortbereich (null = global) |
step_number | Integer | Anzeigereihenfolge |
title_i18n | JSONB | Lokalisierte Titel {"en": "...", "es": "..."} |
description_i18n | JSONB | Lokalisierte Beschreibungen |
price_cents | Integer | Paketpreis in Cent |
duration_days | Integer | Abonnementlaufzeit |
limit_type | Enum | 'daily_limit' oder 'whole_duration' |
auto_renew | Boolean | Auto-Verlaengerung aktiviert |
activated | Boolean | Zum Kauf verfuegbar |
included_unlocks | Integer | Enthaltene Entsperrungen (null = nicht abgedeckt) |
ride_minutes | Integer | Enthaltene Minuten |
pause_minutes | Integer | Enthaltene Pausenminuten |
ride_distance_km | Integer | Enthaltene Strecke in km |
vehicle_types | Text[] | Zielfahrzeugmodelle |
deleted_at | Timestamp | Zeitstempel weiches Loeschen |
Datenbanktabelle: subscription_package_purchases
| Spalte | Typ | Beschreibung |
|---|---|---|
id | UUID | Eindeutige Kennung |
customer_uuid | UUID | Kundenreferenz |
package_id | UUID | Referenz zum Paket |
package_snapshot | JSONB | Kopie des Pakets zum Kaufzeitpunkt |
subaccount_id | UUID | Standort wo gekauft |
status | Text | 'active', 'expired', 'cancelled' |
limit_type | Text | 'daily_limit' oder 'whole_duration' |
started_at | Timestamp | Wann Abonnement begann |
expires_at | Timestamp | Wann Abonnement endet |
last_reset_at | Timestamp | Letzte taegliche Zuruecksetzungszeit |
remaining_minutes | Integer | Noch verfuegbare Minuten |
remaining_pause_minutes | Integer | Noch verfuegbare Pausenminuten |
remaining_distance_km | Decimal | Noch verfuegbare Strecke |
remaining_unlocks | Integer | Noch verfuegbare Entsperrungen |
usage_events | JSONB | Array der Nutzungseintraege |
total_value_applied_cents | Integer | Gesamter angewendeter Rabatt |
Fehlerbehebung
Paket erscheint nicht
- Aktiviert-Status pruefen - Muss aktiviert sein, um in mobiler App zu erscheinen
- deleted_at verifizieren - Sicherstellen, dass Paket nicht weich geloescht ist
- Unterkonto pruefen - Kunde koennte an anderem Standort sein
Vorteile werden nicht angewendet
- Abonnementstatus pruefen - Muss 'active' sein
- Ablauf verifizieren - Sicherstellen, dass Abonnement nicht abgelaufen ist
- Limit-Zuruecksetzung pruefen - Bei Tageslimits Zuruecksetzungslogik verifizieren
- Verbleibende Kontingente ueberpruefen - Koennen aufgebraucht sein
Paket kann nicht bearbeitet werden
- Aktiviert-Status pruefen - Aktivierte Pakete sind unveraenderbar
- Zuerst deaktivieren - Aktiviert auf falsch schalten
- Neues Paket erstellen - Mit gewuenschten Aenderungen
Tageslimits werden nicht zurueckgesetzt
- Zeitzone pruefen - Zuruecksetzung erfolgt um Mitternacht Serverzeitzone
- last_reset_at verifizieren - Sollte bei erster Fahrt des neuen Tages aktualisieren
- limit_type ueberpruefen - Muss 'daily_limit' sein, nicht 'whole_duration'
Auto-Verlaengerungs-Probleme
- Zahlungsmethode pruefen - Kunde braucht gespeicherte Zahlung
- auto_renew Flag verifizieren - Muss am Paket aktiviert sein
- Stripe-Logs ueberpruefen - Auf Zahlungsfehler pruefen
Abonnements konfiguriert
Mit eingerichteten Abonnementpaketen koennen Sie Ihren Fahrern wiederkehrenden Mehrwert bieten, Kundenbindung erhoehen und vorhersehbare wiederkehrende Einnahmen generieren. Ueberwachen Sie Abonnementmetriken, um Ihre Angebote zu optimieren.