Passaggi per configurare la monetizzazione

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

Prima di iniziare

Prima di iniziare a utilizzare la monetizzazione con la tua organizzazione Apigee, devi eseguire le seguenti attività di prerequisito:

  • Crea un account Apigee Edge, come descritto in Creare un account Apigee Edge.
  • Acquista la monetizzazione. Inizialmente, Edge non include l'API di monetizzazione né la integra nell'interfaccia utente di gestione. Devi acquistare la funzionalità di monetizzazione per incorporare l'API di monetizzazione e i componenti dell'interfaccia utente di monetizzazione in Edge per la tua organizzazione Apigee.

Dopo aver acquistato la monetizzazione, devi svolgere le seguenti attività:

Configurazione iniziale con Apigee

Collabora con il team di configurazione di Apigee Edge per completare la configurazione iniziale della monetizzazione. In base alle tue indicazioni, il team di configurazione imposterà quanto segue:

  • Se la tua organizzazione è una società di telecomunicazioni.
  • Il tipo di fatturazione che vuoi supportare per gli sviluppatori che acquistano i tuoi piani tariffari: prepagato, postpaid o entrambi. Consulta Account prepagati e postpagati.
  • Se vuoi dati estratti dalla monetizzazione dettagliati o di riepilogo nel tuo sistema contabile e il formato dei dati richiesto.
  • Indirizzo email di risposta personalizzato. Per le notifiche via email relative alla monetizzazione inviate a aziende e sviluppatori, è configurato un indirizzo noreply@apigee.com predefinito. Devi richiedere un nome e un indirizzo di risposta personalizzati per la tua organizzazione.

Il team di configurazione di Apigee esegue uno script per sincronizzare la monetizzazione con la tua organizzazione e con gli sviluppatori, le applicazioni e i prodotti API che hai creato utilizzando Apigee Edge. In futuro, l'assistenza Apigee potrebbe chiederti di sincronizzare la tua organizzazione, come descritto in Sincronizzare i dati di Apigee Edge con la monetizzazione per maggiori dettagli. Non sincronizzare i dati di monetizzazione, a meno che non ti venga richiesto da Apigee.

Configurare la monetizzazione

La seguente tabella riepiloga i passaggi necessari per configurare la monetizzazione per la tua organizzazione Apigee.
Passaggio Descrizione
Modificare il profilo dell'organizzazione Nell'ambito della configurazione iniziale della monetizzazione, il team di configurazione di Apigee Edge configura il profilo della tua organizzazione.

Devi modificare il profilo dell'organizzazione per aggiungere o aggiornare le informazioni sulla tua organizzazione, a seconda dei casi. Ad esempio, potrebbe essere necessario aggiornare il tipo di fatturazione, le impostazioni di valuta o il modello fiscale.

Gestire le valute supportate Nell'ambito della configurazione iniziale della monetizzazione, il team di configurazione di Apigee Edge specifica le valute supportate dalla tua organizzazione e imposta la valuta predefinita.

Puoi recuperare le valute supportate dalla tua organizzazione e aggiungerne o eliminarne altre (in modo che riflettano le valute utilizzate da uno sviluppatore o da un piano tariffario).

Nota: la monetizzazione esegue automaticamente un job giornaliero che ottiene il tasso di cambio in dollari statunitensi per ogni valuta supportata. Per impostazione predefinita, il job viene eseguito ogni giorno 1 secondo dopo mezzanotte. Per maggiori dettagli, vedi Pianificare i job di monetizzazione.
Specificare termini e condizioni Se vuoi, puoi aggiungere i termini e condizioni al profilo della tua organizzazione prima di pubblicare i piani tariffari. Dopo aver pubblicato un piano tariffario, la versione corrente dei termini e condizioni viene visualizzata nel portale per gli sviluppatori.

Nota: i Termini e condizioni non fanno parte del profilo dell'organizzazione. Nel profilo della tua organizzazione, specifica la posizione (URL pubblico) dei Termini e condizioni. Puoi aggiungere più versioni dei Termini e condizioni per riflettere le modifiche nel tempo.
Applicare i limiti di monetizzazione Collega il criterio MonetizationLimitsCheck ai proxy API per applicare i limiti di monetizzazione.

Nello specifico, il criterio viene attivato nelle seguenti condizioni:

  • Lo sviluppatore che accede all'API monetizzata non è registrato o non ha sottoscritto il piano tariffario.
  • Lo sviluppatore ha superato il volume di transazioni per il piano tariffario sottoscritto.
  • È stato raggiunto il saldo dell'account prepagato o il limite di credito postpaid dello sviluppatore.
Configurare le notifiche Configura le notifiche per informare gli sviluppatori o i fornitori di API di un evento specifico, ad esempio un piano tariffario appena pubblicato.

Monetizzare le API

Quando monetizzi le API, raggruppi uno o più prodotti API in un pacchetto di prodotti API e definisci il piano tariffario associato.

Un pacchetto di prodotti API non diventa visibile agli sviluppatori finché non pubblichi un piano tariffario per il pacchetto (con una data di inizio pari alla data corrente o a una data futura). Gli sviluppatori possono registrare le proprie app per l'utilizzo di un set di prodotti API solo acquistando uno dei piani tariffari attualmente in vigore. Se un pacchetto di prodotti API non ha un piano tariffario pubblicato attualmente in vigore, il pacchetto non è monetizzato.

La tabella seguente riepiloga i passaggi necessari per monetizzare le API.

Passaggio Descrizione
Gestire i set di prodotti API

Crea pacchetti di prodotti API per raggruppare i tuoi prodotti API.

Nota: nell'interfaccia utente di Edge classica e nell'API di monetizzazione, i set di prodotti sono chiamati pacchetti API.

Per utilizzare l'API per gestire i set di prodotti API, consulta:
Configurare il criterio di registrazione delle transazioni

Configura il criterio di registrazione delle transazioni per ciascuno dei tuoi prodotti API. Il criterio di registrazione delle transazioni definisce cosa vuoi acquisire nei record delle transazioni per un prodotto API, inclusi eventuali attributi personalizzati.

Per utilizzare l'API per configurare il criterio di registrazione delle transazioni, consulta:
Gestire e pubblicare i piani tariffari

Crea un piano tariffario per definire l'approccio alla monetizzazione per le tue API. Ad esempio, se applichi una tariffa fissa o variabile per l'utilizzo della tua API.

Per gestire i piani tariffari utilizzando l'API, consulta:

Acquistare un piano tariffario pubblicato Acquista un piano tariffario pubblicato e, se vuoi, mettilo in scadenza o annullalo utilizzando l'API.
Configurare la monetizzazione nel portale per gli sviluppatori Configura la monetizzazione nel tuo portale per gli sviluppatori per fornire agli sviluppatori l'accesso self-service all'abbonamento ai piani tariffari, all'elaborazione automatica dei pagamenti e alla fatturazione, ai report, ai cataloghi dei prodotti e ad altre impostazioni specifiche per la monetizzazione.

Gestisci monetizzazione

Dopo aver configurato la monetizzazione e aver monetizzato la tua API, puoi eseguire uno o più dei passaggi descritti nella tabella seguente:

Passaggio Descrizione
Gestire aziende e sviluppatori Gestisci le aziende e gli sviluppatori che utilizzano le tue API. Uno sviluppatore è una singola entità identificata in modo univoco dall'indirizzo email. Un'azienda è una raccolta di sviluppatori gestiti come un'unica entità.
Creare report Crea report su saldo, entrate e varianze di pagamenti anticipati. Gli sviluppatori con abbonamenti prepagati possono riconciliare i report sul saldo prepagato con i depositi bancari.
Apportare aggiustamenti alla fatturazione Ad esempio, apporta aggiustamenti alla fatturazione per correggere le discrepanze nei tuoi record.
Crediti per problemi Assegna i crediti sviluppatore, se necessario. Per uno sviluppatore con abbonamento prepagato, un credito si presenta come una riduzione dell'utilizzo che aumenta il saldo prepagato dello sviluppatore in futuro. Per uno sviluppatore con fatturazione postpaid, un credito viene visualizzato come voce separata in una fattura, riducendo l'addebito.
Gestire i saldi dell'account con pagamento anticipato Visualizza il saldo corrente dell'account prepagato e ricarica gli account prepagati o configura il ricaricamento automatico utilizzando un fornitore di servizi di pagamento di terze parti.
Gestire i saldi postpagati utilizzando i massimali di credito Quando aggiungi una valuta supportata per un'organizzazione, puoi impostare un limite di credito per uno sviluppatore con fatturazione posticipata. Il massimale di credito si applica a tutti gli sviluppatori postpaid dell'organizzazione. Inoltre, puoi impostare il limite di credito per un singolo sviluppatore con abbonamento postpaid. In questo caso, il limite di credito sovrasta qualsiasi limite impostato per la valuta solo per lo sviluppatore specificato.
Pubblicare i rimborsi Pubblicare rimborsi agli sviluppatori per le transazioni di acquisto.
Pianificare i job di monetizzazione La monetizzazione fornisce uno scheduler di job e un insieme di job pre-pianificati per l'esecuzione in orari prestabiliti. Gestisci la pianificazione dei job di monetizzazione utilizzando l'API.
Visualizzare lo stato delle transazioni Visualizza lo stato delle transazioni avvenute durante un intervallo di tempo specificato utilizzando l'API.
Sincronizzare i dati di Apigee Edge con la monetizzazione Se Apigee ti chiede di farlo, sincronizza di nuovo i dati con la monetizzazione per assicurarti che siano sincronizzati. Puoi sincronizzare quanto segue: organizzazione, prodotti API, sviluppatori e applicazioni.
Eliminare i dati di monetizzazione dalla tua organizzazione Potresti voler eliminare i dati di monetizzazione dalla tua organizzazione per cancellare un'organizzazione di test o eliminare un'organizzazione.