Skonfiguruj plan arkusza stawek

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

Wprowadzenie

W planie arkusza stawek deweloper jest obciążany za każdą transakcję. W przypadku tego typu abonamentu musisz podać dodatkowe informacje, takie jak model ładowania i jego cena.

Opcjonalnie możesz określić abonament freemium dla poszczególnych produktów (zamiast dla interfejsu API (pakiet) – możesz to zrobić tylko w przypadku abonamentu na określoną usługę.

Kiedy są naliczane opłaty cykliczne i resetowane abonamenty?

Plany stawek mogą obejmować opłaty cykliczne, a także pakiety interfejsów API (obejmujące pakiety zbiorcze i objęte ograniczeniami ilościowymi), oba te warunki dotyczą określonego momentu naliczania opłat i wyzerowania abonamentów w pakiecie. Z tej tabeli dowiesz się, kiedy są naliczane opłaty cykliczne, a liczba pakietów jest resetowana. Jeśli aplikacje programistów nie mogą wykonywać dalszych wywołań interfejsu API, ponieważ uzyskują transakcji, to czasy, gdy liczniki wywołań interfejsu API są wyzerowane, a aplikacje mogą znów zacząć dzwonić.

Jeśli abonament obejmuje... ...to się dzieje
  • niezerową opłatę cykliczną ustawioną na Miesiąc;
  • Abonament z objętością lub pakietem woluminowym

Opłata cykliczna i plan pakietu są resetowane pierwszego dnia miesiąca (domyślnie).

Jeśli chcesz, aby płatności powtarzały się co miesiąc w określonym dniu, utwórz plan stawek za pomocą opcji zarządzania API i wskaż dzień za pomocą właściwości RecurringStartUnit zgodnie z opisem. w artykule Tworzenie planów stawek za pomocą interfejsu API.
  • niezerową opłatę cykliczną ustawioną na Tydzień.
  • Abonament z objętością lub pakietem woluminowym
 Opłata cykliczna i plan pakietu są resetowane co 7 dni po stawce dewelopera. datę rozpoczęcia abonamentu.
  • niezerową opłatę cykliczną ustawioną na Dzień;
  • Abonament z objętością lub pakietem woluminowym
 Opłata cykliczna i plan pakietu są resetowane co X dni po datę rozpoczęcia abonamentu usługi.
  • Brak (lub zero) opłaty cyklicznej
  • Abonament z objętością lub pakietem woluminowym

Plany pakietu są resetowane na podstawie podstawy agregacji zdefiniowanej w arkuszu stawek. Dla: np. jeśli deweloper rozpocznie plan stawek 19 dnia miesiąca, a gregacja Podstawa jest określana co 1 miesiąc, a następnie 19 dnia miesiąca resetuje się użycie pakietu.

Pamiętaj, że dzień miesiąca nie zawsze jest taki sam. Na przykład, jeśli stawka Plan zaczyna się 31 grudnia, a data resetowania stanie się 28 dnia miesiąca bez okresu przestępnego Luty, bo mamy tylko 28 dni. 28 dzień miesiąca jest dniem resetowania nigdy później.

Konfigurujesz plany arkusza stawek za pomocą Interfejs

Skonfiguruj plany arkusza stawek w sposób opisany poniżej.

Edge

Aby skonfigurować plan arkusza stawek podczas tworzenia lub edytowania planu plan stawek, wybierz typ planu Arkusz stawek lub Arkusz stawek i udział w przychodach, a w sekcji Arkusz stawek wybierz jeden z tych modeli naliczania opłat:

Model ładowania Opis
Stała opłata Deweloper płaci stałą stawkę za każdą transakcję.
Z możliwością zmiany głośności Deweloper płaci zmienną stawkę w zależności od liczby transakcji.
Pakiety Deweloper jest z góry obciążany ustaloną kwotą za każdy pakiet transakcji. Deweloper jest obciążany ustaloną kwotą niezależnie od tego, czy pakiet zostanie wykorzystany w całości, czy nie.

Uwaga: ta opcja jest niedostępna po wybraniu arkusza stawek i udziału w przychodach.

Następnie skonfiguruj te informacje w zależności od wybranego modelu ładowania.

Model ładowania Pole Opis
Wszystko Częstotliwość obliczania Okres, w którym obliczana jest liczba transakcji (lub liczba związana z atrybutami niestandardowymi). Wybierz liczbę miesięcy (1–24 miesiące).
Stała opłata Płaska stawka Stawka pobierana za każdą transakcję. Wpisz liczbę dziesiętną (z maksymalnie czterema miejscami po przecinku).

Uwaga: możesz skonfigurować liczbę miejsc po przecinku, jaka będzie wymagana przy stawce pobieranej za pomocą interfejsu API (nie interfejsu użytkownika). Więcej informacji znajdziesz w artykule Konfigurowanie liczby miejsc po przecinku w przypadku stawek w ramach planu stawek.

Jeśli na przykład wpiszesz 0,10, a walutą będzie dolar amerykański, deweloper zapłaci 0,10 USD za każdą transakcję. Jeśli na podstawie atrybutu niestandardowego, takiego jak liczba bajtów przesyłanych w transakcji, deweloper zostanie obciążony opłatą w wysokości 0,10 USD za przesłanie określonej liczby bajtów.

Z możliwością zmiany głośności Opaski do regulacji głośności Co najmniej jeden zakres wartości transakcji (lub określony na podstawie atrybutów klienta) (każdy zakres to „zakres wolumenu”) dla modelu ładowania z uwzględnieniem woluminu. Każdemu zakresowi głośności można przypisać stawkę. Stawka jest stosowana do wszystkich transakcji w odpowiednim przedziale ilości. Określ górny limit pierwszego zakresu, na przykład 1000 (dolny limit jest wstępnie ustawiony na wartość większą niż 0).

Kliknij +Nowe, aby dodać kolejne opaski.

Pozostaw górny limit ostatniego zakresu pusty, aby wskazać wszystkie transakcje powyżej tego poziomu.

Uwaga: możesz skonfigurować liczbę miejsc po przecinku, jaka będzie wymagana przy stawce pobieranej za pomocą interfejsu API (nie interfejsu użytkownika). Więcej informacji znajdziesz w artykule Konfigurowanie liczby miejsc po przecinku w przypadku stawek w ramach planu stawek.

Jeśli na przykład w sekcji Zakres głośności określisz dwa zakresy głośności (>0–1000 i 1000 i więcej), możesz wpisać 0,15 dla zakresu >0–1000 i 0,10 dla zakresu 1000 i wyższego. Jeśli wybraną walutą jest dolar amerykański, kurs pierwszej 1000 transakcji wynosi 0,15 USD za każdą transakcję, a w przypadku ponad 1000 transakcji kurs jest równy 0,10 USD za każdą transakcję.

Pakiety Ceny pakietów interfejsów API Liczba transakcji w pakiecie (lub liczba powiązana z atrybutem niestandardowym, np. całkowita liczba bajtów przesłanych w pakiecie). Każdemu pakietowi można przypisać cenę. Cena dotyczy całego pakietu. Określ górny limit pierwszego pakietu, np. do 1000 (dolny limit jest wstępnie ustawiony na wartość większą niż 0).

Kliknij + Nowe, aby dodać kolejne pakiety. Musisz określić górny limit dla ostatniego pakietu, chyba że chcesz obciążyć dewelopera stałą kwotę za nieograniczoną liczbę transakcji w ostatnim pakiecie.

Uwaga: możesz skonfigurować liczbę miejsc po przecinku, jaka będzie wymagana przy stawce pobieranej za pomocą interfejsu API (nie interfejsu użytkownika). Więcej informacji znajdziesz w artykule Konfigurowanie liczby miejsc po przecinku w przypadku stawek w ramach planu stawek.

Jeśli np. w sekcji Rozmiar pakietu określisz 2 pakiety (większe od 0 do 1000 i większe od 1000 do 2000), możesz wpisać 50 w przypadku pakietów od 0 do 1000 i 40 dla pakietów większych od 1000 do 2000. Jeśli wybraną walutą jest dolar amerykański, cena pierwszego pakietu to 50 zł, a drugiego – 40 zł. Deweloper zostanie obciążony odpowiednią ceną pakietu niezależnie od liczby transakcji użytych w pakiecie (tzn. deweloper zostanie obciążony opłatą za pakiet z chwilą zrealizowania pierwszej transakcji).

Jeśli w przypadku produktu API masz zdefiniowane atrybuty niestandardowe, możesz skonfigurować niestandardowy parametr oceny, by pobierać opłaty od dewelopera aplikacji na podstawie atrybutu niestandardowego w każdej transakcji. Jeśli na przykład skonfigurujesz abonament, w którym obciążasz dewelopera za każdą transakcję, możesz określić stawkę dla abonamentu na podstawie atrybutu niestandardowego, takiego jak liczba bajtów przesyłanych przez backend, która może się różnić w zależności od transakcji.

W takim przypadku wybierz Użyj niestandardowego parametru oceny i wybierz atrybut niestandardowy z listy. Więcej informacji znajdziesz w artykule Konfigurowanie planu stawek z wykorzystaniem atrybutów niestandardowych.

Classic Edge (Private Cloud)

Aby skonfigurować plany arkusza stawek w interfejsie Classic Edge:

  1. Postępuj zgodnie z instrukcjami, aby utworzyć plan stawek.
  2. W menu Typ planu stawek wybierz Arkusz stawek, by skonfigurować model rozliczeniowy.
  3. Jeśli wybrany pakiet interfejsów API zawiera wiele usług API, wybierz jedną z tych opcji:

    Uwaga: jeśli pakiet interfejsów API zawiera jedną usługę API, możesz pominąć ten krok.

    • Abonamenty na poziomie usługi umożliwiają skonfigurowanie szczegółów abonamentu dla każdej usługi API z osobna.
    • Abonament ogólny dla wszystkich usług umożliwia skonfigurowanie szczegółów abonamentu dla wszystkich usług API.
  4. Kliknij Arkusz stawek dla ogólnego planu stawek lub każdego abonamentu interfejsu API w przypadku poszczególnych usług.

    Uwaga: podczas konfigurowania abonamentów dotyczących usług interfejsu API musisz skonfigurować plan arkusza stawek. dla każdej usługi API.

    Otworzy się okno Arkusz stawek.

  5. Skonfiguruj abonament freemium dla usługi API. Abonament freemium oferuje programistom bezpłatne wykorzystanie usługi API w danym okresie lub na podstawie intensywności użytkowania.

    Wprowadź następujące informacje:

    Pole Opis
    Produkt freemium?

    Zakres okresu wolnego. Wybierz jedną z tych opcji:

    • Według ilości. Okres próbny zależy od ilości określonej w ilości .
    • Według czasu trwania. Okres naliczania opłat opiera się na przedziale czasu określonym w Freemium Duration.
    • Niezależnie od tego, co nastąpi wcześniej. Okres próbny kończy się, gdy ilość atrybutu w polu Wolumin lub przedział czasu w polu Czas trwania freemium, w zależności od tego, co nastąpi wcześniej.
    • Nie. Nie jest to plan freemium. Jest to ustawienie domyślne.
    Objętość freemium

    Liczba transakcji (lub liczba transakcji związanych z atrybutem niestandardowym zarejestrowanych w zasady rejestrowania transakcji), za które deweloperzy nie są obciążani. Głośność jest dla danej usługi API. Wpisz liczbę woluminów, na przykład 5000. Oznacza to, że Gdy deweloperzy rozpoczynają abonament, nie są obciążani za pierwsze 5000 transakcji. (lub pierwszych 5000 zastosowań produktu związanego z atrybutem niestandardowym). To pole jest włączona tylko wtedy, gdy wybierzesz opcję „Według ilości” lub „Cokolwiek będzie pierwsze”. w modelu „Freemium” produktu?”. .
    Czas trwania freemium

    Przedział czasu, w którym deweloperzy nie są obciążani płatnościami. Wpisz liczbę i wybierz okres, na przykład 1 miesiąc. Oznacza to, że deweloperzy nie mogą pobierana przez 1 miesiąc. To pole jest aktywne tylko wtedy, gdy wybierzesz opcję „Według czasu trwania”. lub „Cokolwiek będzie pierwsze” w „produkcie freemium”? .
  6. Wybierz jeden z tych modeli ładowania:
    • Płaska stawka. W tym modelu deweloper płaci stałą stawkę za transakcji.
    • Zakres głośności. W tym modelu deweloper otrzymuje zmienną stawkę w zależności od liczby transakcji.
    • Pakiety. W tym modelu deweloper płaci z góry ustaloną kwotę za pakiet transakcji. Deweloper jest obciążany ustaloną kwotą niezależnie od tego, czy pakiet w całości.

    W przypadku modelu stałej opłaty: wpisz te informacje w sekcji Ceny w okno Ogólny arkusz stawek:

    Pole Opis
    Operator (lub organizacja)

    Nazwa Twojej organizacji. To pole jest wstępnie skonfigurowane za pomocą operatora (lub Organization) pola w profilu organizacji.
    Kraj

    Kraj, w którym prowadzisz działalność. To pole jest wstępnie skonfigurowane za pomocą Wartość pola kraju w profilu organizacji.
    Stała opłata

    Stawka pobierana za każdą transakcję. Wpisz liczbę dziesiętną (maksymalnie cztery miejsc po przecinku).

    Uwaga: możesz skonfigurować liczbę możliwych miejsc po przecinku stawki pobieranej za pomocą interfejsu API (a nie interfejsu użytkownika). Szczegółowe informacje znajdziesz w sekcji Konfigurowanie liczbę miejsc po przecinku w przypadku stawek w ramach planu stawek.

    Jeśli na przykład wpiszesz 0, 10, a walutą będzie dolar amerykański, deweloperem będzie naliczana jest kwota 0,10 PLN za każdą transakcję (lub w przypadku korzystania z atrybutu niestandardowego, takiego jak bajtów przesłanych w transakcji, deweloper zostanie obciążony opłatą w wysokości 0,10 USD za przesyłając określoną liczbę bajtów).

    W przypadku modelu pasmającego w zakresie woluminu: okno Ogólny arkusz stawek zawiera dodatkowe służące do określania podstawy agregacji i określania „zakresów wolumenu”, tj. zakresy wielkości transakcji, w przypadku których możesz stosować różne stawki.

    Plan tego typu jest zwykle konfigurowany w celu zachęcenia deweloperów do generowania większych ilości treści przez oferujący obniżone ceny na opaski o większej głośności.

    W oknie Ogólny arkusz stawek wpisz te informacje:

    Pole Opis
    Podstawa agregacji

    Okres, w którym liczba transakcji (lub niestandardowy ilość związana z atrybutem) jest agregowana. Zagregowana ilość jest używana do identyfikacji zakres wolumenu i stawkę, które mają być zastosowane do każdej transakcji. Wybierz liczbę miesięcy (1–12 miesięcy).

    Szczegółowe informacje o tym, kiedy pakiety są resetowane, znajdziesz w sekcji Kiedy są cykliczne? Naliczone opłaty i plany pakietów zostały zresetowane?
    Pasma głośności

    Co najmniej jeden zakres wartości transakcji (lub liczby transakcji na podstawie atrybutów klienta) (każdy zakres) to „pasmo głośności”). Każdemu zakresowi głośności możesz przypisać szybkość (ustawiasz tę częstotliwość w w polu „Pasma woluminu” w sekcji „Ceny”). Stawka jest stosowana do wszystkich transakcji w odpowiednim zakresie wolumenu. Określ górny limit pierwszej wartości zakresu np. do 1000 (dolny limit jest wstępnie ustawiony na wartość większą niż 0). Kliknij przycisk + aby dodać drugą opaskę, np. powyżej 1000 do 2000. Aby dodać więcej, kliknij + opaski. Możesz zostawić górny limit dla ostatniego pasma puste, aby wskazać wszystkie transakcji powyżej tego poziomu.
    Ceny
    Operator (lub organizacja)

    Nazwa Twojej organizacji. To pole jest wstępnie skonfigurowane za pomocą operatora (lub Organization) pola w profilu organizacji.
    Kraj

    Kraj, w którym prowadzisz działalność. To pole jest wstępnie skonfigurowane za pomocą Wartość pola kraju w profilu organizacji.
    Waluta

    Baza czy waluty rozliczeniowej używanej przez organizację. To pole jest używając wartości z pola Waluta w profilu organizacji, ale można ją został zmieniony tutaj.
    Opaski do regulacji głośności

    Stawka dla zakresu głośności. Dla każdego zakresu głośności określasz stawkę. Wpisz liczba dziesiętna dla każdego zakresu (z maksymalnie czterema miejscami po przecinku).

    Uwaga: możesz skonfigurować liczbę możliwych miejsc po przecinku dla szybkości pasma głośności za pomocą interfejsu API (a nie interfejsu użytkownika). Szczegółowe informacje znajdziesz w sekcji Konfigurowanie liczbę miejsc po przecinku w przypadku stawek w ramach planu stawek.

    Jeśli na przykład w sekcji Pasmo głośności określisz dwa zakresy głośności (>0–1000 oraz 1000 i więcej) możesz wpisać 0, 15, by użyć woluminu >0–1000 i 0, 10 dla pasma 1000 i większej. Jeśli wybrana waluta to Stany Zjednoczone dolarów, stawka dla pierwszych 1000 transakcji wynosi 0,15 USD za każdą transakcję, w przypadku ponad 1000 transakcji stawka wynosi 0, 10 USD za każdą transakcję.

    W przypadku modelu w pakiecie: okno Ogólny arkusz stawek zawiera dodatkowe pola, które którego używasz, aby określić podstawę agregacji (okres, w którym deweloper może pakietu transakcji) oraz określania związanych z nim informacji, takich jak rozmiar w pakiecie.

    W oknie Ogólny arkusz stawek wpisz te informacje:

    Pole Opis
    Podstawa agregacji

    Okres, w którym deweloper może wykorzystać pakiet transakcji (lub użyj pakietu opartego na atrybutach niestandardowych). Wybierz liczbę miesięcy (1–12 miesięcy). Po w tym okresie abonament wygasa, a deweloper musi go kupić (oraz pakiety). ponownie.

    Szczegółowe informacje o tym, kiedy pakiety są resetowane, znajdziesz w sekcji Kiedy są cykliczne? Naliczone opłaty i plany pakietów zostały zresetowane?
    Rozmiar pakietu

    Liczba transakcji w pakiecie (lub liczba transakcji związanych z atrybutem niestandardowym np. łączną liczbę bajtów przesyłanych w pakiecie). Każdą grupę można przypisać cenę (możesz ją ustawić w polu Rozmiar pakietu w sekcji Ceny). dotyczy całego pakietu. Określ górny limit pierwszego pakietu, na np. do 1000 (dolny limit jest wstępnie ustawiony na wartość większą niż 0). Kliknij +, aby dodać w drugiej grupie, np. większe niż 1000 do 2000. Aby dodać więcej, kliknij + pakiety. Musisz określić górny limit dla ostatniego pakietu, chyba że chcesz obciąża dewelopera stałą kwotę za nieograniczoną liczbę transakcji w ciągu ostatnich w pakiecie.
    Ceny
    Operator (lub organizacja)

    Nazwa Twojej organizacji. To pole jest wstępnie skonfigurowane za pomocą operatora (lub Organization) pola w profilu organizacji.
    Kraj

    Kraj, w którym prowadzisz działalność. To pole jest wstępnie skonfigurowane za pomocą Wartość pola kraju w profilu organizacji.
    Waluta

    Baza czy waluty rozliczeniowej używanej przez organizację. To pole jest używając wartości z pola Waluta w profilu organizacji, ale można ją został zmieniony tutaj.
    Rozmiar pakietu (cena)

    Cena pakietu. Musisz określić cenę każdego pakietu. Wpisz liczbę dziesiętną liczba (z maksymalnie czterema miejscami po przecinku).

    Uwaga: możesz skonfigurować liczbę możliwych miejsc po przecinku stawki pakietu za pomocą interfejsu API (a nie interfejsu użytkownika). Szczegółowe informacje znajdziesz w sekcji Konfigurowanie liczbę miejsc po przecinku w przypadku stawek w ramach planu stawek.

    Jeśli na przykład w sekcji Rozmiar pakietu określisz 2 pakiety (większe niż 0), maksymalnie 1000 i więcej od 1000 do 2000), możesz wpisać 50 dla większej od 0 do 1000 pakietów oraz 40 w przypadku pakietów od 1000 do 2000. Jeśli wybraną walutą jest dolar amerykański, cena pierwszego pakietu to 50 USD, a a drugi pakiet – 40 zł. Deweloper płaci odpowiednią cenę pakietu. niezależnie od liczby transakcji użytych w pakiecie (czyli liczby transakcji deweloper jest obciążany ceną pakietu zaraz po pierwszej transakcji zawartej w pakiecie został zakończony).
  7. Kliknij Zastosuj i zamknij, aby zapisać dane arkusza stawek i wrócić do abonamentu standardowego. okno.
  8. W przypadku abonamentów usług interfejsu API skonfiguruj szczegóły abonamentu dodatkowych usług API zgodnie z wymaganiami.

Konfigurowanie planu arkusza stawek przy użyciu interfejsu API

Skonfiguruj szczegóły planu arkusza stawek za pomocą interfejsu API w sposób opisany w sekcjach poniżej.

Określanie szczegółów planu arkusza stawek za pomocą interfejsu API

Szczegóły planu arkusza stawek określasz podczas jego tworzenia. Określasz szczegóły w właściwość ratePlanDetails w treści żądania w wywołaniu funkcji /organizations/{org_name}/monetization-packages/{package_id}/rate-plans Co Ty wskazane we właściwości ratePlanDetails, w zależności od wybranego modelu ładowania: ze stałą opłatą, w obrębie pasma wartości lub w pakietach.

Określanie model ładowania ze stałą opłatą

Aby wdrożyć model opłat ze stałą opłatą, musisz określić w planie stawek te elementy: szczegóły:

  • Parametr oceny, który wskazuje, że plan stawek jest oparty na transakcjach (VOLUME) lub na podstawie atrybutu niestandardowego (np. MINT_CUSTOM_ATTRIBUTE_1). Domyślna wartość to VOLUME.
  • typ pomiaru (UNIT), który wskazuje, że stawka jest stała na jednostkę (która nie zależą od liczby transakcji, tak jak w przypadku grup modelu ładowania zbiorczego).
  • termin płatności (np. 30 dni);
  • Identyfikator Twojej organizacji.
  • Baza lub waluty księgowej używanej przez firmę.
  • Stawka w ramach planu stawek, która zawiera szczegółowe informacje o sposobie jej obliczania. Ponieważ model naliczania opłat na podstawie stałej stawki, określasz tylko jedną stawkę w ramach abonamentu.

W stawce planu stawek podajesz:

  • Typ stawki abonamentu (RATECARD).
  • Stawka w ramach planu. Jeśli na przykład wpiszesz 0, 10, a walutą będzie dolar amerykański, deweloper jest obciążany kwotą 0,10 USD za każdą transakcję (lub w przypadku korzystania z atrybutu niestandardowego, liczba bajtów wysłanych w transakcji, deweloper zostanie obciążony opłatą w wysokości 0,10 USD za przesyłając określoną liczbę bajtów).
  • Początkowa jednostka stawki (0). Oznacza to, że stawka stosowane w każdej transakcji, zaczynając od pierwszej transakcji.

Zobacz abonament szczegóły konfiguracji, gdzie znajdziesz pełną listę opcji szczegółów abonamentu.

Przykład poniżej pozwala utworzyć plan arkusza stawek ze stałym modelem obciążeń. Stawka wynosi 0,10 USD za każdą transakcję. Termin płatności upływa za 30 dni. (Szczegóły arkusza stawek to highlighted.)

curl -H "Content-Type:application/json" -X POST -d \
'{ 
     "name": "Flat rate card plan",
     "developer":null,
     "developerCategory":null,
     "advance": "false",
     "currency": {
      "id" : "usd"
     },     
     "description": "Flat rate card plan",
     "displayName" : "Flat rate card plan",
     "frequencyDuration": "30",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",     
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "paymentDueDays": "30",
     "prorate": "false",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "paymentDueDays": "30",      
      "meteringType": "UNIT",
      "organization": {
       "id": "{org_name}"
      },
      "ratePlanRates": [
       {
        "type": "RATECARD",
        "rate": "0.10",
        "startUnit": "0"       
       }      
      ], 
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2013-09-15 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password

Określanie model ładowania z pasmem głośności

W modelu ze zmiennymi pod względem ilościowym podajesz szczegóły planu stawek, które obejmują co najmniej 1 abonament stawek, każda z nich ma zastosowanie do „przedziału wolumenu”, czyli zakresu na podstawie atrybutu niestandardowego, takiego jak liczba przesłanych bajtów). Ten typ planu jest zwykle skonfigurowane w taki sposób, aby zachęcać deweloperów do generowania większej liczby konwersji przez oferowanie rabatów. w przypadku pasm o większej głośności.

Oprócz stawek w planie stawek w szczegółach abonamentu podajesz te informacje:

  • Parametr oceny, który wskazuje, że plan stawek jest oparty na transakcjach (VOLUME) lub na podstawie atrybutu niestandardowego (np. CUSTOM_ATTRIBUTE_1). Domyślna wartość to VOLUME.
  • Typ pomiaru (VOLUME), który wskazuje, że częstotliwość zależy od ilości. transakcji (czyli nie jest to płaska opłata za transakcję, jak w przypadku modelu naliczania opłat ze stałą opłatą).
  • termin płatności (np. 30 dni);
  • Identyfikator Twojej organizacji.
  • Baza lub waluty księgowej używanej przez firmę.
  • Typ czasu trwania i czasu trwania, który razem określa okres, w którym wolumin transakcji (lub liczby związanej z atrybutami niestandardowymi) są podawane zbiorczo. Jest to tzw. „podstawa agregacji”. Liczba transakcji jest agregowana na podstawie agregacji (w przypadku np. 1 miesiąc), aby określić odpowiedni zakres głośności.
  • Liczniki agregacji używane do określania odpowiedniego zakresu głośności.

W przypadku każdej stawki abonamentu określasz:

  • Typ stawki abonamentu (RATECARD).
  • Stawka w ramach planu. Jeśli na przykład wpiszesz 0, 10, a walutą będzie dolar amerykański, deweloper jest obciążany kwotą 0,15 USD za każdą transakcję (lub w przypadku korzystania z atrybutu niestandardowego, liczba bajtów przesłanych w transakcji, deweloper zostanie obciążony opłatą w wysokości 0,15 USD za przesyłając określoną liczbę bajtów).
  • Początkowa i końcowa jednostka zakresu głośności. Jednostka początkowa określa niższą ograniczenia zakresu głośności, a jednostka końcowa – górny. Dla: Jeśli na przykład określisz jednostkę początkową o wartości 0, a jednostkę końcową równą 1000, zakres głośności będzie obejmować 1000 transakcji w okresie agregacji. Jeśli walutą jest dolar amerykański, okres agregacji wynosi 1 miesiąc, a stawka dla pierwszych 1000 transakcji wynosi 0, 15. deweloper płaci 0,15 USD za maksymalnie 1000 transakcji w miesiącu.

    Szczegółowe informacje o tym, kiedy pakiety są resetowane, znajdziesz w sekcji Kiedy są naliczane opłaty cykliczne. i plany pakietu?

    Jeśli nie określisz jednostki końcowej dla końcowego zakresu głośności, stawka dla tego zakresu wynosi jest stosowana do wszystkich transakcji po przekroczeniu przez jednostkę początkową; dla tego zespołu. Na przykład, jeśli jednostka początkowa ostatniego pasma to 1000, a nie Określ końcową jednostkę dla tego zakresu, stawka dla tego zakresu będzie stosowana do wszystkich transakcji więcej niż 1000 transakcji w okresie agregacji.

Zobacz abonament szczegóły konfiguracji, gdzie znajdziesz pełną listę opcji szczegółów abonamentu.

Przykład poniżej pozwala utworzyć plan arkusza stawek z modelem ładowania z pasmem woluminu. stawka jest ustawiana na 0,15 USD dla pierwszych 1000 transakcji i 0,10 USD dla wszystkich transakcji powyżej 1000. Podstawą agregacji jest 1 miesiąc. Termin płatności upływa za 30 dni. (Szczegóły arkusza stawek są zaznaczone).

curl -H "Content-Type:application/json" -X POST -d \

'{
     "name": "Volume banded rate card plan",
     "developer":null,
     "developerCategory":null,
     "currency": {
      "id" : "usd"
     },     
     "frequencyDuration": "30",
     "description": "Volume banded rate card plan",
     "displayName" : "Volume banded rate card plan",
     "frequencyDuration": "30",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },    
     "paymentDueDays": "30",
     "prorate": "false",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "aggregateStandardCounters": true,
      "paymentDueDays": "30",
      "duration": "1",
      "durationType": "MONTH",
      "meteringType": "VOLUME",
      "organization": {
       "id": "{org_name}"
      },      
      "ratePlanRates": [
      {
       "type": "RATECARD",
       "rate": "0.15",
       "startUnit": "0",
       "endUnit": "1000"
      },
      {
       "type": "RATECARD",
       "rate": "0.10",
       "startUnit": "1000"      
      }
      ],     
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2013-09-15 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password

Określanie model ładowania w pakiecie

W modelu ładowania pakietu deweloper płaci z góry za „pakiet”. transakcji (lub dla pakietu opartego na atrybucie niestandardowym, takim jak liczba przesłanych bajtów). Określasz stawki dla każdego pakietu oraz podstaw agregacji, czyli okresu, w którym deweloper z pakietu.

Załóżmy np., że konfigurujesz 2 pakiety, z których pierwszy rozmiar to od 1 do 1000 transakcji, a drugi rozmiar pakietu to od 1001 do 2000 transakcji. Cena wynosi 50 zł za Pierwszy pakiet i 40 USD za drugi, a podstawa agregacji wynosi 1. Jeśli programista kupuje abonament z arkusza stawek za pierwszy pakiet, płaci 50 PLN (z góry) za 1000 transakcji w miesięcznie. Deweloper jest obciążany ustaloną kwotą niezależnie od tego, czy pakiet zostanie wykorzystany w całości, czy nie. Po zakończeniu okresu agregacji abonament wygasa. Jeśli deweloper chce używać pakietu klient musi ponownie kupić abonament (i pakiet).

Informacje podane w szczegółach abonamentu są zasadniczo takie same jak te podane w polu szczegóły planu taryfowego dla modelu ładowania przylegającego do określonych ilości miejsca. Różnice są następujące:

  • Każdy podany przez Ciebie abonament dotyczy pakietu (a nie dla zakresu głośności).
  • Musisz określić górny limit dla ostatniego pakietu, chyba że chcesz obciążyć deweloperowi stałej kwoty dla nieograniczonej liczby transakcji w ostatnim pakiecie.

Zobacz abonament szczegóły konfiguracji, gdzie znajdziesz pełną listę opcji szczegółów abonamentu.

Poniższy przykład pokazuje tworzenie planu arkusza stawek z modelem obciążeń w pakiecie. Stawka wynosi została ustawiona na 50 USD za pierwszy pakiet (do 1000 transakcji) i 40 USD za drugi pakiet (więcej od 1000 do 2000 transakcji). Podstawą agregacji jest 1 miesiąc. Termin płatności upływa za 30 dni dni.

curl -H "Content-Type:application/json" -X POST -d \
'{
     "name": "Bundled rate plan",
     "developer":null,
     "developerCategory":null,
     "currency": {
      "id" : "usd"
     },    
     "frequencyDuration": "30",
     "description": "Bundled rate plan",
     "displayName" : "Bundled rate plan",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },    
     "paymentDueDays": "30",
     "prorate": "true",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "aggregateStandardCounters": true,
      "paymentDueDays": "30",
      "duration": "1",
      "durationType": "MONTH",
      "meteringType": "STAIR_STEP",
      "organization": {
       "id": "{org_name}"
      },
      "ratePlanRates": [
      {
       "type": "RATECARD",
       "rate": "50",
       "startUnit": "0",
       "endUnit": "1000"
      },
      {
       "type": "RATECARD",
       "rate": "40",
       "startUnit": "1000",
       "endUnit": "2000"
      }
      ],
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2013-09-15 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password

Określanie abonamentu freemium dla poszczególnych produktów za pomocą interfejsu API

W planie arkusza stawek możesz skonfigurować plan freemium dla pojedynczego produktu (zamiast dla pakiet interfejsu API). Abonament freemium daje deweloperom możliwość bezpłatnego korzystania z interfejsu API przez w zależności od intensywności użytkowania.

Podczas konfigurowania abonamentu freemium dla usługi API musisz określić w szczegółach planu arkusza stawek okres, w którym deweloper może korzystać z zasobów dostarczonych przez usługę API bez ładowania. Data okresu może być związana z jednym z tych elementów:

  • Czas trwania, czyli czas upływający między datą wejścia w życie a datą zakończenia.
  • Ilość, taka jak liczba transakcji związanych z produktem API lub ilość odnoszące się do atrybutu niestandardowego zarejestrowanego w zasadach rejestrowania transakcji.

Jeśli okres freemium zależy od ilości, podaj go jako liczbę jednostek freemium. Dla: Poniższy przykład tworzy plan arkusza stawek z planem freemium na podstawie ilości wynoszącej 5000 (specyfikacje modelu freemium są wyróżnione).

curl -H "Content-Type:application/json" -X POST -d \
'{
      "name": "Flat rate card plan with freemium period",
      "developer":null,
      "developerCategory":null,      
      "advance": "false",
      "currency": {
       "id" : "usd"
      },     
      "description": "Flat rate card plan with freemium period",
      "displayName" : "Flat rate card plan with freemium period",
      "frequencyDuration": "30",
      "frequencyDurationType": "DAY",
      "earlyTerminationFee": "10",     
      "monetizationPackage": {
       "id": "location"
      },
      "organization": {
       "id": "myorg"
      },
      "paymentDueDays": "30",
      "prorate": "false",
      "published": "false",
      "ratePlanDetails": [
      {
       "currency": {
       "aggregateFreemiumCounters" : true,
       "aggregateStandardCounters" : true,
        "id" : "usd"
       },
       "product" : {
        "id" : "location",
        "displayName":"Location"
       },
       "paymentDueDays": "30",      
       "meteringType": "UNIT",
       "organization": {
        "id": "myorg"
       },
       "ratePlanRates": [
        {
         "type": "RATECARD",
         "rate": "0.10",
         "startUnit": "0"       
        }      
       ],
      "freemiumUnit": "5000",
      "freemiumDuration": "0",
      "freemiumDurationType": "DAY",
      "ratingParameterUnit":"MB",
      "customPaymentTerm": "false",
      "ratingParameter": "VOLUME",
      "type": "RATECARD"
      }],
      "recurringStartUnit": 1,
      "recurringType": "CALENDAR",
      "recurringFee": "10",
      "setUpFee": "10",
      "startDate": "2013-09-15 00:00:00",
      "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password