In diesem Artikel erklären wir, wie du dich als potenzieller Technologie‑Partner im Developer‑Portal der Sport Alliance (SPA) registrierst, deine App in der Sandbox entwickelst, sie zur Freigabe einreichst und wie Studios die Integration anschließend im Appstore aktivieren. Außerdem erfährst du, wer wen kontaktiert und dass die finale Freigabe auf Seiten der Sport Alliance liegt.
Inhalt
- Einstieg & Rollenverständnis
- Zwei mögliche Startpunkte (Partner‑getrieben vs. Studio‑getrieben)
- Getting started: Registrierung & Sandbox
- Entwicklung in der Sandbox: Best Practices
- Einreichung: App zur Prüfung (Review)
- Pilotphase & Feedback‑Schleifen
- Go‑Live‑Gate: Ready for activation
- Veröffentlichung im SPA Brand Appstore
- Managing Activations: So aktivieren Studios deine App
- Optional: Eintrag im SPA Marketplace (Self‑Service)
- Pricing‑Tier‑Check (Sales/CS, Sport Alliance)
- Verträge außerhalb der SPA‑Prozesse („Independent of SPA“)
- Kommunikationsmatrix: Wer kontaktiert wen?
- Technische Checkliste für die Einreichung
- FAQ für Partner & Studios
- Prozessübersicht (Diagramm)
Fast lane
- Konto im Developer‑Portal anlegen → Nutzungsbedingungen akzeptieren
- Sandbox‑Zugang erhalten → API‑Keys & Berechtigungen (Scopes) konfigurieren
- App in der Sandbox entwickeln & intern testen
- App im Portal zur Prüfung einreichen („Submit App for approval“)
- (Optional) Erstgespräch mit Partner Manager (Sport Alliance), kommerzielle Punkte klären
- Pilotstudio starten → Feedback umsetzen
- Gemeinsame Freigabe: Ready for activation (Sport Alliance Product & PM + du)
- Eintrag im SPA Brand Appstore wird von Sport Alliance live geschaltet
- Studio klickt im Appstore „Jetzt aktivieren“ → System‑Trigger verbindet Studio & Partner
- Aktivierungen laufend im Portal managen (Status, Support, Deaktivieren/Reaktivieren)
Einstieg & Rollenverständnis
Damit du weißt, wer wann beteiligt ist:
- Du (Partner/Anbieter) – du entwickelst die Integration, lieferst App‑Infos, reagierst auf Feedback und betreust aktivierte Studios.
- Product & Product Manager (PM, Sport Alliance) – unsere internen Produktteams prüfen Qualität, Sicherheit und Produktpassung. Sie geben die finale Go‑Live‑Freigabe.
- Partner Manager (Sport Alliance, optional) – dein operativer/kaufmännischer Ansprechpartner, koordiniert Termine und Launch.
- Sales/Customer Success – Sales/CS (Sport Alliance) – prüft bei Studios das Pricing‑Tier und stößt ggf. ein Upgrade an.
- Studio/Kunde – aktiviert die Integration im Appstore selbstständig und nutzt sie im Tagesgeschäft.
Zwei mögliche Startpunkte (Partner‑getrieben vs. Studio‑getrieben)
Es gibt zwei übliche Einstiege – beide führen in denselben Standardprozess:
- Partner‑getrieben: Du willst deine Lösung in Magicline integrieren. Du registrierst dich im Developer‑Portal, entwickelst in der Sandbox und reichst die App zur Freigabe ein.
- Studio‑getrieben: Ein Studio fragt eine Integration mit deinem Produkt an. Du registrierst dich im Developer‑Portal und folgst dem gleichen Ablauf. Sales/CS (Sport Alliance) prüft beim Studio ggf. das Pricing‑Tier.
Getting started: Registrierung & Sandbox
Folge den Schritten aus „Getting started“ im Developer‑Portal:
- Registrierung: Lege dein Partner‑Konto an und akzeptiere die Nutzungsbedingungen.
- Sandbox‑Zugang: Du erhältst eine isolierte Testumgebung für Entwicklung und erste Funktionstests.
- API‑Keys & Scopes: Erzeuge Sandbox‑API‑Keys und definiere Berechtigungen (Scopes). Wähle nur, was du wirklich brauchst – das beschleunigt den Review.
- Dokumentation & Beispiel‑Workflows: Richte frühe Smoke‑Tests ein (Auth, Kern‑Datensatz, Rückkanal), damit du reproduzierbare Ergebnisse zeigen kannst.
Ergebnis dieses Schritts: Du kannst die Kernfunktion deiner Integration in der Sandbox ausführen und verlässlich reproduzieren.
Entwicklung in der Sandbox: Best Practices
- Nutze Testdaten & ein dediziertes Teststudio; keine Live‑Daten in der Sandbox.
- Implementiere sauberes Fehlerhandling, Timeouts und aussagekräftige Logs für den Pilottest.
- Halte Scopes minimal; erweitere sie bei echtem Bedarf.
- Erstelle parallel deinen App‑Steckbrief (Kurzbeschreibung, Nutzen, Zielgruppe, Screenshots/Logo, Support‑Kontakt) – er erscheint später im Appstore.
- Spiele den Aktivierungsweg bereits in der Sandbox durch, damit Studios später ohne Hilfe starten können.
Einreichung: App zur Prüfung (Review)
Wenn deine Integration stabil ist:
- Nutze „Submit App for approval“ im Developer‑Portal.
- Gib App‑Steckbrief, Logos/Screenshots, benötigte Scopes, Support‑Kontakt und technische Hinweise an.
- Nach der Einreichung kann ein Erstkontakt mit dem Sport Alliance Partner Manager stattfinden; optional werden kommerzielle Vereinbarungen getroffen.
Ziel des Reviews (durch Sport Alliance Product & PM): Funktionsumfang, Nutzerführung, Sicherheit, Stabilität und Verständlichkeit für Studios sicherstellen.
Pilotphase & Feedback‑Schleifen
Gemeinsam mit Product & PM (Sport Alliance) und einem Pilotstudio testest du realitätsnah:
- Setup, Berechtigungen und erster Datenaustausch
- Edge‑Cases, Fehlermeldungen und Rücksetzpfade
- Support‑Wege und Verantwortlichkeiten
Du setzt das Feedback um, bis keine Blocker mehr bestehen.
Go‑Live‑Gate: Ready for activation
Sind alle Kriterien erfüllt, markieren Sport Alliance Product & PM gemeinsam mit dir (Partner) die App als Ready for activation.
Die finale Entscheidung über die Freigabe liegt bei der Sport Alliance.
Veröffentlichung im SPA Brand Appstore
Nach der Freigabe wird der Eintrag im SPA Brand Appstore manuell von Sport Alliance live geschaltet. Deine App ist nun sichtbar – inklusive Beschreibung, Voraussetzungen und dem Button „Jetzt aktivieren“.
Managing Activations: So aktivieren Studios deine App
- Studio öffnet deinen Appstore‑Eintrag und klickt „Jetzt aktivieren“.
- Ein System‑Trigger verbindet Studio und Partner‑App (Autorisierung/Key‑Zuweisung je nach Scope).
- Du siehst die neue Aktivierung in deinem Developer‑Portal:
- Statusüberblick pro Studio (z. B. aktiv, ausstehend, deaktiviert)
- Details zur Aktivierung (Zeitpunkt, Studio‑ID, gewählte Optionen)
- Optionen wie Deaktivierung/Reaktivierung – sofern unterstützt
- Benachrichtigungen über neue oder fehlgeschlagene Aktivierungen
- Support: Prüfe bei Problemen zuerst Aktivierungsstatus & Scopes – viele Fälle lassen sich so sofort lösen.
Good practice: Richte interne Alerts ein, um neue Aktivierungen zu erkennen und proaktiv „Welcome Steps“ an Studios zu senden.
Optional: Eintrag im SPA Marketplace (Self‑Service)
Wenn verfügbar, kannst du zusätzlich im SPA Marketplace listen. Der Weg ist Self‑Service und führt ebenso in den Status Ready for activation. Die Aktivierung durch Studios bleibt identisch.
Pricing‑Tier‑Check (Sales/CS, Sport Alliance)
Bevor ein Studio alle Funktionen nutzt, prüft Sales/CS (Sport Alliance) das Pricing‑Tier. Ergebnis: weiter wie geplant oder Upgrade erforderlich. Der Check kann parallel zu deiner Freigabe erfolgen und verhindert Reibungen beim Rollout.
Verträge außerhalb der SPA‑Prozesse („Independent of SPA“)
Partnerschaftliche oder kommerzielle Vereinbarungen zwischen dir und dem Studio sind möglich und laufen unabhängig von SPA. Diese beeinflussen den technischen Review nicht, können aber Abrechnung oder SLA regeln.
Kommunikationsmatrix: Wer kontaktiert wen?
- Du ↔ Sport Alliance Product/PM: technische Fragen, Review‑Feedback, Go‑Live‑Freigabe.
- Du ↔ Sport Alliance Partner Manager: Appstore‑Positionierung, Launch‑Plan, kommerzielle Themen.
- Du ↔ Studio: Integration, Einrichtung in deinem System, laufender Support.
- Studio ↔ Sport Alliance Sales/CS: Fragen zu Pricing‑Tier bzw. Upgrades.
- Du → Studio (proaktiv): Onboarding‑Hinweise nach Aktivierung („So verbindest du Feature X“).
Technische Checkliste für die Einreichung
- Sandbox-App läuft stabil; Kern‑Use‑Cases sind nachvollziehbar.
- API‑Keys & Scopes korrekt gesetzt (Minimalprinzip).
- App‑Steckbrief vollständig: Kurzbeschreibung, Nutzen, Zielgruppe, Screenshots/Logo, Support-Kontakt.
- Fehlerbilder dokumentiert (z. B. Auth‑Fehler inkl. Nutzerhinweis).
- Pilotstudio erfolgreich getestet (offene Blocker = 0).
- Aktivierungsweg real getestet – inkl. Deaktivierung/Reaktivierung, falls vorgesehen.
FAQ für Partner & Studios
Wer erteilt die finale Freigabe?
Die Sport Alliance – konkret Product & PM – erteilt nach Review und Pilotphase die Freigabe Ready for activation.
Wie kommen Studios an die Integration?
Über den SPA Brand Appstore. Dort klicken sie auf „Jetzt aktivieren“ und der System‑Trigger verbindet Studio & App.
Muss ein Studio vorab etwas beachten?
Gelegentlich ist ein Pricing‑Tier‑Upgrade erforderlich (geprüft durch Sales/CS, Sport Alliance). Außerdem sollte das Studio deine Onboarding‑Hinweise befolgen.
Können Aktivierungen rückgängig gemacht werden?
Ja, sofern von deiner App unterstützt. Du verwaltest das in Managing Activations (Deaktivieren/Reaktivieren).
Brauche ich einen separaten Vertrag mit dem Studio?
Nur, wenn ihr das wünscht. Solche Vereinbarungen laufen unabhängig von SPA und regeln z. B. Abrechnung oder SLA.