Branded App einrichten: der Konfigurator Schritt für Schritt

In diesem Artikel erfährst du, durch welche Schritte dich der Brand Configurator führt, was du vorher bereitlegen solltest und was nach dem Einreichen passiert.

Inhalt

• Bevor du anfängst
• Schritte 1 bis 4: Branding
• Schritte 5 und 6: Store-Konten und Zugriff
• Schritt 7: API Keys
• Schritte 8 bis 11: Konfiguration und Einreichen
• Nach dem Einreichen

Schnellanleitung

1. Lege zwei Entwicklerkonten an, eines für das Apple Developer Program, eines für die Google Play Console. Beide müssen Organisationskonten sein, keine privaten.
2. Lade uns in beiden Konten als Administrator ein: whitelabel@mysports.com für Apple, android@mysports.com für Google.
3. Sichere dir eine Domain, deren DNS- und Nameserver-Einstellungen du selbst ändern kannst.
4. Halte sechs Werte für Schritt 7 bereit: Apple Team ID, API-Schlüssel-Aussteller-ID, API-Schlüssel-ID, die Schlüsseldatei für API Key, deine Google Entwickler-ID und den Service-Account-Schlüssel für Google Service Account Private Key.
5. Du brauchst keine App in deinen Store-Konten. Die legen wir nach dem Einreichen an.
6. Arbeite den Konfigurator der Reihe nach durch. Du kannst keinen Schritt überspringen, und Schritt 7 wird direkt gegen Apple und Google geprüft.

Bevor du anfängst

Berechtigung: Brand verwalten, im Rollen-Bildschirm im Reiter Mitglieder-App & Web in der Gruppe Brand Configurator

Wo du den Konfigurator findest: MySports / Branded Member Platform / Brand Configurator. Auf derselben Seite siehst du alle Konfigurationen, die du begonnen hast, mit ihrem aktuellen Status, und oben rechts legst du eine neue an.

Der Konfigurator hat elf Schritte und zeigt deine Position im Untertitel des Dialogs an, zum Beispiel Schritt 1 von 11. Du gehst Schritt für Schritt vor, und jeder Schritt wird geprüft, bevor du weiterkommst. Es lohnt sich also, alles bereitzulegen, statt anzufangen und wieder aufzuhören.

Was vorhanden sein muss, damit der Konfigurator abgeschlossen werden kann:

• Die Rechtsform darf nicht Einzelunternehmen sein.
• Die Branded Member Platform muss für dein Konto aktiviert sein.
• Ein Apple Developer Program-Konto für dein Unternehmen. Die Anmeldung verlangt eine D-U-N-S-Nummer und wird von Apple geprüft, was mehrere Tage dauern kann.
• Ein Google Play Console-Konto für dein Unternehmen, mit einer einmaligen Registrierungsgebühr.
• Eine Domain, entweder eine Hauptdomain oder eine Subdomain, deren DNS- und Nameserver-Einstellungen du konfigurieren kannst. Nicht jeder Anbieter lässt das zu. Einige Domain-Provider unterstützen diese Konfiguration nicht, zum Beispiel Wix. Wenn deine aktuelle Domain über Wix verwaltet wird, brauchst du einen anderen Provider oder eine zusätzliche Domain.

Beide Store-Konten müssen Organisationskonten sein. Ein privates Entwicklerkonto lässt sich nicht verwenden, und ein bestehendes nachträglich umzustellen ist ohne erneute Anmeldung nicht möglich.

Sobald beide Konten existieren, lädst du uns als Administrator ein. Dieser Zugriff ist es, der uns später erlaubt, deine App in deinem Namen zu bauen und zu veröffentlichen.

Zwei Artikel führen dich durch die Anmeldung, falls du die Konten noch nicht hast: App-Store-Konto erstellen und Google-Play-Store-Konto erstellen.

Schritte 1 bis 4: Branding

Diese vier Schritte bestimmen, wie deine App aussieht und in welchen Sprachen ihr Store-Eintrag erscheint. Nichts davon hängt an Apple oder Google, du kannst sie also sofort ausfüllen. Die Vorschau rechts aktualisiert sich, während du tippst.

Schritt 1, Name & Logo. Der Name deiner App, bis zu 30 Zeichen, und dein Logo.

• Das Logo muss eine SVG-Datei sein und unter 512 KiB bleiben.
• Die zwei Einschränkungen, an denen ein Upload am häufigsten scheitert, haben nichts mit der Größe zu tun: die SVG darf kein <style>-Element und kein eingebettetes Bild enthalten. Beim Export aus einem Designtool entsteht häufig beides. Verwende Inline-Styling und eine echte Vektordatei.
• Außerdem wählst du die Hintergrundfarbe, auf der das Logo gerendert wird, über den Farbwähler oder als Hex-Wert.

Schritt 2, Login-Screen der App. Ein Hintergrundbild für den Login-Screen. Dein Logo wird automatisch aus Schritt 1 übernommen.

• Das Bild muss genau 1024 x 2048 Pixel groß sein. Das wird erzwungen.
• Es muss ebenfalls unter 512 KiB bleiben. Ein PNG in dieser Auflösung reißt die Grenze meistens, nimm also JPEG.

Schritt 3, Slogan & Farben. Dein Slogan, bis zu 30 Zeichen, erscheint in der App neben deinem Logo, dazu deine primäre, sekundäre und neutrale Farbe. In der Vorschau entscheidest du außerdem, ob die App einen hellen oder einen dunklen Hintergrund hat.

Schritt 4, Spracheinstellungen für die App Stores. Die Sprachen, in denen dein Store-Eintrag erstellt wird. Der Konfigurator bietet dreizehn an, die Deutsch, Englisch, Niederländisch, Französisch und Italienisch in ihren regionalen Varianten abdecken. Spanisch und Polnisch sind nicht dabei. Wenn du international tätig bist, kannst du hier mehrere Sprachen wählen und die Store-Texte im nächsten Schritt für jede davon vorbereiten.

Schritte 5 und 6: Store-Konten und Zugriff

In Schritt 5, Informationen zum App-Store, trägst du die Texte ein, die in deinem Store-Eintrag erscheinen. Drei Felder mit eigenen Grenzen:

• Untertitel, bis zu 30 Zeichen. Dein Slogan aus Schritt 3 passt hier gut.
• Schlüsselwörter, bis zu 100 Zeichen. Sie entscheiden, ob Mitglieder deine App finden, wenn sie in den Stores suchen.
• Beschreibung, bis zu 4000 Zeichen.

Emojis sind in allen drei Feldern nicht erlaubt und werden abgewiesen.

In Schritt 6, App-Store einrichten, bestätigst du, dass du uns in beide Store-Konten eingeladen hast. Du setzt ein Häkchen pro Store, und jedes nennt die Adresse, die eingeladen werden muss:

• Apple App Store: whitelabel@mysports.com, mit der Rolle Admin
• Google Play Store: android@mysports.com, mit der Administratorrolle

Schicke beide Einladungen ab, bevor du diesen Schritt erreichst. Du bestätigst sie hier, aber der Zugriff muss bestehen, damit die späteren Schritte funktionieren. Ausführliche Anleitungen findest du in unserem Help Center für Apple und für Google.

Schritt 7: API Keys

An diesem Schritt bleiben die meisten Konfigurationen hängen, es lohnt sich also zu verstehen, was er verlangt. Vorher braucht dein Google-Play-Entwicklerkonto einen API-Zugang, das heißt ein Google-Cloud-Projekt und die dafür aktivierte Google Play Developer API. Google dokumentiert beides in seinem Einstiegsleitfaden, und wir beschreiben die Schlüsselerstellung im Detail für Apple und für Google.

Schritt 7 sammelt sechs Werte, vier für Apple und zwei für Google:

Die beiden Apple-Kennungen wohnen an verschiedenen Stellen, und das ist die häufigste Verwechslung in diesem Schritt. Die API-Schlüssel-Aussteller-ID steht in App Store Connect auf der Seite Integrations, über deiner Schlüsselliste:

Die Apple Team ID steht überhaupt nicht in App Store Connect. Du findest sie in deinem Apple-Developer-Konto unter Membership details:

App Store Connect und die Play Console erscheinen in der Sprache, die in deinem Konto eingestellt ist. Die Bezeichnungen auf deinem Bildschirm können also übersetzt sein, obwohl sie hier englisch zitiert werden.

Drei Dinge an diesem Schritt führen regelmäßig zu Verwirrung.

Du wählst hier keine App aus, und du brauchst auch keine. Die Schlüssel werden auf Kontoebene erzeugt, nicht pro App, und der Konfigurator fragt nie nach einer App. Deine App entsteht, nachdem du deine Konfiguration eingereicht hast.

Die Schlüssel werden sofort geprüft. Wenn du weitergehst, fragen wir bei Apple und Google nach, ob die Zugangsdaten funktionieren. Stimmt etwas nicht, erscheint Api Key Validierung fehlgeschlagen und du kommst nicht weiter. Die Meldung ist bei jeder Ursache dieselbe, prüfe also alle sechs Werte, statt einen Fehler auf unserer Seite anzunehmen.

Hänge beide Schlüsseldateien beim ersten Durchlauf durch diesen Schritt an. Wenn du die Konfiguration ohne sie als Entwurf speicherst und später zurückkommst, werden die Upload-Felder nicht mehr angeboten.

Apple erlaubt nur dem Kontoinhaber, einen API-Schlüssel zu erzeugen, und derselbe Schlüssel lässt sich wiederverwenden, wenn du weitere Branded Apps einrichtest. Bewahre ihn sicher auf und gib ihn uns ausschließlich über den Konfigurator, denn er gewährt Administratorzugriff auf dein Store-Konto.

Apple erlaubt den Download der Schlüsseldatei nur einmal und behält keine Kopie. Wenn du sie verlierst, ist der Schlüssel nicht wiederherstellbar: widerrufe ihn und erzeuge einen neuen, was dir eine neue API-Schlüssel-ID für dieses Feld gibt. Name und Zugriffsebene eines Schlüssels lassen sich nach dem Erzeugen ebenfalls nicht mehr ändern.

Schritte 8 bis 11: Konfiguration und Einreichen

Schritt 8, Branded Website Konfiguration. Sechs Felder, zwei davon brauchen Vorbereitung.

Der Standort-Code bestimmt, zu welchem Studio deine Branded Platform gehört. Die Liste zeigt nur Codes, die existieren und einem Studio zugewiesen sind. Bleibt sie leer, fehlt also die Zuweisung und nicht der Code. Dieser Artikel erklärt, wie du einen anlegst.

Die Domain ist die Adresse, unter der deine Branded Website erreichbar sein wird. Du brauchst Zugriff auf ihre DNS-Verwaltung, um die Nameserver zu konfigurieren, und wählst zwischen zwei Wegen:

• Eine Subdomain deiner bestehenden Website. Wenn deine Seite studio.com ist, funktionieren my.studio.com, your.studio.com oder members.studio.com.
• Eine neue Hauptdomain, unabhängig von deiner aktuellen Website, zum Beispiel mystudio.com. Diese darf noch nicht vergeben sein, prüfe das also, bevor du sie einträgst.

Wir prüfen die Domain automatisch. Wird sie abgelehnt, sind die häufigsten Gründe eine bereits vergebene Domain oder eine Subdomain, die nicht auf etwas zeigt, das wir konfigurieren können. Trage die Domain ohne Protokoll und ohne zusätzlichen Pfad ein. DNS-Einträge für deine Branded Member Web einrichten erklärt, welche Einträge du danach hinzufügen musst.

Die übrigen Felder sind eine Kontakt-E-Mail-Adresse, die in den App Stores und auf deiner Website angezeigt wird, und eine Telefonnummer.

Schritt 9, Testuser. Du bestätigst, dass ein Standort-Code und ein Testzugang existieren, damit die Prüfer von Apple und Google sich anmelden und deine App im Betrieb sehen können. Beide Stores lehnen Apps ab, an deren Login sie nicht vorbeikommen, und genau deshalb wird dieser Schritt leicht unterschätzt.

Der Testzugang wird über E-Mail-Adresse, Geburtsdatum und Standort-Code gemeinsam erkannt. Schlägt der Abgleich fehl, meldet der Konfigurator, dass kein Mitglied unter dem angegebenen Standort-Code gefunden wurde, was meistens am Geburtsdatum liegt und nicht an einem fehlenden Zugang.

Verwende genau diese Werte und lege den Lead unter Interessenten / Übersicht über Lead erstellen an:

E-Mail-Adresse und Geburtsdatum müssen exakt übereinstimmen, denn sie sind zwei der drei Werte, über die der Abgleich läuft. Die beiden Namen werden nicht geprüft, behalte sie aber trotzdem. Sie sind eine Konvention, die den Zugang in der Mitgliederliste erkennbar macht, damit ihn niemand versehentlich löscht und damit wir ihn finden, wenn wir deine Store-Einreichung vorbereiten.

Der Standort-Code dafür heißt Branded App. Standort-Code erstellen und Testnutzer anlegen führt durch beides, den Code und den Zugang, samt Adressdaten.

Der Testzugang darf niemals gelöscht werden und muss in einem Studio liegen, das in deiner Branded App erscheint.

Schritt 10, Rechtliche Angaben. Dein offizieller Firmenname samt Rechtsform, dazu vier Links: Impressum, Datenschutzerklärung, AGB und eine Support-Seite. Sie erscheinen im Footer deiner Branded Website.

Alle vier Links werden automatisch geprüft, und die Prüfung ruft die Seiten auf. Sie müssen ohne Login erreichbar sein und tatsächlich das Dokument sein, das sie zu sein behaupten. Eine Datenschutzerklärung, die nicht benennt, welche Daten erhoben werden, zu welchem Zweck, wie Cookies und Werkzeuge von Dritten verwendet werden und welche Rechte Mitglieder haben, wird beanstandet. PDF-Links werden abgewiesen, verwende also eine Webseite.

Schritt 11, Bestätigung. Eine Zusammenfassung von allem, was du eingetragen hast. Prüfe sie gründlich, denn diese Einstellungen lassen sich nach dem Einreichen nicht mehr ändern. Mit dem Einreichen beginnt die Arbeit auf unserer Seite.

Nach dem Einreichen

Mit dem Einreichen endet dein Teil der Konfiguration und unserer beginnt. Wir prüfen deine Daten, schicken dir DNS-Einträge zum Hinterlegen, veröffentlichen deine Branded Website, sobald diese Einträge auflösen, und bauen danach deine App und schicken dir Testlinks, bevor sie in die Stores geht.

Den Fortschritt siehst du als Status in der Übersicht des Konfigurators: Entwurf, solange du noch arbeitest, dann in Bearbeitung, dann Warten auf DNS-Konfiguration und am Ende Verfügbar mit einem Link zu deiner Website. Steht dort die Aufforderung, den Support zu kontaktieren, braucht etwas unsere Aufmerksamkeit, und wir brauchen von dir den Namen der Konfiguration.

Bis du einreichst, existiert in deinem Apple- oder Google-Konto keine App. Das ist so gewollt, und es ist der Grund, warum es in Schritt 7 nichts auszuwählen gibt.

Hinweis: Dieser Artikel wurde mit Unterstützung von künstlicher Intelligenz erstellt und redaktionell geprüft.