När en kund prenumererar på en SaaS-tjänst, Azure Application med en Hanterad app-plan eller Kubernetes-apperbjudande med avgiftsbelagda faktureringar spårar du förbrukningen för varje faktureringsdimension som används. Om förbrukningen överskrider det inkluderade antalet som angetts för den term som kunden valt, genererar din tjänst 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 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 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örseningar 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 per 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 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 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 slutkunden. 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är användaren avbryter prenumerationen innan utgivaren skickar den dagliga/veckovisa/månatliga utsläppshändelsen.
Vad händer när du skickar mer än en användningshändelse under samma timme?
Endast en användningshändelse accepteras för entimmesintervallet. Timintervallet börjar minut 0 och slutar vid minut 59. Om fler än en användningshändelse genereras under samma timme tas eventuella 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.
Kan anpassade mätarplaner användas för engångsbetalningar?
Ja, du kan definiera en anpassad dimension som en engångsbetalningsenhet och endast generera den en gång för varje kund.
Kan anpassade mätarplaner användas för nivåindelad prismodell?
Ja, det 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 för den första dimensionen så länge antalet e-postmeddelanden ligger under 1 000, sedan enheter i 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 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 med utsläppet.
Om felet kvarstår skickas 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 avslutats?
Alla användningshändelser som skickas till Marketplace-plattformen accepteras inte när en SaaS-prenumeration har tagits bort.
Användning kan endast genereras för prenumerationer i prenumerationsstatus (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 kl. 15.00. Nu är 17:00 kan utgivaren fortfarande avge 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 avregistrerade prenumerationer?
Ja, när du anropar API:et get-prenumerationslista 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 avprenumererad.
Ä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 i 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ånadstaxa debiteras varje e-postmeddelande över 1 000 USD via anpassad dimension.
När kunden köper och aktiverar prenumerationen den 6 januari räknas det 1 000 e-postmeddelandet som ingår i det fasta priset från och med den här dagen. Så om fram till den 5 februari (slutet av prenumerationens första månad) endast 900 e-postmeddelanden skickas, betalar kunden endast 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 6 januari och 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.