Stai visualizzando la documentazione di Apigee Edge.
Consulta la
documentazione di Apigee X. info
Introduzione
In un piano con tariffario, allo sviluppatore viene addebitato un costo per ogni transazione. Per questo tipo di piano, devi fornire ulteriori dettagli, come il modello di addebito e i prezzi per il modello di addebito.
Se vuoi, puoi specificare un piano freemium per singoli prodotti (anziché per un pacchetto API). Puoi farlo solo per un piano specifico per il prodotto.
Quando vengono addebitate le tariffe ricorrenti e quando vengono reimpostati i piani in bundle?
I piani tariffari possono includere tariffe ricorrenti e bundle di API (piani a volume e bundle), entrambi prevedono momenti specifici in cui vengono addebitate le tariffe e i piani bundle vengono reimpostati su zero. La tabella seguente descrive quando vengono addebitate le commissioni ricorrenti e quando vengono reimpostati i conteggi dei bundle. Se le app per sviluppatori non possono effettuare ulteriori chiamate API perché hanno raggiunto un determinato limite di transazioni, questi sono i momenti in cui i conteggi delle chiamate API vengono reimpostati su zero e le app possono iniziare a effettuare nuovamente chiamate.
| Se il piano ha… | ...this happens |
|---|---|
|
Il ripristino della commissione ricorrente e del piano bundle avviene il primo giorno del mese (impostazione predefinita). Per una ricorrenza mensile in un giorno specifico, crea un piano tariffario utilizzando l'API di gestione e indica il giorno con una proprietà |
|
Il ripristino della tariffa ricorrente e del piano bundle avviene ogni 7 giorni dopo la data di inizio del piano tariffario dello sviluppatore. |
|
Il ripristino della tariffa ricorrente e del piano bundle avviene ogni X giorni dopo la data di inizio del piano tariffario dello sviluppatore. |
|
I piani bundle vengono reimpostati in base alla base di aggregazione definita nella tariffa. Ad esempio, se uno sviluppatore avvia un piano tariffario il 19 del mese e la base di aggregazione è ogni mese, 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 un piano tariffario inizia il 31 dicembre, la data di ripristino diventa il 28 febbraio in un anno non bisestile perché febbraio ha solo 28 giorni. Il 28 rimane quindi il giorno di ripristino per sempre. |
Configurazione dei piani tariffari utilizzando l'interfaccia utente
Configura i piani tariffari come descritto di seguito.
Edge
Per configurare un piano tariffario, quando crei o modifichi un piano tariffario, seleziona il tipo di piano tariffario 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. |
| Volume Banded | Allo Sviluppatore viene addebitata una tariffa variabile a seconda del volume delle transazioni. |
| Bundle | Allo sviluppatore viene addebitato un importo fisso anticipato per ogni pacchetto di transazioni. Allo sviluppatore viene addebitato l'importo impostato indipendentemente dall'utilizzo completo del bundle.
Nota: questa opzione non è disponibile quando selezioni Tariffario e Condivisione delle entrate. |
Poi, configura le seguenti informazioni in base al modello di addebito selezionato.
| Modello di ricarica | Campo | Descrizione |
| Tutti | Frequenza di calcolo | Il periodo di tempo durante il quale viene calcolato il volume delle transazioni (o il volume correlato all'attributo personalizzato). 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 possono essere specificate per la tariffa addebitata utilizzando l'API (non la UI). Per maggiori dettagli, vedi Configurare il numero di cifre decimali per le tariffe dei piani tariffari. Ad esempio, se inserisci 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 $per la trasmissione del numero specificato di byte). |
| Volume Banded | Bande di volume | Uno o più intervalli di volume delle transazioni (o basati sugli attributi dei clienti) (ogni intervallo è una "fascia di volume") per il modello di addebito a fasce di volume. A ogni fascia di volume può essere assegnata una tariffa. 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 altre bande. 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 possono essere specificate per la tariffa addebitata utilizzando l'API (non la UI). Per maggiori dettagli, vedi Configurare il numero di cifre 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 superiori), puoi inserire 0,15 per la banda di volume >0-1000 e 0, 10 per la banda di volume 1000 e superiori. Se la valuta selezionata è il dollaro statunitense, la tariffa per le prime 1000 transazioni è di 0,15 $per transazione, mentre per più di 1000 transazioni è di 0,10 $per transazione. |
| Bundle | Prezzi dei bundle di API | Numero di transazioni in un bundle (o un numero correlato a un attributo personalizzato, ad esempio il numero totale di byte trasmessi in un bundle). A ogni bundle può essere assegnato un prezzo. Il prezzo si applica all'intero bundle. 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 superiore per l'ultimo bundle, a meno che tu non voglia addebitare allo sviluppatore un importo fisso per transazioni illimitate nell'ultimo bundle. Nota: puoi configurare il numero di cifre decimali che possono essere specificate per la tariffa addebitata utilizzando l'API (non la UI). Per maggiori dettagli, vedi Configurare il numero di cifre decimali per le tariffe dei piani tariffari. Ad esempio, se specifichi due bundle 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 bundle è di 50 $e quello del secondo è di 40 $. Allo sviluppatore viene addebitato il prezzo del bundle applicabile indipendentemente dal numero di transazioni utilizzate all'interno del bundle (ovvero, allo sviluppatore viene addebitato il prezzo del bundle non appena viene completata la prima transazione del bundle). |
Se hai definito attributi personalizzati per il tuo prodotto API, puoi configurare un parametro di valutazione personalizzato per addebitare allo sviluppatore di app un costo in base a un attributo personalizzato all'interno di 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, ad esempio il numero di byte trasmessi nel backend, che può variare in base alla transazione.
In questo caso, seleziona Utilizza parametro di valutazione personalizzato e seleziona l'attributo personalizzato dall'elenco a discesa. Per saperne di più, vedi Configurare il piano tariffario con attributi personalizzati.
Classic Edge (Private Cloud)
Per configurare i piani tariffari utilizzando l'interfaccia utente Edge classica:
- Segui i passaggi per creare un piano tariffario.
- Seleziona Tariffario nel menu 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 del piano tariffario per ogni prodotto API singolarmente.
- Piano generico per tutti i prodotti per configurare i dettagli del piano tariffario per tutti i prodotti API.
- Fai clic su Tariffario per il piano tariffario generico o per ogni piano tariffario specifico del prodotto API.
Nota: quando configuri piani specifici per i prodotti API, devi configurare un piano tariffario per ogni prodotto API singolarmente.
Si apre la finestra Tariffario.
- Configura un piano freemium per un prodotto API. Un piano freemium offre agli sviluppatori l'utilizzo senza costi di un prodotto API per un periodo di tempo o in base alla quantità di utilizzo.
Inserisci le seguenti informazioni:
Campo Descrizione Prodotto freemium? L'estensione del periodo senza costi. Seleziona uno dei seguenti pulsanti di opzione:
- Per quantità. Il periodo senza costi si basa su una quantità specificata nel campo Volume.
- Per durata. Il periodo di commissione si basa su un intervallo di tempo specificato nel campo Durata Freemium.
- A seconda di quale si verifica per prima. Il periodo senza costi termina quando viene raggiunta la quantità nel 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 di transazioni (o il volume relativo a un attributo personalizzato registrato nelle norme di registrazione delle transazioni) per cui gli sviluppatori non vengono addebitati. Il volume viene misurato per il prodotto API. Inserisci un numero di volume, ad esempio 5000. Ciò significa che quando gli sviluppatori iniziano il piano, non vengono addebitati costi per le prime 5000 transazioni (o per i primi 5000 utilizzi di un elemento correlato a un attributo personalizzato). Questo campo è abilitato solo se selezioni "Per quantità" o "Quale si verifica per primo" nel campo "Prodotto freemium?".
Durata del freemium L'intervallo di tempo durante il quale agli sviluppatori non vengono addebitati costi. Inserisci un numero e seleziona un periodo di tempo, ad esempio 1 mese. Ciò significa che agli sviluppatori non vengono addebitati costi per 1 mese. Questo campo è attivato solo se selezioni "Per durata" o "Ciò che si verifica per primo" nel campo "Prodotto freemium?".
- Seleziona uno dei seguenti modelli di addebito:
- Tariffa fissa. 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 a seconda del volume delle transazioni.
- Bundle. In questo modello, allo sviluppatore viene addebitato un importo fisso (anticipato) per ogni pacchetto di transazioni. Allo sviluppatore viene addebitato l'importo impostato indipendentemente dal fatto che il bundle venga utilizzato interamente.
Per il modello a tariffa fissa:inserisci le seguenti informazioni nella sezione Prezzi della finestra Listino prezzi generico:
Campo Descrizione Operatore (o organizzazione) Il nome della tua organizzazione. Questo campo è preimpostato utilizzando il valore del campo Operatore (o Organizzazione) nel profilo dell'organizzazione.
Paese Il paese in cui opera la tua organizzazione. Questo campo è preimpostato utilizzando il valore del campo Paese nel profilo dell'organizzazione.
Costo fisso Il tasso addebitato per ogni transazione. Inserisci un numero decimale (con un massimo di quattro cifre decimali).
Nota: puoi configurare il numero di cifre decimali che possono essere specificate per la tariffa addebitata utilizzando l'API (non la UI). Per maggiori dettagli, vedi Configurare il numero di cifre decimali per le tariffe dei piani tariffari.
Ad esempio, se inserisci 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 $per la trasmissione del numero specificato di byte).
Per il modello a fasce di volume:la finestra Tariffario generico mostra campi aggiuntivi che utilizzi per specificare una base per l'aggregazione e per specificare le "fasce di volume", ovvero intervalli di volume delle transazioni a cui puoi applicare tariffe diverse.
Questo tipo di piano viene solitamente configurato per incoraggiare gli sviluppatori a generare volumi più elevati offrendo tariffe scontate per le bande di volumi più elevate.
Inserisci le seguenti informazioni nella finestra Tariffario generico:
Campo Descrizione Base di aggregazione Il periodo di tempo durante il quale viene aggregato il volume delle transazioni (o il volume correlato all'attributo personalizzato). Il volume aggregato viene utilizzato per identificare la fascia di volume e la tariffa da applicare a ogni transazione. Seleziona un numero di mesi (1-12 mesi).
Per informazioni dettagliate su quando vengono ripristinati i bundle, vedi Quando vengono addebitate le tariffe ricorrenti e ripristinati i piani bundle?
Bande di volume Uno o più intervalli di volume delle transazioni (o basati sugli attributi dei clienti) (ogni intervallo è una "fascia di volume"). A ogni fascia di volume può essere assegnata una tariffa (che imposti nel campo Fasce di volume della sezione Prezzi). 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 + per aggiungere una seconda banda, ad esempio maggiore di 1000 fino a 2000. Fai clic su + per aggiungere altre bande. 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 è preimpostato utilizzando il valore del campo Operatore (o Organizzazione) nel profilo dell'organizzazione.
Paese Il paese in cui opera la tua organizzazione. Questo campo è preimpostato utilizzando il valore del campo Paese nel profilo dell'organizzazione.
Valuta La valuta "di base" o contabile utilizzata dalla tua organizzazione. Questo campo è preimpostato utilizzando il valore del campo Valuta nel profilo dell'organizzazione, ma può essere modificato qui.
Bande di volume La tariffa per una banda di volume. Specifichi una tariffa per ogni fascia di volume. Inserisci un numero decimale per ogni banda (con un massimo di quattro cifre decimali).
Nota: puoi configurare il numero di cifre decimali che possono essere specificate per la tariffa della banda di volume utilizzando l'API (non la UI). Per maggiori dettagli, vedi Configurare il numero di cifre 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 la banda di volume >0-1000 e 0, 10 per la banda di volume 1000 e oltre. Se la valuta selezionata è il dollaro statunitense, la tariffa per le prime 1000 transazioni è di 0, 15 $per transazione e per più di 1000 transazioni è di 0, 10 $per transazione.
Per il modello in bundle:la finestra Listino prezzi generico mostra campi aggiuntivi che utilizzi per specificare una base per l'aggregazione (il periodo di tempo in cui lo sviluppatore può utilizzare il bundle di transazioni) e per specificare informazioni relative al bundle, ad esempio le dimensioni di un bundle.
Inserisci le seguenti informazioni nella finestra Tariffario generico:
Campo Descrizione Base di aggregazione Il periodo di tempo in cui lo sviluppatore può utilizzare il bundle di transazioni (o utilizzare un bundle personalizzato basato sugli attributi). Seleziona un numero di mesi (da 1 a 12 mesi). Al termine di questo periodo, il piano scade e lo sviluppatore deve acquistare di nuovo il piano (e i bundle).
Per informazioni dettagliate su quando vengono ripristinati i bundle, vedi Quando vengono addebitate le tariffe ricorrenti e ripristinati i piani bundle?
Dimensioni del bundle Il 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 (che imposti nel campo Dimensioni pacchetto della sezione Prezzi). Il prezzo si applica all'intero bundle. 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 + per aggiungere un secondo bundle, ad esempio maggiore di 1000 e fino a 2000. Fai clic su + per aggiungere altri bundle. Devi specificare un limite superiore per l'ultimo bundle, a meno che tu non voglia addebitare allo sviluppatore un importo fisso per transazioni illimitate nell'ultimo bundle.
Prezzi Operatore (o organizzazione) Il nome della tua organizzazione. Questo campo è preimpostato utilizzando il valore del campo Operatore (o Organizzazione) nel profilo dell'organizzazione.
Paese Il paese in cui opera la tua organizzazione. Questo campo è preimpostato utilizzando il valore del campo Paese nel profilo dell'organizzazione.
Valuta La valuta "di base" o contabile utilizzata dalla tua organizzazione. Questo campo è preimpostato utilizzando il valore del campo Valuta nel profilo dell'organizzazione, ma può essere modificato qui.
Dimensione del bundle (prezzo) Il prezzo di un pacchetto. Specifichi un prezzo per ogni pacchetto. Inserisci un numero decimale (con un massimo di quattro cifre decimali).
Nota: puoi configurare il numero di cifre decimali che possono essere specificate per la tariffa del bundle utilizzando l'API (non la UI). Per maggiori dettagli, vedi Configurare il numero di cifre decimali per le tariffe dei piani tariffari.
Ad esempio, se specifichi due bundle 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 bundle è di 50 $e quello del secondo è di 40 $. Allo sviluppatore viene addebitato il prezzo del pacchetto applicabile indipendentemente dal numero di transazioni utilizzate all'interno del pacchetto (ovvero, allo sviluppatore viene addebitato il prezzo del pacchetto non appena viene completata la prima transazione del pacchetto).
- Fai clic su Applica e chiudi per salvare i dettagli della tariffa e tornare alla finestra del piano tariffario standard.
- Per i piani tariffari specifici per i prodotti API, configura i dettagli del piano tariffario per i prodotti API aggiuntivi, se necessario.
Configurazione del piano tariffario utilizzando l'API
Configura i dettagli del piano tariffario utilizzando l'API, come descritto nelle sezioni seguenti.
Specificare i dettagli del piano tariffario utilizzando l'API
Specifichi i dettagli del piano tariffario quando crei il piano. Specifichi i dettagli nella proprietà ratePlanDetails all'interno del corpo della richiesta in una chiamata a /organizations/{org_name}/monetization-packages/{package_id}/rate-plans. Ciò che specifichi nella proprietà ratePlanDetails dipende dal modello di addebito che scegli: costo fisso, a scaglioni di volume o bundle.
Specifica di un modello di tariffazione a costo fisso
Per implementare il modello di addebito a costo fisso, specifica quanto segue nei dettagli del piano tariffario:
- Un parametro di valutazione che indica che il piano tariffario si basa sulle transazioni
(
VOLUME) o su un attributo personalizzato (ad esempio,MINT_CUSTOM_ATTRIBUTE_1).VOLUMEè il valore predefinito. - Un tipo di misurazione (
UNIT) che indica che la tariffa è fissa per unità (ovvero non si basa sul volume delle transazioni, come nel caso del modello di addebito a fasce di volume o dei bundle). - Il periodo di scadenza del pagamento (ad esempio, 30 giorni).
- L'ID della tua organizzazione.
- La valuta "base" o contabile utilizzata dalla tua azienda.
- Una tariffa del piano tariffario che fornisce dettagli su come viene calcolata la tariffa. Poiché il modello di addebito si basa su una tariffa fissa, devi specificare una sola tariffa del piano tariffario.
Nella tariffa del piano tariffario, specifica:
- Il tipo di tariffa del piano tariffario (
RATECARD). - La tariffa del 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 $per la trasmissione del numero di byte specificato).
- L'unità iniziale dell'applicazione della tariffa (
0). Ciò significa che la tariffa viene applicata a ogni transazione, a partire dalla prima.
Consulta Impostazioni di configurazione dei dettagli del piano tariffario per un elenco completo delle opzioni dei dettagli del piano tariffario.
Ad esempio, il seguente comando crea un piano tariffario con un modello di addebito fisso. La tariffa è fissata a 0,10 $per ogni transazione. Il pagamento è dovuto entro 30 giorni. (I dettagli relativi al tariffario sono evidenziati.)
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
Specifica di un modello di tariffazione a volumi
In un modello a bande di volume, specifichi i dettagli del piano tariffario che includono una o più tariffe del piano tariffario, ciascuna delle quali si applica a una "banda di volume", ovvero un intervallo di volume delle transazioni (o un intervallo basato su un attributo personalizzato come il numero di byte trasmessi). Questo tipo di piano di solito è configurato per incoraggiare gli sviluppatori a generare volumi più elevati offrendo tariffe scontate per le fasce di volumi più elevate.
Oltre alle tariffe del piano tariffario, nei dettagli del piano tariffario devi specificare quanto segue:
- Un parametro di valutazione che indica che il piano tariffario si basa sulle transazioni
(
VOLUME) o su un attributo personalizzato (ad esempio,CUSTOM_ATTRIBUTE_1).VOLUMEè il valore predefinito. - Un tipo di misurazione (
VOLUME) che indica che la tariffa si basa sul volume di transazioni (ovvero non è un costo fisso per transazione, come nel caso del modello di addebito a costo fisso). - Il periodo di scadenza del pagamento (ad esempio, 30 giorni).
- L'ID della tua organizzazione.
- La valuta "base" o contabile utilizzata dalla tua azienda.
- Una durata e un tipo di durata che insieme specificano il periodo di tempo durante il quale viene aggregato il volume di transazioni (o il volume correlato all'attributo personalizzato). Questo è anche chiamato "base di aggregazione". Il volume delle transazioni viene aggregato in base alla base di aggregazione (ad esempio, 1 mese) per determinare la banda di volume applicabile.
- Contatori di aggregazione utilizzati per determinare la banda di volume applicabile.
Per ogni tariffa del piano tariffario, specifica:
- Il tipo di tariffa del piano tariffario (
RATECARD). - La tariffa del 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 il numero di byte trasmessi in una transazione, allo sviluppatore vengono addebitati 0,15 $per la trasmissione del numero di byte specificato).
- L'unità iniziale e finale della banda di volume. L'unità iniziale specifica il limite inferiore della banda di volume, mentre l'unità finale specifica il limite superiore della banda di volume. Ad
esempio, se specifichi un'unità iniziale di 0 e un'unità finale di 1000, la banda di volume copre
fino a 1000 transazioni nel periodo di aggregazione. Se la valuta è il dollaro statunitense, il periodo di aggregazione è di 1 mese e la tariffa per le prime 1000 transazioni è 0,15, allo sviluppatore vengono addebitati 0,15 $per transazione fino a 1000 transazioni nel mese.
Per informazioni dettagliate su quando vengono ripristinati i bundle, vedi Quando vengono addebitate le tariffe ricorrenti e vengono ripristinati i piani bundle?
Se non specifichi un'unità finale per la banda di volume finale, la tariffa per quella banda viene applicata a tutte le transazioni dopo che il numero di transazioni ha superato l'unità iniziale per quella banda. Ad esempio, se l'unità iniziale dell'ultima banda è 1000 e non specifici un'unità finale per quella banda, la tariffa della banda viene applicata a tutte le transazioni dopo 1000 transazioni nel periodo di aggregazione.
Consulta Impostazioni di configurazione dei dettagli del piano tariffario per un elenco completo delle opzioni dei dettagli del piano tariffario.
Ad esempio, il seguente codice crea un piano tariffario con un modello di addebito a fasce di volume. La tariffa è fissata a 0,15 $per le prime 1000 transazioni e a 0,10 $per tutte le transazioni successive. La base di aggregazione è un mese. Il pagamento è dovuto entro 30 giorni. (I 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
Specifica di un modello di ricarica in bundle
In un modello di addebito in bundle, lo sviluppatore paga (in anticipo) un "bundle" di transazioni (o un bundle basato su un attributo personalizzato come il numero di byte trasmessi). Specifichi una tariffa per ogni bundle e una base di aggregazione, ovvero un periodo di tempo in cui lo sviluppatore può utilizzare il bundle.
Ad esempio, supponiamo di configurare due pacchetti, in cui la dimensione del primo pacchetto è da 1 a 1000 transazioni e la dimensione del secondo pacchetto è da 1001 a 2000 transazioni. La tariffa è di 50 $per il primo bundle e di 40 $per il secondo, mentre la base di aggregazione è 1. Se lo sviluppatore acquista un piano con tariffario per il primo bundle, 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 interamente o meno. Al termine del periodo di aggregazione, il piano scade. Se lo sviluppatore vuole utilizzare di nuovo il pacchetto, deve acquistare di nuovo il piano (e il pacchetto).
Ciò che specifichi nei dettagli del piano tariffario è essenzialmente lo stesso che specifichi nei dettagli del piano tariffario per il modello di addebito a fasce di volume. Le differenze sono le seguenti:
- Ogni piano tariffario specificato è per un bundle (anziché per una fascia di volume).
- Devi specificare un limite superiore per l'ultimo bundle, a meno che tu non voglia addebitare allo sviluppatore un importo fisso per transazioni illimitate nell'ultimo bundle.
Consulta Impostazioni di configurazione dei dettagli del piano tariffario per un elenco completo delle opzioni dei dettagli del piano tariffario.
Ad esempio, il seguente comando crea un piano tariffario con un modello di addebito in bundle. La tariffa è fissata a 50 $per il primo pacchetto (fino a 1000 transazioni) e a 40 $per il secondo pacchetto (più di 1000 e fino a 2000 transazioni). La base di aggregazione è un mese. Il pagamento è dovuto entro 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
Specifica di un piano freemium per singoli prodotti utilizzando l'API
In un piano tariffario, puoi configurare un piano freemium per un singolo prodotto (anziché per un pacchetto API). Un piano freemium offre agli sviluppatori l'utilizzo senza costi di un prodotto API per un periodo di tempo o in base alla quantità di utilizzo.
Quando configuri un piano freemium per un prodotto API, specifichi nei dettagli del piano della scheda tariffaria il periodo in cui lo sviluppatore può utilizzare le risorse fornite dal prodotto API senza costi. Il periodo può essere basato su uno dei seguenti elementi:
- Durata, ovvero il periodo di tempo compreso 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 relativo a un attributo personalizzato registrato nelle norme di registrazione delle transazioni.
Se il periodo freemium si basa sulla quantità, specificala come numero di unità freemium. Ad esempio, il seguente comando crea un piano con 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