När en kund prenumererar på en SaaS-tjänst, Ett Azure-program med en Managed Apps-plan eller ett Kubernetes-apperbjudande med fakturering med dataförbrukning spårar du förbrukningen för varje faktureringsdimension som används. Om förbrukningen överskrider de inkluderade kvantiteter som angetts för den term som kunden har valt genererar tjänsten användningshändelser till Microsoft.
För SaaS-erbjudanden, hanterade appar och Kubernetes-apperbjudanden
Hur ofta förväntas användningen genereras?
Helst förväntas du generera användning varje timme under den senaste timmen, endast om det finns användning under föregående timme.
Finns det en maximal period mellan ett utsläpp och nästa?
Det finns ingen sådan begränsning. Generera endast användning när det sker. 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 tid en händelse inträffar och den tid då en användningshändelse skickas till Microsoft?
Helst genereras användningshändelsen varje timme för händelser som inträffat under den senaste timmen. Fördröjningar förväntas dock. Den maximala fördröjningen som tillåts är 24 timmar, varefter användningshändelser inte accepteras. Det bästa sättet är att samla in användning varje timme och att generera är som en händelse i slutet av timmen.
Om en användningshändelse till exempel inträffar kl. 13.00 på en dag har du 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 systemet som genererar användning är nere kan det återställas och sedan skicka användningshändelsen för timintervallet då användningen skedde, utan att återgivningen gick 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 metoden kan dock skada trovärdigheten för faktureringshändelserapporterna för slutkund. Vi rekommenderar att du undviker att skicka mätarutsläpp 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 uppstå om användningshändelser.
En annan anledning till att skicka användning varje timme är att undvika situationer då användaren avbryter prenumerationen innan utgivaren skickar den dagliga/veckovisa/månatliga utsläppshändelsen.
Vad händer när du skickar fler än en användningshändelse under samma timme?
Endast en användningshändelse accepteras för entimmesintervallet. Timintervallet börjar vid minut 0 och slutar vid minut 59. Om fler än en användningshändelse genereras under samma timme tas efterföljande användningshändelser bort som dubbletter.
Vad händer när kunden avbryter köpet inom den tid som tillåts av avbokningsprincipen?
Det fasta beloppet debiteras inte, men överförbrukningsanvändningen kommer att vara det.
Kan anpassade mätarplaner användas för engångsbetalningar?
Ja, du kan definiera en anpassad dimension som en enhet för engångsbetalning och endast generera den en gång för varje kund.
Kan anpassade mätarplaner användas för nivåindelad prismodell?
Ja, den kan implementeras med varje anpassad dimension som representerar en enskild 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 prisnivåerna för e-post. Generera enheter av den första dimensionen så länge antalet e-postmeddelanden ligger under 1 000, sedan enheter av den andra dimensionen när antalet e-postmeddelanden är mellan 1 000 och 5 000 och slutligen enheter av den tredje dimensionen för över 5 000 e-postmeddelanden.
Vad händer om Marketplace-avläsningstjänsten har ett avbrott?
Om ISV:en 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), bör ISV vänta och försöka igen.
Om felet kvarstår ska du skicka den anpassade mätaren igen nästa timme (ackumulera kvantiteten). Fortsätt den här processen tills ett icke-felsvar tas emot.
Endast för SaaS-erbjudanden
Vad händer när du genererar användning för en SaaS-prenumeration som redan har avregistrerats?
Alla användningshändelser som skickas till Marketplace-plattformen godkänns inte när en SaaS-prenumeration har tagits bort.
Användning kan endast genereras för prenumerationer i prenumerationsstatusen (och inte för prenumerationer i PendingFulfillmentStart, Suspendedeller Unsubscribed status).
Det enda undantaget är att rapportera användning för den tid som var innan SaaS-prenumerationen har avbrutits.
Kunden avbröt till exempel SaaS-prenumerationen idag klockan 15.00. Nu är det 17:00, utgivaren kan fortfarande generera användning för perioden mellan 18:00 igår och 15:00 idag för denna SaaS-prenumeration.
Kan du få en lista över alla SaaS-prenumerationer, inklusive aktiva och prenumerationer som inte har prenumererats?
Ja, när du anropar API:et för GET-prenumerationslistan eftersom det innehåller en lista över alla SaaS-prenumerationer. Statusfältet i svaret för varje SaaS-prenumeration registrerar om prenumerationen är aktiv eller avregistrerad.
Är start- och slutdatumen för SaaS-prenumerationsperioden och överförbrukningsanvändningen anslutna?
Överförbrukningshändelser kan genereras när som helst för en befintlig SaaS-prenumeration i prenumerationsstatus . Det är utgivarens ansvar att generera användningshändelser baserat på principen som definieras i faktureringsplanen. Överförbrukning måste beräknas baserat på de datum som definierats under saaS-prenumerationens löptid.
Om utgivaren till exempel definierar en SaaS-plan som innehåller 1 000 e-postmeddelanden för 100 USD i månatlig fast ränta 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 från och med den här dagen. Om endast 900 e-postmeddelanden skickas fram till den 5 februari (slutet av prenumerationens första månad) kommer kunden endast att betala det fasta priset för den första månaden i den här prenumerationen och inga överförbrukningsanvändningshändelser genereras av utgivaren mellan den 6 januari och den 5 februari. Den 6 februari förnyas prenumerationen automatiskt och antalet startar igen. Om kunden den 15 februari når 1 000 skickade e-postmeddelanden debiteras resten av e-postmeddelandena som skickas fram till den 5 mars som överförbrukning (1 USD per e-post) baserat på överförbrukningsanvändningshändelser som genereras av utgivaren.
Nästa steg
- Mer information finns i API:er för Marketplace-avläsningstjänsten.