Configura il piano tariffario

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X.
informazioni

Introduzione

In un piano tariffario, allo sviluppatore viene addebitata ogni transazione. Per questo tipo di piano, devi fornire ulteriori dettagli, come il modello di addebito e i prezzi.

Facoltativamente, puoi specificare un piano freemium per singoli prodotti (anziché per un pacchetto API). Puoi farlo solo per un piano specifico del prodotto.

Quando vengono addebitate le tariffe ricorrenti e i piani pacchetto vengono reimpostati?

I piani tariffari possono includere tariffe ricorrenti, nonché pacchetti di API (piani con fasce di volume e piani bundle), entrambi prevedono tempi specifici in cui vengono addebitate le tariffe e i piani bundle vengono reimpostati a zero. La tabella seguente descrive quando vengono addebitate tariffe ricorrenti e il conteggio dei pacchetti viene reimpostato. Se alle app sviluppatore viene impedito di effettuare ulteriori chiamate API perché viene raggiunto un determinato limite di transazioni, in questi casi il conteggio delle chiamate API viene reimpostato su zero e le app possono iniziare di nuovo a effettuare chiamate.

Se il piano ha... ...questo succede
  • Una tariffa ricorrente diversa da zero impostata su Mese
  • Un piano a bande di volume o bundle

La tariffa ricorrente e il piano del pacchetto vengono reimpostati 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à RecurringStartUnit, come descritto in Creare piani tariffari utilizzando l'API.

  • Una tariffa ricorrente diversa da zero impostata su Settimana
  • Un piano a bande di volume o bundle
La reimpostazione della tariffa ricorrente e del piano pacchetto avviene ogni 7 giorni dopo la data di inizio del piano tariffario dello sviluppatore.
  • Una tariffa ricorrente diversa da zero impostata su Giorno.
  • Un piano a bande di volume o bundle
La reimpostazione della tariffa ricorrente e del piano pacchetto avviene ogni X giorni dopo la data di inizio del piano tariffario dello sviluppatore.
  • Nessuna commissione ricorrente (o pari a zero dollari)
  • Un piano a bande di volume o bundle

I piani pacchetto vengono reimpostati sulla base della base di aggregazione definita nel tariffario. Ad esempio, se uno sviluppatore avvia un piano tariffario il 19 del mese e la base di aggregazione è ogni mese, l'utilizzo del pacchetto viene reimpostato il giorno 19 di ogni mese.

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 reimpostazione diventa il 28 di febbraio di un anno non bisestile, poiché febbraio avrà solo 28 giorni. Il 28 rimane il giorno successivo al ripristino.

Configurare i piani tariffari utilizzando l'interfaccia utente

Configura i piani tariffari come descritto di seguito.

Perimetrale

Per configurare un piano tariffario, quando crei o modifichi un piano tariffario, seleziona il tipo di piano tariffario Tariffario o Tariffario e condivisione delle entrate e, nella sezione Tariffario, selezionare uno dei seguenti modelli di addebito:

Modello di ricarica Descrizione
Costo fisso Allo sviluppatore viene addebitata una tariffa fissa per ogni transazione.
Banda del volume Allo sviluppatore viene addebitata una tariffa variabile in base al volume delle transazioni.
Bundles 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 interamente 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 addebito selezionato.

Modello di ricarica Campo Descrizione
Tutte Frequenza di calcolo Periodo di tempo durante il quale viene calcolato il volume delle transazioni (o il volume relativo agli attributi personalizzati). Seleziona un numero di mesi (da 1 a 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 posizioni decimali che possono essere specificate per la tariffa addebitata utilizzando l'API (non l'interfaccia utente). Per maggiori dettagli, consulta Configurare il numero di cifre decimali per le tariffe del piano tariffario.

Ad esempio, se inserisci 0,10 e la valuta è 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 di byte specificato).

Banda del volume Bande di volume Uno o più intervalli di volume delle transazioni (o in base agli attributi del cliente) (ogni intervallo è una "banda di volume") per il modello di ricarica con banda a volume. A ogni banda di volume può essere assegnata una frequenza. Il tasso viene applicato 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 posizioni decimali che possono essere specificate per la tariffa addebitata utilizzando l'API (non l'interfaccia utente). Per maggiori dettagli, consulta Configurare il numero di cifre decimali per le tariffe del piano tariffario.

Ad esempio, se specifichi due bande di volume nella sezione Banda del volume (>0-1000, 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 è il dollaro statunitense, 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.

Bundles Prezzi bundle API Numero di transazioni in un bundle (o un numero relativo a un attributo personalizzato, ad esempio 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 massimo per il primo bundle, ad esempio fino a 1000 (il limite inferiore è preimpostato su un valore maggiore di 0).

Fai clic su +Nuovo per aggiungere altri pacchetti. Devi specificare un limite massimo per l'ultimo pacchetto, a meno che tu non voglia addebitare allo sviluppatore un importo fisso per le transazioni illimitate nell'ultimo pacchetto.

Nota: puoi configurare il numero di posizioni decimali che possono essere specificate per la tariffa addebitata utilizzando l'API (non l'interfaccia utente). Per maggiori dettagli, consulta Configurare il numero di cifre decimali per le tariffe del piano tariffario.

Ad esempio, se specifichi due pacchetti nella sezione Dimensioni pacchetto (maggiori di 0 fino a 1000 e maggiori di 1000 fino a 2000), puoi inserire 50 per il gruppo maggiore di 0 fino a 1000 e 40 per il gruppo maggiore di 1000-2000. Se la valuta selezionata è in dollari statunitensi, il prezzo del primo pacchetto è di 50 $e di 40 $per il secondo. Allo sviluppatore viene addebitato il prezzo del pacchetto applicabile indipendentemente dal numero di transazioni utilizzate all'interno del pacchetto (vale a dire, allo sviluppatore viene addebitato il prezzo del pacchetto 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 personalizzato per addebitare gli importi allo sviluppatore dell'app in base a un attributo personalizzato in ogni transazione. Ad esempio, se imposti 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 nel backend, che può variare a seconda della transazione.

In questo caso, seleziona Utilizza parametro di valutazione personalizzato e scegli l'attributo personalizzato dall'elenco a discesa. Per saperne di più, consulta Configurare il piano tariffario con attributi personalizzati.

Classic Edge (private cloud)

Per configurare i piani tariffari utilizzando l'interfaccia utente classica di Edge:

  1. Segui la procedura per creare un piano tariffario.
  2. Seleziona Tariffario nel menu a discesa Tipo di piano tariffario per configurare il modello di entrate.
  3. Se il pacchetto API selezionato include più prodotti API, seleziona una delle seguenti opzioni:

    Nota: se il pacchetto API include un solo prodotto API, puoi saltare questo passaggio.

    • Piani specifici per prodotto per configurarne i dettagli per ogni singolo prodotto API.
    • Piano generico per tutti i prodotti per configurare i dettagli del piano tariffario per tutti i prodotti basati su API.
  4. Fai clic su Tariffario per il piano tariffario generico o per ogni piano tariffario specifico del prodotto API.

    Nota: quando configuri piani specifici per prodotto API, devi configurare un piano tariffario per ciascun prodotto API singolarmente.

    Si apre la finestra Tariffario.

  5. Configurare un piano freemium per un prodotto API. Un piano freemium offre agli sviluppatori l'uso senza costi di un prodotto API per un determinato periodo di tempo o in base alla quantità di utilizzo.

    Immetti le seguenti informazioni:

    Campo Descrizione
    un prodotto freemium?

    La durata 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 tariffa si basa su un intervallo di tempo specificato nel campo Freemium Duration.
    • L'evento che si verifica per primo. 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. Questo non è un piano freemium. Questa è l'impostazione predefinita.
    Volume freemium

    Il volume di transazioni (o relativo a un attributo personalizzato registrato nella norma di registrazione delle transazioni) per cui non viene addebitato agli sviluppatori. Il volume viene misurato per il prodotto API. Inserisci un numero di volume, ad esempio 5000. Ciò significa che, quando gli sviluppatori avviano il piano, non vengono addebitate le prime 5000 transazioni (o i primi 5000 utilizzi di un articolo correlato ad attributi personalizzati). Questo campo è abilitato solo se selezioni "Per quantità" o "Qual è la prima cosa" nel campo "Prodotto freemium?".

    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 agli sviluppatori non viene addebitato alcun costo per 1 mese. Questo campo è abilitato solo se selezioni "Per durata" o "Qual è la prima cosa" nel campo "Prodotto freemium?".

  6. 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 pacchetto di transazioni. Allo sviluppatore viene addebitato l'importo impostato indipendentemente dal fatto che il bundle venga utilizzato interamente o meno.

    Per il modello a costo fisso: inserisci le seguenti informazioni nella sezione Prezzi della finestra Tariffario 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

    La tariffa addebitata per ogni transazione. Inserisci un numero decimale (con un massimo di quattro cifre decimali).

    Nota: puoi configurare il numero di posizioni decimali che possono essere specificate per la tariffa addebitata utilizzando l'API (non l'UI). Per maggiori dettagli, consulta Configurare il numero di cifre decimali per le tariffe del piano tariffario.

    Ad esempio, se inserisci 0,10 e la valuta è 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 di byte specificato).

    Per il modello con fasce di volume: la finestra Tariffario generico mostra campi aggiuntivi che puoi utilizzare per specificare una base per l'aggregazione e le "fasce di volume", ovvero intervalli di volume di transazioni a cui puoi applicare tariffe diverse.

    Questo tipo di piano viene generalmente configurato per incoraggiare gli sviluppatori a generare volumi più elevati offrendo tariffe scontate per fasce di volume 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 di transazioni (o il volume relativo agli attributi personalizzati). Il volume aggregato viene utilizzato per identificare la banda di volume e la tariffa da applicare a ogni transazione. Seleziona un numero di mesi (1-12 mesi).

    Per maggiori dettagli su quando vengono reimpostati i pacchetti, vedi Quando vengono addebitate le tariffe ricorrenti e vengono reimpostati i piani pacchetto?

    Cinturini di volume

    Uno o più intervalli di volume di transazioni (o in base agli attributi del cliente) (ogni intervallo è una "banda di volume"). A ogni banda di volume può essere assegnata una tariffa (puoi impostarla nel campo Bande di volume della sezione Prezzi). Il tasso viene applicato 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 da 1000 a 2000. Fai clic su + per aggiungere altri 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 è 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 in 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 frequenza per una banda di volume. Specifica una frequenza per ogni banda di volume. Inserisci un numero decimale per ogni banda (con un massimo di quattro cifre decimali).

    Nota: puoi configurare il numero di posizioni decimali che possono essere specificate per la frequenza della banda di volume utilizzando l'API (non l'UI). Per maggiori dettagli, consulta Configurare il numero di cifre decimali per le tariffe del piano tariffario.

    Ad esempio, se specifichi due bande di volume nella sezione Banda del volume (> 0-1000, 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 statunitensi, 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.

    Per il modello in bundle: la finestra Tariffario generico mostra campi aggiuntivi che puoi utilizzare per specificare una base per l'aggregazione (il periodo di tempo in cui lo sviluppatore può utilizzare il pacchetto di transazioni) e informazioni relative a un pacchetto, ad esempio le dimensioni di un pacchetto.

    Inserisci le seguenti informazioni nella finestra Tariffario generico:

    Campo Descrizione
    Base di aggregazione

    Il periodo di tempo durante il quale lo sviluppatore può utilizzare il pacchetto di transazioni (o un pacchetto basato su attributi personalizzati). Seleziona un numero di mesi (da 1 a 12 mesi). Dopo questo periodo, il piano scade e lo sviluppatore deve acquistare di nuovo il piano (e i pacchetti).

    Per maggiori dettagli su quando vengono reimpostati i pacchetti, vedi Quando vengono addebitate le tariffe ricorrenti e vengono reimpostati i piani pacchetto?

    Dimensione del set

    Il numero di transazioni in un bundle (o un numero relativo a un attributo personalizzato, ad esempio il numero totale di byte trasmessi in un bundle). A ogni pacchetto può essere assegnato un prezzo (puoi impostare questo prezzo nel campo Dimensione pacchetto della sezione Prezzi). 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 + per aggiungere un secondo bundle, ad esempio da 1000 a 2000. Fai clic su + per aggiungere altri pacchetti. 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 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 in 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.

    Dimensioni set (prezzo)

    Il prezzo di un pacchetto. Devi specificare un prezzo per ogni pacchetto. Inserisci un numero decimale (con un massimo di quattro cifre decimali).

    Nota: puoi configurare il numero di posizioni decimali che possono essere specificate per la tariffa pacchetto utilizzando l'API (non l'UI). Per maggiori dettagli, consulta Configurare il numero di cifre decimali per le tariffe del piano tariffario.

    Ad esempio, se specifichi due pacchetti nella sezione Dimensioni pacchetto (maggiori di 0 fino a 1000 e maggiori di 1000 fino a 2000), puoi inserire 50 per il gruppo maggiore di 0 fino a 1000 e 40 per il gruppo maggiore di 1000-2000. Se la valuta selezionata è in dollari statunitensi, il prezzo del primo pacchetto è di 50 $, mentre per il secondo il prezzo è di 40 $. Allo sviluppatore viene addebitato il prezzo del pacchetto applicabile indipendentemente dal numero di transazioni utilizzate all'interno del pacchetto (vale a dire che il prezzo del pacchetto viene addebitato allo sviluppatore non appena viene completata la prima transazione nel pacchetto).

  7. Fai clic su Applica e chiudi per salvare i dettagli del tariffario e tornare alla finestra del piano tariffario standard.
  8. Per i piani tariffari specifici del prodotto con API, configura i dettagli del piano tariffario per prodotti basati su API aggiuntivi, come richiesto.

Configurare il piano tariffario utilizzando l'API

Configura i dettagli del piano tariffario utilizzando l'API, come descritto nelle sezioni seguenti.

Specificare i dettagli dei piani tariffari utilizzando l'API

I dettagli del piano tariffario vengono specificati al momento della creazione del piano tariffario. Puoi specificare i dettagli nella proprietà ratePlanDetails all'interno del corpo della richiesta in una chiamata a /organizations/{org_name}/monetization-packages/{package_id}/rate-plans. Le informazioni specificate nella proprietà ratePlanDetails dipendono dal modello di addebito scelto: tariffa fissa, con fasce di volume o bundle.

Specifica di un modello di ricarica a costo fisso

Per implementare il modello di addebito a costo fisso, devi specificare 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 è l'attributo predefinito.
  • Un tipo di misurazione (UNIT) che indica che la tariffa è fissa per unità (vale a dire, non si basa sul volume di transazioni, come nel caso del modello di addebito a bande di volume o di bundle).
  • Il periodo di scadenza del pagamento (ad esempio 30 giorni).
  • L'ID della tua organizzazione.
  • La valuta di base o contabile utilizzata dalla tua azienda.
  • Una tariffa del piano tariffario che fornisce dettagli su come viene calcolata. Poiché il modello di addebito si basa su una tariffa fissa, specifichi una sola tariffa del piano tariffario.

Nella 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 è 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 di byte specificato).
  • L'unità iniziale dell'applicazione delle tariffe (0). Ciò significa che la tariffa viene applicata a ogni transazione, a partire dalla prima.

Consulta la sezione Impostazioni di configurazione dei dettagli dei piani tariffari per un elenco completo delle opzioni relative ai dettagli dei piani tariffari.

Ad esempio, quanto riportato di seguito crea un piano tariffario con modello di addebito fisso. La tariffa è impostata su 0,10 $per ogni transazione. Il pagamento deve essere effettuato 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

Specificare un modello di ricarica a banda del volume

In un modello a bande di volume, devi specificare i dettagli del piano tariffario che includono una o più tariffe del piano, ciascuna delle quali si applica a una "banda di volume", ovvero a un intervallo di volumi di transazioni (o a un intervallo basato su un attributo personalizzato come il numero di byte trasmessi). Questo tipo di piano viene generalmente configurato per incoraggiare gli sviluppatori a generare volumi più elevati offrendo tariffe scontate per fasce di volume 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 è l'attributo 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 di base o contabile utilizzata dalla tua azienda.
  • Un tipo di durata e durata che, insieme, specificano il periodo di tempo durante il quale viene aggregato il volume di transazioni (o il volume relativo agli attributi personalizzati). Questo è anche definito "base di aggregazione". Il volume delle transazioni viene aggregato sulla base di aggregazione (ad esempio, un 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 devi specificare:

  • Il tipo di tariffa del piano tariffario (RATECARD).
  • La tariffa per il piano. Ad esempio, se specifichi 0,10 e la valuta è dollari statunitensi, allo sviluppatore vengono addebitati 0,15 $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,15 $per la trasmissione del numero di byte specificato).
  • L'unità iniziale e finale della banda del volume. L'unità iniziale specifica il limite inferiore della banda del volume, mentre l'unità finale specifica il limite superiore della banda del volume. Ad esempio, se specifichi un'unità iniziale pari a 0 e un'unità finale pari a 1000, la fascia di volume copre fino a 1000 transazioni nel periodo di aggregazione. Se la valuta è il dollaro statunitense, il periodo di aggregazione è di un 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 maggiori dettagli su quando vengono reimpostati i pacchetti, vedi Quando vengono addebitate le tariffe ricorrenti e vengono reimpostati i piani bundle?

    Se non specifichi un'unità finale per la banda di volume finale, il tasso per quella banda viene applicato a tutte le transazioni dopo che il numero di transazioni ha superato l'unità iniziale per quella banda. Ad esempio, se l'unità iniziale per l'ultima banda è 1000 e non specifichi un'unità finale per quella fascia, il tasso della banda viene applicato a tutte le transazioni dopo 1000 transazioni nel periodo di aggregazione.

Consulta la sezione Impostazioni di configurazione dei dettagli dei piani tariffari per un elenco completo delle opzioni relative ai dettagli dei piani tariffari.

Ad esempio, quanto riportato di seguito crea un piano tariffario con un modello di ricarica a banda di volume. Il tasso è impostato su 0,15 $per le prime 1000 transazioni e 0,10 $per tutte le transazioni oltre le 1000. La base dell'aggregazione è 1 mese. Il pagamento deve essere effettuato 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 integrata

In un modello di addebito combinato, lo sviluppatore paga (in anticipo) per un "set" di transazioni (o per un pacchetto in base a un attributo personalizzato come il numero di byte trasmessi). Devi specificare una tariffa per ogni pacchetto e una base di aggregazione, ovvero un periodo di tempo in cui lo sviluppatore può utilizzare il bundle.

Ad esempio, supponi di configurare due pacchetti, in cui la prima dimensione è da 1 a 1000 transazioni e la seconda da 1001 a 2000 transazioni. La tariffa è di 50 $per il primo pacchetto e di 40 $per il secondo, e 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. Al termine del periodo di aggregazione, il piano scade. Se lo sviluppatore vuole utilizzare di nuovo il bundle, deve acquistare di nuovo il piano (e il bundle).

Quello che specifichi nei dettagli del piano tariffario è sostanzialmente lo stesso di quello specificato nei dettagli del piano tariffario per il modello di addebito a fasce di volume. Le differenze sono le seguenti:

  • Ogni piano tariffario specificato è relativo a un pacchetto (anziché a una banda di volume).
  • 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 nell'ultimo bundle.

Consulta la sezione Impostazioni di configurazione dei dettagli dei piani tariffari per un elenco completo delle opzioni relative ai dettagli dei piani tariffari.

Ad esempio, quanto riportato di seguito crea un piano tariffario con un modello di addebito combinato. La tariffa è impostata su 50 $per il primo pacchetto (fino a 1000 transazioni) e 40 $per il secondo pacchetto (più di 1000 e fino a 2000 transazioni). La base dell'aggregazione è 1 mese. Il pagamento deve essere effettuato 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

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 pacchetto API). Un piano freemium offre agli sviluppatori l'uso senza costi di un prodotto API per un determinato periodo di tempo o in base alla quantità di utilizzo.

Quando imposti un piano freemium per un prodotto API, nei dettagli del piano tariffario devi specificare il periodo in cui lo sviluppatore può utilizzare senza costi le risorse fornite dal prodotto API. Il periodo può basarsi su uno dei seguenti criteri:

  • Durata, ovvero il tempo che intercorre tra una data di validità e una data di fine.
  • Quantità, ad esempio il numero di transazioni relative al prodotto API o il volume relativo a un attributo personalizzato registrato nel criterio di registrazione delle transazioni.

Se il periodo freemium è basato sulla quantità, specificalo come numero di unità freemium. Ad esempio, quanto riportato di seguito crea 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