Je branded app instellen: de configurator stap voor stap

In dit artikel lees je door welke stappen de Brand Configurator je leidt, wat je vooraf klaar moet hebben en wat er gebeurt nadat je je configuratie hebt ingediend.

Inhoud

• Voordat je begint
• Stappen 1 tot 4: branding
• Stappen 5 en 6: store-accounts en toegang
• Stap 7: API-Keys
• Stappen 8 tot 11: configuratie en indienen
• Nadat je hebt ingediend

Snelstart

1. Maak twee ontwikkelaarsaccounts aan, een voor het Apple Developer Program en een voor de Google Play Console. Beide moeten organisatieaccounts zijn, geen privéaccounts.
2. Nodig ons in beide accounts uit als beheerder: whitelabel@mysports.com voor Apple, android@mysports.com voor Google.
3. Zorg voor een domein waarvan je de DNS- en nameserver-instellingen zelf kunt wijzigen.
4. Houd zes waarden klaar voor stap 7: Apple Team ID, API-Key afzender-ID, API-Key-ID, het sleutelbestand voor API-Key, je Google Developer ID en de serviceaccountsleutel voor Google Service Account Privé Key.
5. Je hebt geen app nodig in je store-accounts. Die maken wij aan nadat je hebt ingediend.
6. Werk de configurator op volgorde door. Je kunt geen stap overslaan, en stap 7 wordt tijdens die stap direct bij Apple en Google gecontroleerd.

Voordat je begint

Rechten: Merkmanagement, in het rollenscherm op het tabblad App & portaal (Mysports) in de groep Merk configurator

Waar je de configurator vindt: MySports / Merkidentiteit / Brand configurator. Op diezelfde pagina zie je alle merkconfiguraties die je bent begonnen, met hun huidige status, en rechtsboven maak je een nieuwe aan.

De configurator heeft elf stappen en laat in de subtitel van het dialoogvenster zien waar je bent, bijvoorbeeld Stap 1 van 11. Je gaat stap voor stap vooruit en elke stap wordt gecontroleerd voordat je verder kunt, dus het is de moeite waard om alles klaar te hebben in plaats van te beginnen en weer te stoppen.

Wat aanwezig moet zijn voordat de configurator afgerond kan worden:

• Je onderneming mag geen eenmanszaak zijn.
• Het Branded Member Platform moet voor je account geactiveerd zijn.
• Een Apple Developer Program-account voor je onderneming. De aanmelding vraagt een D-U-N-S-nummer en wordt door Apple gecontroleerd, wat meerdere dagen kan duren.
• Een Google Play Console-account voor je onderneming, met eenmalige registratiekosten.
• Een domein, een hoofddomein of een subdomein, waarvan je de DNS- en nameserver-instellingen kunt configureren. Niet elke registrar staat dat toe. Wordt je domein via Wix beheerd, dan heb je een andere registrar of een extra domein nodig.

Beide store-accounts moeten organisatieaccounts zijn. Een privé ontwikkelaarsaccount kun je niet gebruiken, en een bestaand account later omzetten kan niet zonder de aanmelding opnieuw te doorlopen.

Zodra beide accounts bestaan, nodig je ons daarin uit als beheerder. Die toegang is wat ons later in staat stelt om je app in jouw naam te bouwen en te publiceren.

Twee artikelen leiden je door de aanmelding als je de accounts nog niet hebt: een App Store-account aanmaken en een Google Play Store-account aanmaken.

Stappen 1 tot 4: branding

Deze vier stappen bepalen hoe je app eruitziet en in welke talen de vermelding in de store wordt gemaakt. Niets daarvan hangt af van Apple of Google, dus je kunt ze direct invullen. De voorbeeldweergave rechts loopt mee terwijl je typt.

Stap 1, Naam & logo. De naam van je app, maximaal 30 tekens, en je logo.

• Het logo moet een SVG-bestand zijn en onder 512 KiB blijven.
• De twee beperkingen waarop een upload het vaakst stukloopt gaan niet over de grootte: de SVG mag geen <style>-element en geen ingesloten afbeelding bevatten. Bij export uit een designtool ontstaan die vaak allebei. Gebruik inline styling en een echt vectorbestand.
• Je kiest ook de achtergrondkleur waarop het logo wordt weergegeven, via de kleurkiezer of als HEX-waarde.

Stap 2, Login scherm. Een achtergrondafbeelding voor het inlogscherm. Je logo wordt automatisch uit stap 1 overgenomen.

• De afbeelding moet exact 1024 x 2048 pixels zijn. Dat wordt afgedwongen.
• Ook moet de afbeelding onder 512 KiB blijven. Een PNG in die resolutie gaat meestal over die grens, gebruik dus JPEG.

Stap 3, Slogan & Kleuren. Je slogan, maximaal 30 tekens, verschijnt in de app naast je logo, plus je primaire, secundaire en neutrale kleur. In de voorbeeldweergave bepaal je bovendien of de app een lichte of een donkere achtergrond heeft.

Stap 4, Taalinstellingen. De talen waarin je storevermelding wordt gemaakt. De configurator biedt dertien talen aan, die Duits, Engels, Nederlands, Frans en Italiaans in hun regionale varianten dekken. Spaans en Pools zitten er niet bij. Werk je internationaal, dan kun je hier meerdere talen kiezen en de storeteksten in de volgende stap voor elk van die talen voorbereiden.

Stappen 5 en 6: store-accounts en toegang

In stap 5, App store informatie, vul je de teksten in die op je storevermelding verschijnen. Drie velden met hun eigen grenzen:

• Ondertitel, maximaal 30 tekens. Je slogan uit stap 3 past hier goed.
• Keywords, maximaal 100 tekens. Zij bepalen of leden je app vinden wanneer ze in de stores zoeken.
• Lange beschrijving, maximaal 4000 tekens.

Emoji's zijn in alle drie de velden niet toegestaan en worden geweigerd.

In stap 6, App store instellen, bevestig je dat je ons in beide store-accounts hebt uitgenodigd. Je zet per store een vinkje, en elk vinkje noemt het adres dat je moet uitnodigen:

• Apple App Store: whitelabel@mysports.com, met de rol Admin
• Google Play Store: android@mysports.com, met de beheerdersrol

Verstuur beide uitnodigingen voordat je deze stap bereikt. Je bevestigt ze hier, maar de toegang moet bestaan om de latere stappen te laten werken. Uitgebreide instructies vind je in ons Help Center voor Apple en voor Google.

Stap 7: API-Keys

Op deze stap blijven de meeste configuraties steken, dus het is de moeite waard om te begrijpen wat er wordt gevraagd. Daarvoor heeft je Google Play-ontwikkelaarsaccount API-toegang nodig, wat betekent dat je een Google Cloud-project aanmaakt en daarvoor de Google Play Developer API activeert. Google documenteert beide in zijn introductiehandleiding, en wij beschrijven het aanmaken van de sleutels in detail voor Apple en voor Google.

Stap 7 verzamelt zes waarden, vier voor Apple en twee voor Google:

De twee Apple-aanduidingen staan op verschillende plekken, en dat is de meest voorkomende verwarring in deze stap. De API-Key afzender-ID staat in App Store Connect op de pagina Integrations, boven je sleutellijst:

De Apple Team ID staat helemaal niet in App Store Connect. Je vindt die in je Apple Developer-account onder Membership details:

App Store Connect en de Play Console verschijnen in de taal die voor je account is ingesteld. De labels op je scherm kunnen dus vertaald zijn, ook al staan ze hier in het Engels.

Drie dingen in deze stap zorgen regelmatig voor verwarring.

Je kiest hier geen app, en je hebt er ook geen nodig. De sleutels worden op accountniveau aangemaakt, niet per app, en de configurator vraagt nooit om een app. Je app wordt aangemaakt nadat je je configuratie hebt ingediend.

De sleutels worden direct gecontroleerd. Ga je verder, dan vragen wij bij Apple en Google na of de gegevens werken. Klopt er iets niet, dan zie je Api-Key validatie mislukt en kom je niet verder. De melding is bij elke oorzaak dezelfde, controleer dus alle zes waarden in plaats van aan te nemen dat er aan onze kant iets mist.

Voeg beide sleutelbestanden toe bij je eerste ronde door deze stap. Bewaar je de configuratie zonder die bestanden als ontwerp en kom je later terug, dan worden de uploadvelden niet meer aangeboden.

Apple staat alleen de accounteigenaar toe een API-sleutel aan te maken, en dezelfde sleutel kun je opnieuw gebruiken als je nog meer branded apps inricht. Bewaar de sleutel veilig en geef die uitsluitend via de configurator aan ons door, want de sleutel geeft beheerderstoegang tot je store-account.

Apple staat het downloaden van het sleutelbestand maar één keer toe en houdt geen kopie. Raak je het bestand kwijt, dan is de sleutel niet meer terug te halen: trek die in en maak een nieuwe aan, wat je een nieuwe API-Key-ID geeft om hier in te vullen. Ook de naam en het toegangsniveau van een sleutel kun je na het aanmaken niet meer wijzigen.

Stappen 8 tot 11: configuratie en indienen

Stap 8, Branded Website configuration. Zes velden, en twee daarvan hebben voorbereiding nodig.

Het veld Locatie code externe ID bepaalt bij welke studio je Branded Platform hoort. De lijst biedt alleen codes aan die bestaan en aan een studio zijn toegewezen, dus blijft die lijst leeg, dan ontbreekt de toewijzing en niet de code. Dit artikel legt uit hoe je er een aanmaakt.

Het domein is het adres waarop je Branded Website bereikbaar wordt. Je hebt toegang tot het DNS-beheer nodig om de nameservers te configureren, en je kiest tussen twee routes:

• Een subdomein van je bestaande website. Is je site studio.com, dan werken my.studio.com, your.studio.com en members.studio.com allemaal.
• Een nieuw hoofddomein, onafhankelijk van je huidige website, bijvoorbeeld mystudio.com. Dat domein moet nog vrij zijn, controleer dat dus voordat je het invult.

Wij valideren het domein automatisch. Wordt het geweigerd, dan zijn de meest voorkomende oorzaken een domein dat al bezet is of een subdomein dat niet verwijst naar iets dat wij kunnen configureren. Vul het domein in zonder protocol en zonder extra pad. DNS-records voor je Branded Member Web instellen legt uit welke records je daarna moet toevoegen.

De overige velden zijn een contact-e-mailadres, dat in de app stores en op je website wordt weergegeven, en een Telefoonnummer.

Stap 9, Testgebruiker. Je bevestigt dat er een locatiecode en een testaccount bestaan, zodat de beoordelaars van Apple en Google kunnen inloggen en je app in werking kunnen zien. Beide stores weigeren apps waarvan ze het inlogscherm niet voorbij komen, en juist daardoor wordt deze stap gemakkelijk onderschat.

Het testaccount wordt herkend aan e-mailadres, geboortedatum en locatiecode samen. Mislukt die controle, dan meldt de configurator dat er geen lid is gevonden onder de opgegeven locatiecode, wat meestal betekent dat de geboortedatum niet klopt en niet dat het account ontbreekt.

Gebruik precies deze waarden en maak de lead aan onder Leads / Overzicht met Lead aanmaken:

Het e-mailadres en de geboortedatum moeten exact overeenkomen, want het zijn twee van de drie waarden waarop de controle loopt. De twee namen worden niet gecontroleerd, maar houd ze toch aan. Ze zijn een conventie die het account herkenbaar maakt in de ledenlijst, zodat niemand het per ongeluk verwijdert en zodat wij het kunnen vinden wanneer wij je aanmelding bij de stores voorbereiden.

De locatiecode hiervoor heet Branded App. Een locatiecode en een testgebruiker voor de Branded App aanmaken loopt beide door, de code en het account, inclusief de adresgegevens.

Het testaccount mag nooit worden verwijderd en moet in een studio staan die in je Branded App verschijnt.

Stap 10, Juridische links. Je officiële bedrijfsnaam inclusief rechtsvorm, plus vier links: juridische informatie, privacybeleid, algemene voorwaarden en een supportpagina. Ze verschijnen in de voettekst van je Branded Website.

Alle vier de links worden automatisch gecontroleerd, en die controle opent de pagina's. Ze moeten zonder inloggen bereikbaar zijn en werkelijk het document zijn dat ze beweren te zijn. Een privacybeleid dat niet benoemt welke gegevens worden verzameld, met welk doel, hoe cookies en tools van derden worden gebruikt en welke rechten leden hebben, wordt afgekeurd. PDF-links worden geweigerd, gebruik dus een webpagina.

Stap 11, Bevestiging. Een samenvatting van alles wat je hebt ingevuld. Controleer die zorgvuldig, want deze instellingen kun je na het indienen niet meer wijzigen. Met het indienen hier begint het werk aan onze kant.

Nadat je hebt ingediend

Met het indienen eindigt jouw deel van de configuratie en begint het onze. Wij valideren je gegevens, sturen je DNS-records om toe te voegen, publiceren je Branded Website zodra die records oplossen, en bouwen daarna je app en sturen je testlinks voordat de app naar de stores gaat.

De voortgang volg je als status in het overzicht van de configurator: Ontwerp zolang je nog aan het werk bent, dan in uitvoering, dan Wachten op DNS-configuratie en ten slotte Beschikbaar met een link naar je website. Verandert de status in Contact Support, dan heeft iets onze aandacht nodig en hebben wij de naam van de configuratie van je nodig.

Totdat je indient, bestaat er in je Apple- of Google-account geen app. Dat is zo bedoeld, en het is de reden waarom er in stap 7 niets te selecteren valt.

Let op: Dit artikel is met behulp van AI gemaakt en automatisch vertaald zonder redactionele controle. Onze excuses voor eventuele fouten.