När en kund prenumererar på en SaaS-tjänst eller Azure Application med en plan för hanterade appar, med förbrukningsfakturering, spårar du förbrukning för varje faktureringsdimension som används. Om förbrukningen överskrider det inkluderade antalet som angetts för den period som valts av kunden vare din tjänst användningshändelser till Microsoft.
För både SaaS-erbjudanden och hanterade appar
Hur ofta förväntas det generera användning?
Helst förväntas du generera användning varje timme under den senaste timmen, endast om det finns användning den senaste timmen.
Finns det en maximal period mellan en period och nästa?
Det finns ingen sådan begränsning. Generera endast användning när den inträffar. Om du till exempel bara behöver skicka en användningsenhet per prenumerationslivslängd kan du göra det.
Vilken är den maximala fördröjningen mellan den tidpunkt då en händelse inträffar och den tidpunkt då en användningshändelse genereras till Microsoft?
Vi rekommenderar att användningshändelsen genereras varje timme för händelser som inträffat under den senaste timmen. Fördröjningar förväntas dock. Den maximala fördröjning som tillåts är 24 timmar, och därefter accepteras inte användningshändelser. Det bästa sättet är att samla in användning per timme och generera som en händelse i slutet av timmen.
Om en användningshändelse exempelvis inträffar kl. 13:00 på en dag, har du fram till kl. 13:00 nästa dag på dig att generera en användningshändelse som är associerad med den här händelsen. Om det system som skickar användning är nere kan det återställas och sedan skicka användningshändelsen för det timintervall då användningen inträffade, utan att återgivningen går förlorad.
Om 24 timmar har passerat efter den faktiska användningen kan du fortfarande generera förbrukade enheter med senare användningshändelser. Den här praxis kan dock skada giltigheten för faktureringshändelserapporterna för slutanvändaren. Vi rekommenderar att du undviker att skicka mätare en gång per dag/vecka/månad. Det blir svårare att förstå den faktiska användningen av en kund och att lösa problem eller frågor som kan tas upp angående användningshändelser.
Ett annat skäl till att skicka användning varje timme är att undvika situationer där användaren avbryter prenumerationen innan utgivaren skickar den dagliga/veckovisa/månatliga händelsen.
Vad händer när du skickar fler än en användningshändelse under samma timme?
Endast en användningshändelse godkänns för entimmeintervallet. Timintervallet börjar vid minut 0 och slutar vid minut 59. Om fler än en användningshändelse genereras under samma timme tas alla efterföljande användningshändelser bort som dubbletter.
Vad händer när kunden avbryter köpet inom den tid som tillåts av annulleringsprincipen?
Det fasta beloppet debiteras inte, men överförbrukningsanvändningen kommer att debiteras.
Kan anpassade mätarplaner användas för en enda betalning?
Ja, du kan definiera en anpassad dimension som en enhet för en enda betalning och bara generera den en gång för varje kund.
Kan anpassade mätarplaner användas för en nivåindelad prismodell?
Ja, det kan implementeras med varje anpassad dimension som representerar en enda prisnivå.
Contoso vill till exempel debitera 0,5 USD per e-post för de första 1 000 e-postmeddelandena, 0,4 USD per e-post mellan 1 000 och 5 000 e-postmeddelanden och 0,2 USD per e-post för över 5 000 e-postmeddelanden. De kan definiera tre anpassade dimensioner som motsvarar de tre e-postprisnivåer. Generera enheter för den första dimensionen så länge antalet e-postmeddelanden är under 1 000, sedan enheter i den andra dimensionen när antalet e-postmeddelanden är mellan 1 000 och 5 000 och slutligen enheter i den tredje dimensionen för över 5 000 e-postmeddelanden.
Vad händer om Marketplace-avläsningstjänsten har ett avbrott?
Om ISV:n skickar en anpassad mätare och får ett fel som kan ha orsakats av ett problem på Microsoft-sidan (vanligtvis om liknande händelser accepterades tidigare utan fel) ska ISV:n vänta och försöka igen.
Om felet kvarstår skickar du den anpassade mätaren igen nästa timme (ackumulera antalet). Fortsätt den här processen tills ett svar utan fel tas emot.
Endast för SaaS-erbjudanden
Vad händer när du tecknar användning för en SaaS-prenumeration som redan har avslutats?
Användningshändelse som genereras till Marketplace-plattformen godkänns inte när en SaaS-prenumeration har tagits bort.
Användning kan bara genereras för prenumerationer med statusen Prenumerera (och inte för prenumerationer i PendingFulfillmentStart Suspended , eller Unsubscribed status).
Det enda undantaget är att rapportera användning för den tid som var innan SaaS-prenumerationen avbröts.
Kunden avbröt till exempel SaaS-prenumerationen idag kl. 15:00. Nu är det 17:00. Utgivaren kan fortfarande sända användning för perioden mellan 18:00 i går och kl. 15 i dag för den här SaaS-prenumerationen.
Kan du hämta en lista över alla SaaS-prenumerationer, inklusive aktiva prenumerationer och prenumerationer som har avslutat prenumerationen?
Ja, när du anropar API:et get subscriptions list eftersom det innehåller en lista över alla SaaS-prenumerationer. Statusfältet i svaret för varje SaaS-prenumeration visar om prenumerationen är aktiv eller har avslutats.
Är start- och slutdatumen för SaaS-prenumerationsperioden och överförbrukningsanvändningen anslutna?
Övertidshändelser kan genereras när som helst för en befintlig SaaS-prenumeration med statusen Prenumererar. Utgivaren ansvarar för att generera användningshändelser baserat på principen som definierats i faktureringsplanen. Överperioden måste beräknas baserat på de datum som definieras i SaaS-prenumerationens period.
Om utgivaren till exempel definierar en SaaS-plan som innehåller 1 000 e-postmeddelanden för 100 USD i månatligt fast pris debiteras varje e-post över 1 000 USD via anpassad dimension.
När kunden köper och aktiverar prenumerationen den 6 januari räknas de 1 000 e-postmeddelanden som ingår i det fasta priset med början den här dagen. Så om endast 900 e-postmeddelanden skickas fram till 5 februari (slutet av den första månaden i prenumerationen) betalar kunden det fasta priset endast för den första månaden i prenumerationen och inga överförbrukningshändelser genereras av utgivaren mellan 6 januari och 5 februari. Den 6 februari förnyas prenumerationen automatiskt och antalet börjar om igen. Om kunden den 15 februari når 1 000 skickade e-postmeddelanden debiteras resten av e-postmeddelandena fram till den 5 mars som överförbrukning (1 USD per e-post) baserat på de överförbrukningshändelser som genereras av utgivaren.
Nästa steg
- Mer information finns i API:er för Marketplace-avläsningstjänsten.