Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione
Documentazione di Apigee X. Informazioni
Introduzione
In un piano tariffario, allo sviluppatore viene addebitata ogni transazione. Per questo tipo di piano, fornire ulteriori dettagli, ad esempio il modello di addebito e i prezzi corrispondenti.
Facoltativamente, puoi specificare un piano freemium per singoli prodotti (anziché un'API) ), puoi eseguire questa operazione solo per un piano specifico di un prodotto.
Quando vengono addebitate le tariffe ricorrenti e vengono reimpostati i piani pacchetto?
I piani tariffari possono includere tariffe ricorrenti, così come pacchetti di API (piani basati sul volume e pacchetti), entrambi prevedono un momento specifico in cui vengono addebitate le tariffe e i piani pacchetto vengono azzerati. La la seguente tabella descrive quando vengono addebitate le tariffe ricorrenti e i conteggi dei pacchetti vengono reimpostati. Se alle app sviluppatore viene impedito di effettuare ulteriori chiamate API perché vengono raggiunte di transazioni, si tratta del numero di volte in cui il conteggio delle chiamate API viene reimpostato su zero può iniziare a effettuare di nuovo le chiamate.
| Se il piano ha... | ...questo accade |
|---|---|
|
La reimpostazione della tariffa ricorrente e del piano pacchetto avviene il primo giorno del mese (impostazione predefinita). Per una ricorrenza mensile di un giorno specifico, crea un piano tariffario utilizzando la gestione
API e indica il giorno con una proprietà |
|
La reimpostazione della tariffa ricorrente e del piano pacchetto avviene ogni 7 giorni dopo la tariffa dello sviluppatore data di inizio del piano. |
|
La tariffa ricorrente e il piano pacchetto vengono reimpostati ogni X giorni dopo il data di inizio del piano tariffario dello sviluppatore. |
|
I piani bundle vengono reimpostati in base alla base di aggregazione definita nel tariffario. Per Ad esempio, se uno sviluppatore avvia un piano tariffario il 19 del mese e la metrica La base è ogni 1 mese, quindi l'utilizzo del bundle viene reimpostato ogni mese il 19. Tieni presente che il giorno del mese potrebbe non essere sempre lo stesso. Ad esempio, se una tariffa inizia il 31 dicembre, la data di reimpostazione diventa il 28 in un anno non bisestile a febbraio, perché a febbraio ci sono solo 28 giorni. Il 28° rimane quindi il giorno del ripristino in futuro. |
Configurare piani tariffari utilizzando Interfaccia utente
Configura i piani tariffari, come descritto di seguito.
Edge
Per configurare un piano tariffario, durante la creazione o modifica di un piano tariffario un piano tariffario, seleziona il tipo di piano Tariffario o Tariffario e quota di condivisione delle entrate e, nella sezione Tariffario, seleziona uno dei seguenti modelli di addebito:
| Modello di ricarica | Descrizione |
| Costo fisso | Allo sviluppatore viene addebitata una tariffa fissa per ogni transazione. |
| Con bande di volume | Allo sviluppatore viene addebitata una tariffa variabile in base al volume di transazioni. |
| Bundle | Allo sviluppatore viene addebitato in anticipo un importo prestabilito per ogni pacchetto di transazioni. Allo sviluppatore viene addebitato l'importo impostato indipendentemente dal fatto che il bundle venga utilizzato completamente o meno.
Nota: questa opzione non è disponibile quando selezioni Tariffario e Quota di condivisione delle entrate. |
Quindi, configura le seguenti informazioni in base al modello di ricarica selezionato.
| Modello di ricarica | Campo | Descrizione |
| Tutte | Frequenza di calcolo | Periodo di tempo durante il quale viene calcolato il volume delle transazioni (o del volume relativo agli attributi personalizzati). Seleziona un numero di mesi (1-24 mesi). |
| Costo fisso | Costo fisso | Tariffa addebitata per ogni transazione. Inserisci un numero decimale (con un massimo di quattro cifre decimali).
Nota: puoi configurare il numero di cifre decimali che è possibile specificare per la tariffa addebitata utilizzando l'API (non l'interfaccia utente). Per maggiori dettagli, consulta Configurare il numero di posizioni decimali per le tariffe dei piani tariffari. Ad esempio, se inserisci 0,10 e la valuta è in dollari statunitensi, allo sviluppatore vengono addebitati 0,10 $per ogni transazione (oppure, se in base a un attributo personalizzato come il numero di byte trasmessi in una transazione, allo sviluppatore vengono addebitati 0,10 $per la trasmissione del numero specificato di byte). |
| Con bande di volume | Bande di volume | Uno o più intervalli di volume delle transazioni (o in base agli attributi del cliente) (ciascun intervallo è una "banda del volume") per il modello di ricarica con banda del volume. A ogni banda del volume può essere assegnata una frequenza. La tariffa viene applicata a tutte le transazioni nella banda di volume applicabile. Specifica il limite superiore della prima banda, ad esempio, fino a 1000 (il limite inferiore è preimpostato su un valore maggiore di 0).
Fai clic su +Nuovo per aggiungere altri cinturini. Lascia vuoto il limite superiore della banda finale per indicare tutte le transazioni al di sopra di questo livello. Nota: puoi configurare il numero di cifre decimali che è possibile specificare per la tariffa addebitata utilizzando l'API (non l'interfaccia utente). Per maggiori dettagli, consulta Configurare il numero di posizioni decimali per le tariffe dei piani tariffari. Ad esempio, se specifichi due bande di volume nella sezione Banda di volume (>0-1000 e 1000 e oltre), potresti inserire 0,15 per la banda di volume >0-1000 e 0, 10 per la banda di volume 1000 e superiore. Se la valuta selezionata è in dollari USA, il tasso per le prime 1000 transazioni è di 0,15 $per ogni transazione, mentre per più di 1000 transazioni il tasso è di 0,10 $per ogni transazione. |
| Bundle | Prezzi dei bundle API | Numero di transazioni in un bundle (o un numero correlato a un attributo personalizzato come il numero totale di byte trasmessi in un bundle). A ogni pacchetto può essere assegnato un prezzo. Il prezzo si applica all'intero pacchetto. Specifica il limite superiore del primo bundle, ad esempio fino a 1000 (il limite inferiore è preimpostato su un valore maggiore di 0).
Fai clic su +Nuovo per aggiungere altri bundle. Devi specificare un limite massimo per l'ultimo bundle, a meno che tu non voglia addebitare allo sviluppatore un importo fisso per un numero illimitato di transazioni nell'ultimo bundle. Nota: puoi configurare il numero di cifre decimali che è possibile specificare per la tariffa addebitata utilizzando l'API (non l'interfaccia utente). Per maggiori dettagli, consulta Configurare il numero di posizioni decimali per le tariffe dei piani tariffari. Ad esempio, se specifichi due pacchetti nella sezione Dimensioni bundle (maggiore di 0 fino a 1000 e maggiore di 1000 fino a 2000), puoi inserire 50 per il bundle maggiore di 0 fino a 1000 e 40 per il bundle maggiore di 1000 fino a 2000. Se la valuta selezionata è il dollaro statunitense, il prezzo del primo pacchetto è di 50 $, mentre del secondo bundle il prezzo è di 40 $. Allo sviluppatore viene addebitato il prezzo del pacchetto applicabile indipendentemente dal numero di transazioni che utilizza all'interno del bundle (ovvero, allo sviluppatore viene addebitato il prezzo del bundle non appena viene completata la prima transazione nel bundle). |
Se hai definito attributi personalizzati per il tuo prodotto API, puoi configurare un parametro di valutazione personalizzata per addebitare l'importo allo sviluppatore dell'app in base a un attributo personalizzato in ogni transazione. Ad esempio, se configuri un piano in cui addebiti allo sviluppatore ogni transazione, puoi impostare la tariffa del piano in base a un attributo personalizzato, come il numero di byte trasmessi sul backend, che può variare per transazione.
In questo caso, seleziona Utilizza parametro di valutazione personalizzato e scegli l'attributo personalizzato dall'elenco a discesa. Per saperne di più, consulta l'articolo Configurare il piano tariffario con attributi personalizzati.
Perimetrale classico (Private Cloud)
Per configurare i piani tariffari utilizzando l'interfaccia utente di Edge classico:
- Segui i passaggi per creare un piano tariffario.
- Seleziona Tariffario nell'elenco a discesa Tipo di piano tariffario per configurare il modello di entrate.
- Se il pacchetto API selezionato include più prodotti API, seleziona una delle seguenti opzioni:
Nota: se il pacchetto API include un singolo prodotto API, puoi saltare questo passaggio.
- Piani specifici per prodotto, per configurare i dettagli dei piani tariffari per ciascun prodotto API singolarmente.
- Piano generico per tutti i prodotti per configurare i dettagli del piano tariffario per tutti i prodotti basati su API.
- Fai clic su Tariffario per il piano tariffario generico o per ciascun piano tariffario specifico del prodotto API.
Nota: quando configuri piani specifici per prodotto API, devi configurare un piano tariffario. singolarmente per ciascun prodotto API.
Si apre la finestra Tariffario.
- Configura un piano freemium per un prodotto API. Un piano freemium offre agli sviluppatori l'uso senza costi di una
API in un determinato periodo di tempo o in base alla quantità di utilizzo.
Immetti le seguenti informazioni:
Campo Descrizione Prodotto freemium? L'estensione del periodo libero. Seleziona uno dei seguenti pulsanti di opzione:
- Per quantità. Il periodo senza costi si basa su una quantità specificata nella sezione Volume .
- Per durata. Il periodo di tariffa si basa su un intervallo di tempo specificato nella campo Freemium Duration.
- L'evento che si verifica prima. Il periodo senza costi termina quando la quantità nel viene raggiunto il campo Volume o l'intervallo di tempo nel campo Durata freemium. a seconda dell'evento che si verifica per primo.
- No, non è un piano freemium. Questa è l'impostazione predefinita.
Volume freemium Il volume delle transazioni (o quello relativo a un attributo personalizzato registrato in il criterio di registrazione delle transazioni) per cui agli sviluppatori non viene addebitato alcun costo. Il volume è misurate per il prodotto API. Inserisci un numero di volume, ad esempio 5000. Ciò significa che Quando gli sviluppatori avviano il piano, le prime 5000 transazioni non vengono addebitate (o per i primi 5000 utilizzi di un articolo correlato all'attributo personalizzato). Questo campo è abilitato solo se si seleziona "Per quantità" o "Qualunque cosa venga prima" nel "Freemium" prodotto?". .
Durata freemium L'intervallo di tempo durante il quale gli sviluppatori non vengono addebitati. Inserisci un numero e seleziona un periodo di tempo, ad esempio 1 mese. Ciò significa che gli sviluppatori non addebitato per 1 mese. Questo campo viene attivato solo se selezioni "Per durata" o "Qualunque cosa venga prima" nel "prodotto freemium?" .
- Seleziona uno dei seguenti modelli di ricarica:
- Costo fisso. In questo modello, allo sviluppatore viene addebitata una tariffa fissa per ogni transazione.
- Volume a bande. In questo modello, allo sviluppatore viene addebitata una tariffa variabile in base al volume di transazioni.
- Pacchetti. In questo modello, allo sviluppatore viene addebitato un importo prestabilito (in anticipo) per ogni un gruppo di transazioni. Allo sviluppatore viene addebitato l'importo impostato indipendentemente dal fatto che il pacchetto completamente usata.
Per il modello a costo fisso:inserisci le seguenti informazioni nella sezione Prezzi di nella finestra Tariffario generico:
Campo Descrizione Operatore (o organizzazione) Il nome della tua organizzazione. Questo campo viene preimpostato utilizzando l'operatore (o organizzazione) nel profilo dell'organizzazione.
Paese Il paese in cui opera la tua organizzazione. Questo campo viene preimpostato utilizzando Valore del campo Paese nel profilo dell'organizzazione.
Costo fisso La tariffa addebitata per ogni transazione. Inserisci un numero decimale (massimo quattro cifre decimali).
Nota: puoi configurare il numero di posizioni decimali che è possibile specificare per la tariffa addebitata utilizzando l'API (non l'interfaccia utente). Per maggiori dettagli, vedi Configura il numero di posizioni decimali per le tariffe dei piani tariffari.
Ad esempio, se inserisci 0, 10 e la valuta è il dollaro statunitense, lo sviluppatore addebitato 0,10 $per ogni transazione (o se in base a un attributo personalizzato come di byte trasmessi in una transazione, allo sviluppatore vengono addebitati 0,10 $ che trasmette il numero specificato di byte).
Per il modello a bande di volume: la finestra Tariffario generico mostra ulteriori campi utilizzati per specificare una base per l'aggregazione e le "bande di volume", che intervalli di volume delle transazioni per i quali puoi applicare tariffe diverse.
Questo tipo di piano in genere è impostato per incoraggiare gli sviluppatori a generare volumi più elevati tramite che offrono tariffe scontate per bande ad alto volume.
Inserisci le seguenti informazioni nella finestra Tariffario generico:
Campo Descrizione Base di aggregazione Il periodo di tempo durante il quale il volume di transazioni (o relativo agli attributi) vengono aggregati. Il volume aggregato viene utilizzato per identificare la banda del volume e la tariffa da applicare a ogni transazione. Seleziona un numero di mesi (1-12 mesi).
Per informazioni dettagliate su quando vengono reimpostati i pacchetti, consulta la sezione Se sono ricorrenti le tariffe addebitate e i piani pacchetto vengono reimpostati?
Bande di volume Uno o più intervalli di volume delle transazioni (o in base agli attributi del cliente) (ogni intervallo è una "banda di volume"). A ogni banda di volume può essere assegnata una frequenza (puoi impostarla in nel campo Bande di volume della sezione Prezzi. La tariffa viene applicata a tutti transazioni nella banda del volume applicabile. Specifica il limite superiore del primo banda, ad esempio, fino a 1000 (il limite inferiore è preimpostato su un valore maggiore di 0). Fai clic su + per aggiungere una seconda banda, ad esempio maggiore di 1000 fino a 2000. Fai clic su + per aggiungerne altre cinturini. Puoi lasciare vuoto il limite superiore della banda finale per indicare tutte le transazioni al di sopra di questo livello.
Prezzi Operatore (o organizzazione) Il nome della tua organizzazione. Questo campo viene preimpostato utilizzando l'operatore (o Organizzazione) nel profilo dell'organizzazione.
Paese Il paese in cui opera la tua organizzazione. Questo campo viene preimpostato utilizzando Valore del campo Paese nel profilo dell'organizzazione.
Valuta La "base" o valuta contabile della tua organizzazione. Questo campo è preimpostata utilizzando il valore del campo Valuta nel Profilo dell'organizzazione, ma può essere modificata qui.
Bande di volume La frequenza di una banda del volume. Devi specificare una frequenza per ogni banda del volume. Inserisci un valore per numero decimale per ogni banda (con un massimo di quattro cifre decimali).
Nota: puoi configurare il numero di posizioni decimali che è possibile specificare per la velocità di banda del volume usando l'API (non la UI). Per maggiori dettagli, vedi Configura il numero di posizioni decimali per le tariffe dei piani tariffari.
Ad esempio, se specifichi due bande di volume nella sezione Banda di volume (>0-1000, e 1000 e oltre), puoi inserire 0,15 per il volume >0-1000 e 0, 10 per la banda del volume pari o superiore a 1000. Se la valuta selezionata è gli Stati Uniti dollari, il tasso per le prime 1000 transazioni è di 0, 15 $per ogni transazione e per più di 1000 transazioni, la tariffa è di 0,10 $per ogni transazione.
Per il modello in bundle: la finestra Tariffario generico mostra campi aggiuntivi che che utilizzi per specificare una base per l'aggregazione (il periodo di tempo in cui lo sviluppatore può utilizzare gruppo di transazioni) e di specificare informazioni correlate, ad esempio la dimensione di un gruppo.
Inserisci le seguenti informazioni nella finestra Tariffario generico:
Campo Descrizione Base di aggregazione Il periodo di tempo in cui lo sviluppatore può utilizzare il pacchetto di transazioni (o utilizza un bundle personalizzato basato su attributi). Seleziona un numero di mesi (1-12 mesi). Dopo il giorno questo periodo, il piano scade e lo sviluppatore deve acquistare il piano (e i bundle) di nuovo.
Per informazioni dettagliate su quando vengono reimpostati i pacchetti, consulta la sezione Se sono ricorrenti le tariffe addebitate e i piani pacchetto vengono reimpostati?
Dimensione del set Il numero di transazioni in un pacchetto (o un numero correlato a un attributo personalizzato) come il numero totale di byte trasmessi in un bundle). Ogni bundle può essere assegnato un prezzo (puoi impostare questo prezzo nel campo Dimensione pacchetto della sezione Prezzi). La il prezzo si applica all'intero set. Specifica il limite superiore del primo bundle, per esempio, fino a 1000 (il limite inferiore è preimpostato su un valore maggiore di 0). Fai clic su + per aggiungere secondo bundle, ad esempio da 1000 a 2000. Fai clic su + per aggiungerne altre bundle. Devi specificare un limite massimo per l'ultimo bundle, a meno che tu non voglia addebitare allo sviluppatore un importo fisso per le transazioni illimitate negli ultimi gruppo.
Prezzi Operatore (o organizzazione) Il nome della tua organizzazione. Questo campo viene preimpostato utilizzando l'operatore (o Organizzazione) nel profilo dell'organizzazione.
Paese Il paese in cui opera la tua organizzazione. Questo campo viene preimpostato utilizzando Valore del campo Paese nel profilo dell'organizzazione.
Valuta La "base" o valuta contabile della tua organizzazione. Questo campo è preimpostata utilizzando il valore del campo Valuta nel Profilo dell'organizzazione, ma può essere modificata qui.
Dimensione bundle (prezzo) Il prezzo di un pacchetto. Devi specificare un prezzo per ogni set. Inserisci un numero decimale numero (con un massimo di quattro cifre decimali).
Nota: puoi configurare il numero di posizioni decimali che è possibile specificare per la tariffa bundle usando l'API (non l'UI). Per maggiori dettagli, vedi Configura il numero di posizioni decimali per le tariffe dei piani tariffari.
Ad esempio, se specifichi due pacchetti nella sezione Dimensioni del pacchetto (maggiori di 0 fino a 1000 e maggiore di 1000 fino a 2000), puoi inserire 50 per il maggiore da 0 a 1000 pacchetti e 40 per pacchetti da 1000 a 2000. Se la valuta selezionata è il dollaro statunitense, il prezzo del primo pacchetto è $50, mentre al secondo bundle, il prezzo è 40 $. Allo sviluppatore viene addebitato il prezzo pacchetto applicabile a prescindere dal numero di transazioni utilizzate all'interno del pacchetto (ovvero allo sviluppatore viene addebitato il prezzo del pacchetto alla prima transazione nel bundle viene completata.)
- Fai clic su Applica e chiudi per salvare i dettagli del tariffario e tornare al piano tariffario standard. finestra.
- Per i piani tariffari specifici dei prodotti API, configura i dettagli dei piani tariffari per altri prodotti API, come richiesto.
Configurare il piano tariffario utilizzando l'API
Configura i dettagli dei piani tariffari utilizzando l'API, come descritto nelle sezioni seguenti.
Specificare i dettagli dei piani tariffari utilizzando l'API
Puoi specificare i dettagli del piano tariffario al momento della sua creazione. Puoi specificare i dettagli in
la proprietà ratePlanDetails nel corpo della richiesta in una chiamata a
/organizations/{org_name}/monetization-packages/{package_id}/rate-plans. Cosa vuoi
specificare nella proprietà ratePlanDetails, dipende dal modello di ricarica scelto:
costo fisso, volume a bande o bundle.
Specificare un modello di ricarica a costo fisso
Per implementare il modello di addebito a costo fisso, specifica quanto segue nel piano tariffario dettagli:
- Un parametro di valutazione che indica che il piano tariffario è basato sulle transazioni
(
VOLUME) o in base a un attributo personalizzato (ad es.MINT_CUSTOM_ATTRIBUTE_1).VOLUMEè l'impostazione predefinita. - Un tipo di monitoraggio (
UNIT) che indica che la tariffa è fissa per unità (ovvero è che non si basa sul volume delle transazioni, come nel caso del volume in bande o modello di ricarica bundle). - Il periodo di scadenza del pagamento (ad es. 30 giorni).
- L'ID della tua organizzazione.
- La "base" o valuta contabile utilizzata dalla tua azienda.
- Tariffa del piano tariffario che fornisce dettagli su come viene calcolata l'aliquota. Poiché modello di addebito si basa su una tariffa fissa, devi specificare solo una tariffa del piano tariffario.
Nella tariffa del piano tariffario, specifichi:
- Il tipo di tariffa del piano tariffario (
RATECARD). - La tariffa per il piano. Ad esempio, se specifichi 0, 10 e la valuta è il dollaro statunitense, allo sviluppatore vengono addebitati 0,10 $per ogni transazione (o se in base a un attributo personalizzato come il numero di byte trasmessi in una transazione, allo sviluppatore vengono addebitati 0,10 $ che trasmette il numero specificato di byte).
- L'unità iniziale dell'applicazione della tariffa (
0). Ciò significa che la tariffa applicati a ogni transazione, a partire dalla prima.
Vedi Piano tariffario impostazioni di configurazione dei dettagli per un elenco completo delle opzioni di dettaglio dei piani tariffari.
Ad esempio, di seguito viene creato un piano tariffario con un modello di addebito fisso. La tariffa è impostato a 0,10 $per ogni transazione. Il pagamento deve essere effettuato entro 30 giorni. (I dettagli relativi ai tariffari sono 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
Specificare un modello di ricarica a banda larga
In un modello a bande del volume, specifichi i dettagli dei piani tariffari che includono uno o più piani tariffari tariffe, ciascuna tariffa si applica a una "banda di volume", ovvero a un intervallo di volume delle transazioni (o a un intervallo in base a un attributo personalizzato come il numero di byte trasmessi). Questo tipo di piano è solitamente impostati per incoraggiare gli sviluppatori a generare volumi più elevati offrendo tariffe scontate. per bande di volume più elevato.
Oltre alle tariffe del piano tariffario, nei dettagli del piano tariffario puoi specificare quanto segue:
- Un parametro di valutazione che indica che il piano tariffario è basato sulle transazioni
(
VOLUME) o in base a un attributo personalizzato (ad es.CUSTOM_ATTRIBUTE_1).VOLUMEè l'impostazione predefinita. - Un tipo di misurazione (
VOLUME) che indica che la frequenza si basa sul volume di transazioni (non è un costo fisso per transazione, come nel caso modello di ricarica a costo fisso). - Il periodo di scadenza del pagamento (ad es. 30 giorni).
- L'ID della tua organizzazione.
- La "base" o valuta contabile utilizzata dalla tua azienda.
- Un tipo di durata e durata che insieme specificano il periodo di tempo durante il quale il volume di transazioni (o volume correlato agli attributi personalizzati). Questo processo viene chiamato anche "base di aggregazione". Il volume delle transazioni viene aggregato in base alla base di aggregazione (ad ad esempio 1 mese) per determinare la banda del volume applicabile.
- Contatori di aggregazione utilizzati per determinare la banda di volume applicabile.
Per ogni tariffa del piano tariffario, devi specificare:
- Il tipo di tariffa del piano tariffario (
RATECARD). - La tariffa per il piano. Ad esempio, se specifichi 0, 10 e la valuta è il dollaro statunitense, allo sviluppatore vengono addebitati 0,15 $per ogni transazione (o se in base a un attributo personalizzato come di byte trasmessi in una transazione, allo sviluppatore vengono addebitati 0,15 $ che trasmette il numero specificato di byte).
- L'unità iniziale e finale della banda del volume. L'unità iniziale specifica il valore
limite della banda del volume e l'unità finale specifica il limite superiore della banda di volume. Per
Ad esempio, se specifichi un'unità iniziale pari a 0 e un'unità finale pari a 1000, la banda del volume copre
fino a 1000 transazioni nel periodo di aggregazione. Se la valuta è il dollaro statunitense,
periodo di aggregazione è 1 mese e il tasso per le prime 1000 transazioni è 0, 15,
allo sviluppatore vengono addebitati 0,15 $per transazione per un massimo di 1000 transazioni nel mese.
Per informazioni dettagliate su quando vengono reimpostati i pacchetti, consulta Quando vengono addebitate le tariffe ricorrenti e i piani bundle verranno reimpostati?
Se non specifichi un'unità finale per la banda del volume finale, la frequenza per quella banda sarà applicato a tutte le transazioni dopo che il numero di transazioni è superiore all'unità iniziale per quella band. Ad esempio, se l'unità iniziale per l'ultima banda è 1000 e non specifica un'unità finale per quella banda, la tariffa per la banda viene applicata a tutte le transazioni dopo 1000 transazioni nel periodo di aggregazione.
Vedi Piano tariffario impostazioni di configurazione dei dettagli per un elenco completo delle opzioni di dettaglio dei piani tariffari.
Ad esempio, di seguito viene creato un piano tariffario con un modello di ricarica a bande del volume. La è impostato su 0,15 $per le prime 1000 transazioni e di 0,10 $per tutte le transazioni oltre le 1000. La base di aggregazione è 1 mese. Il pagamento deve essere effettuato entro 30 giorni. (Dettagli del tariffario sono evidenziati.)
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
Specificare un modello di ricarica in bundle
In un modello di addebito in bundle, lo sviluppatore paga (in anticipo) un "pacchetto" di transazioni (o per un bundle in base a un attributo personalizzato come il numero di byte trasmessi). Devi specificare per ogni bundle e una base di aggregazione, ovvero un periodo di tempo in cui possono utilizzare il bundle.
Ad esempio, supponiamo che tu abbia impostato due pacchetti, dove la prima dimensione è compresa tra 1 e 1000 mentre una seconda dimensione del bundle è da 1001 a 2000 transazioni. La tariffa è di $50 per primo bundle e $40 per il secondo bundle; la base di aggregazione è 1. Se lo sviluppatore acquista un piano tariffario per il primo pacchetto, paga $50 (in anticipo) per 1000 transazioni in un mese. Allo sviluppatore viene addebitato l'importo impostato indipendentemente dal fatto che il bundle venga utilizzato o meno interamente. Al termine del periodo di aggregazione, il piano scade. Se lo sviluppatore vuole usare il bundle devono acquistare di nuovo il piano (e il pacchetto).
Le informazioni specificate nei dettagli del piano tariffario sono sostanzialmente identiche a quelle specificate nei dettagli del piano tariffario per il modello di ricarica con bande del volume. Le differenze sono le seguenti:
- Ogni piano tariffario specificato è destinato a un pacchetto anziché a una banda di volume.
- Devi specificare un limite massimo per l'ultimo pacchetto, a meno che tu non voglia ricaricare la sviluppatore un importo fisso per le transazioni illimitate nell'ultimo bundle.
Vedi Piano tariffario impostazioni di configurazione dei dettagli per un elenco completo delle opzioni di dettaglio dei piani tariffari.
Ad esempio, quanto segue crea un piano tariffario con un modello di addebito in bundle. La tariffa è impostato a 50 $per il primo bundle (fino a 1000 transazioni) e 40 $per il secondo bundle (più di 1000 transazioni) 1000 e fino a 2000 transazioni). La base di aggregazione è 1 mese. Il pagamento è in scadenza tra 30 giorni.
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
Specificare un piano freemium per singoli prodotti utilizzando l'API
In un piano tariffario, puoi impostare un piano freemium per un singolo prodotto (anziché per un un pacchetto API). Un piano freemium offre agli sviluppatori l'utilizzo senza costi di un prodotto API per un periodo di o in base alla quantità di utilizzo.
Quando configuri un piano freemium per un prodotto API, devi specificare nei dettagli del piano tariffario il periodo in cui lo sviluppatore può utilizzare le risorse fornite dal prodotto API senza costi ricarica. Il periodo può essere basato su uno dei seguenti fattori:
- Durata, ovvero il tempo che intercorre tra una data di validità e una data di fine.
- Quantità, ad esempio il numero di transazioni che coinvolgono il prodotto API o il volume relative a un attributo personalizzato registrato nel criterio di registrazione delle transazioni.
Se il periodo freemium si basa sulla quantità, specificala come numero di unità freemium. Per Ad esempio, di seguito viene creato un piano tariffario con un piano freemium basato su un volume di 5000 unità (le specifiche relative al freemium sono evidenziate.)
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