Als je app en team in aanmerking komen voor Premium Apps en je de Onboarding-stap hebt voltooid, je ben je klaar om SKU's toe te voegen en de winkelweergave van je app te maken. Als de teameigenaar de Onboarding-flow nog niet heeft voltooid, bekijk dan het artikel Voorbereiding voor Premium Apps voor richtlijnen. In dit artikel wordt besproken wat SKU's zijn, hoe je ze kunt beheren vanuit het Developer Portal en hoe je de winkelweergave van je app kunt samenstellen.
Inhoudsopgave
Wat is een SKU?
Een SKU, of stock-keeping unit, is een hulpmiddel dat gebruikt wordt bij het beheren van een inventaris. In de context van Premium Apps, kunnen premium functies worden gezien als “producten” die een app of activiteit aanbiedt. Aan de hand van de SKU's van je producten, kun je statistieken bijhouden en de producten beheren in de Developer Portal.
Soorten SKU's
Er zijn 4 soorten SKU's die je aan je Premium App kunt toevoegen:
Abonnementen:
Persoonlijk abonnement
- Een abonnement dat een gebruiker toelaat om premium functies van je app te ontgrendelen op alle servers waaraan de app toegevoegd is.
Servergebonden abonnement
- Een abonnement dat de eigenaar van een server toelaat om de premium functies van je app te ontgrendelen voor alle leden van die server.
Eenmalige aankopen (OTP's):
Niet-verbruikbare OTP's
- Een eenmalige aankoop die permanent is en niet opgebruikt kan worden, zoals levenslange toegang tot de premium functies van een app.
Verbruikbare OTP's
- Een eenmalige aankoop die opgebruikt kan worden, zoals een tijdelijke power-up of boost in een spel.
Nu je weet wat een SKU is en welke soorten er beschikbaar zijn, kun je aan de slag gaan met premium functies in de Developer Portal. Je app kan zoveel gepubliceerde Subscription SKU's en OTP SKU's bevatten als je wilt, met een limiet van 50.
SKU’s toevoegen
⚠️ Zoals verder beschreven in onze Monetization Terms, moet je je premium aanbod nauwkeurig en volledig beschrijven. Bovendien mogen de namen, beschrijvingen, icoontjes, en andere tekst of afbeeldingen die je premium SKU vertegenwoordigen geen schadelijke of kwetsende inhoud bevatten, in overeenstemming met ons beleid omtrent het verdienen van geld.
Onder het kopje "Monetization" in de Developer Portal kunnen de eigenaar en admins van het ontwikkelaarsteam SKU’s toevoegen en aanbieden op de winkelpagina van de app.
Je kunt de volgende gegevens over je SKU aanpassen:
- Een naam (max. 80 tekens)
- Een beschrijving (max. 160 tekens)
- Een applicatiepictogram
- Een banner
Je kunt ook een lijst van maximaal 6 voordelen personaliseren. Deze worden weergegeven in de Premium App Store weergave, de App Directory en tijdens de aankoop- en annuleringsflow om gebruikers de voordelen van je premium aanbod uit te leggen. Je kunt de volgende informatie opgeven:
- Een emoji, standaard of zelfgemaakt
- Een naam (max. 80 tekens)
- Een beschrijving (max. 160 tekens)
SKU's beheren
Als je SKU's beheert vanuit het portaal voor ontwikkelaars, kun je in eerste instantie SKU's aanmaken maar als ze eenmaal zijn aangemaakt, kun je ze ook publiceren, niet-openbaar maken en verwijderen. Hieronder staat een lijst met statussen waarin een SKU zich kan bevinden en de acties die je moet ondernemen als het eenmaal is aangemaakt:
STATUSSEN:
Niet gepubliceerd
Dit is de status die een SKU vanaf het begin heeft. "Unavailable" betekent dat de SKU niet gekocht kan worden.
Gepubliceerd
Deze status betekent dat een SKU gekocht kan worden.
Beschikbaar in de winkel
Er is een winkelpictogram naast de gepubliceerde apps die beschikbaar zijn in je winkel. Als er geen winkelpictogram is, maar je applicatie nog steeds in de status Gepubliceerd staat, is de SKU nog steeds toegankelijk via de API.
ACTIES:
SKU publiceren
Deze handeling verandert de status van een SKU naar "Available". Bij het publiceren van een SKU zal je 2 opties hebben. Beschikbaar via Store & API` is de keuze als je een winkel opzet. Alleen beschikbaar via API zal beter geschikt zijn voor activiteiten.
SKU niet meer publiceren
Deze handeling verandert de status van een SKU naar Unavailable. Houd er rekening mee dat wanneer je een SKU niet meer publiceert, dit de abonnementen niet direct annuleert, maar abonnementen worden niet verlengd als het einde van de factureringscyclus is bereikt terwijl de SKU niet beschikbaar is. Zodra de gewenste wijzigingen zijn aangebracht, zul je de SKU opnieuw willen publiceren om te voorkomen dat er een einde komt in de factureringscycli. Als je een SKU niet langer publiceert, wordt deze niet verwijderd.
Toevoegen aan winkel/Verwijderen uit winkel
Deze actie is alleen van toepassing op gepubliceerde SKU's. Hiermee kun je bepalen of je SKU in de winkel verschijnt of alleen toegankelijk is via de API.
SKU verwijderen
Met deze actie, die te vinden is op de pagina SKU bewerken, wordt een SKU uit de UI verwijderd, maar het wordt niet volledig verwijderd. Verwijderde SKU's verschijnen nog steeds in het eindpunt List Entitlements en Analytics. Als je een SKU verwijdert, lopen bestaande abonnementen door totdat hun factureringscyclus eindigt. Als je problemen ervaart bij het verwijderen van SKU's, neem dan contact op met onze helpdesk voor ontwikkelaars.
SKU bewerken
Als je de status van een SKU naar "Unavailable" verandert, kun je daarna een andere SKU aanbieden. Houd er rekening mee dat wanneer je een SKU niet meer publiceert, dit de abonnementen niet direct annuleert, maar abonnementen worden niet verlengd als het einde van de factureringscyclus is bereikt terwijl de SKU niet beschikbaar is. Zodra de gewenste wijzigingen zijn aangebracht, zul je de SKU opnieuw willen publiceren om te voorkomen dat er een einde komt in de factureringscycli.
Als je een SKU bewerkt om de prijs te wijzigen, houd er dan rekening mee dat dit alleen de prijs voor nieuwe abonnees verandert. Huidige abonnees blijven de prijs betalen waarvoor ze het SKU oorspronkelijk hebben gekocht.
Winkelpagina
De Premium App-winkelweergave is een functie gericht op het verbeteren van de Premium Apps-ervaring voor zowel ontwikkelaars als gebruikers. De winkelpagina is een nieuwe manier om premium functies aan te bieden via het profiel van je bot, in plaats van de Appgids.
Een winkelpagina toevoegen
Ontwikkelaars kunnen nu een winkelpagina toevoegen en bewerken in de Developer Portal, tijdens het beheren van SKU's. Om een winkelpagina aan te maken voor je Premium App, moet je deze stappen volgen:
- Maak een SKU aan
- Voeg een icoontje, banner en voordelen aan de SKU toe
- Integreer de SKU in je app
- Verander de status van de SKU naar "Available"
Je kunt nu icoontjes en banners aan een SKU toevoegen, om je producten en winkel levendiger te maken. Daarnaast zijn er handige knoppen om de status van je SKU's te veranderen en de informatie over je producten te bewerken. Om te controleren hoe de winkelpagina eruitziet voor gebruikers, kun je veranderingen vooraf bekijken en onmiddellijk aanbrengen.
Toegang tot de winkel
Gebruikers kunnen de winkelpagina openen via het profiel van de bot. Hier kunnen ze de beschikbare abonnementen en eenmalige aankopen zien, een abonnement selecteren om de voordelen te bekijken, en de gewenste producten rechtstreeks aankopen!
Deep linking
Zodra je SKU's en winkel zijn opgezet, kunnen ze gemakkelijker naar boven worden gebracht naar gebruikers met deep linking. Deep linking laat je toe om rechtstreeks naar de SKU te linken of op te slaan met behulp van onze App Directory Store URL scheme. Bezoek de Managing SKU's documentatie voor meer informatie over Koppelen aan een specifieke SKU of Koppelen aan je winkel.
SKU's integreren
Nadat je de SKU’s toegevoegd hebt, kun je ze beginnen te integreren in je app via de API. Je kunt hier meer te weten komen over het integreren van SKU's in je app. Nadat een SKU openbaar gemaakt en geïntegreerd is, wordt hij aangeboden op de winkelpagina van de app.
Statistieken
In het gedeelte Monetization van de Developer Portal vind je ook het kopje Analytics. Er zijn een paar dingen die je in overweging moet nemen wanneer je de statistieken over je Premium App bekijkt.
Beschikbaarheid
De beschikbare gegevens kunnen worden beschouwd als up-to-date gegevens vanaf 24 uur voor abonnementen en 30 dagen voor eenmalige aankopen. Elke weergave van abonnementsgegevens weerspiegelt die van de vorige dag voor abonnementsgegevens en de vorige maand voor eenmalige aankoopgegevens, gebaseerd op systeemupdates. Dit geldt voor zowel de gegevens over gebruikers, als de inkomstencijfers.
Nauwkeurigheid
Als na het bekijken van de analytics blijkt dat de gegevens onjuist zijn en de bovengenoemde tijdsperioden in acht zijn genomen, houd er dan rekening mee dat alleen abonnees worden weergegeven die Gebruik gegevens om Discord te verbeteren hebben ingeschakeld. De gegevens over gebruikers die deze optie uitgeschakeld hebben, worden niet meegeteld in de statistieken voor Premium Apps. Dit is enkel van toepassing op de gegevens over gebruikers, en niet op de inkomstencijfers. De inkomstencijfers (van 24 uur geleden) zijn altijd nauwkeurig.
⚠️ Als je geen statistieken ziet, kijk dan na of je wel een SKU geselecteerd hebt in het keuzemenu bovenaan Analytics.
Gegevens exporteren
Als je de statistieken van je Premium App wilt exporteren voor eigen gebruik, kun je ze onderaan de pagina Analytics in de vorm van een CSV-bestand downloaden.
Mocht je nog vragen hebben over de Premium Apps SKU-setup na het lezen van dit artikel en de hierboven gelinkte artikelen, neem dan zeker contact op met onze helpdesk voor ontwikkelaars!