Passaggi per configurare la monetizzazione

Stai visualizzando la documentazione di Apigee Edge.
Consulta la 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à preliminari:

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

Dopo aver acquistato la monetizzazione, devi eseguire 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 ai tuoi input, il team di configurazione configurerà quanto segue:

  • Se la tua organizzazione è una società di telecomunicazioni.
  • Quale tipo di fatturazione vuoi supportare per gli sviluppatori che acquistano i tuoi piani tariffari: prepagato, postpagato o entrambi. Consulta Account prepagati e postpagati.
  • Se vuoi che i dati estratti dalla monetizzazione vengano inseriti nel tuo sistema di contabilità in formato dettagliato o riepilogativo e il formato dei dati richiesto.
  • Indirizzo di risposta email personalizzato. Per le notifiche email di monetizzazione inviate ad aziende e sviluppatori, viene configurato un indirizzo predefinito noreply@apigee.com. 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. L'assistenza Apigee potrebbe chiederti di sincronizzare la tua organizzazione in futuro, 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
Modifica il profilo della tua 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 della valuta o il modello fiscale.

Gestisci 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 aggiungere o eliminare le valute supportate (per riflettere 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 alle 00:00:01. Per maggiori dettagli, consulta Pianificare i job di monetizzazione.
Specifica i termini e le condizioni Facoltativamente, 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 sviluppatori.

Nota: i termini e le condizioni si trovano al di fuori del profilo della tua organizzazione. Nel profilo della tua organizzazione, devi specificare la posizione (URL pubblico) dei termini e delle condizioni. Puoi aggiungere più versioni dei termini e delle condizioni per riflettere le modifiche nel tempo.
Applica i limiti di monetizzazione Collega la policy MonetizationLimitsCheck ai proxy API per applicare i limiti di monetizzazione.

In particolare, la policy viene attivata 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 postpagato dello sviluppatore.
Configura le notifiche Configura le notifiche per informare gli sviluppatori o i provider 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 utilizzare un pacchetto 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 viene monetizzato.

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

Passaggio Descrizione
Gestisci i pacchetti di prodotti API

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

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

Per utilizzare l'API per gestire i pacchetti di prodotti API, consulta:
Configura la policy di registrazione delle transazioni

Configura la policy di registrazione delle transazioni per ciascuno dei tuoi prodotti API. La policy 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 la policy di registrazione delle transazioni, consulta:
Gestisci e pubblica i piani tariffari

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

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

Acquista un piano tariffario pubblicato Acquista un piano tariffario pubblicato e, se vuoi, fai scadere o annulla un piano tariffario acquistato utilizzando l'API.
Configura la monetizzazione nel portale per sviluppatori Configura la monetizzazione nel portale per sviluppatori per fornire agli sviluppatori l'accesso self-service alla sottoscrizione del piano tariffario, all'elaborazione e alla fatturazione dei pagamenti automatici, ai report, ai cataloghi dei prodotti e ad altre impostazioni specifiche per la monetizzazione.

Gestire la monetizzazione

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

Passaggio Descrizione
Gestisci 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 è un insieme di sviluppatori gestiti come una singola entità.
Crea report Crea report sul saldo prepagato, sulle entrate e sulla varianza. Per gli sviluppatori prepagati, puoi riconciliare i report sul saldo prepagato con i depositi bancari.
Apporta aggiustamenti di fatturazione Apporta aggiustamenti di fatturazione per correggere le discrepanze nei tuoi record, ad esempio.
Emetti crediti Emetti crediti per sviluppatori, se necessario. Per uno sviluppatore prepagato, un credito viene visualizzato come una riduzione dell'utilizzo che aumenta il saldo prepagato dello sviluppatore in futuro. Per uno sviluppatore postpagato, un credito viene visualizzato come una riga separata in una fattura, riducendo l'addebito in una fattura.
Gestisci i saldi degli account prepagati Visualizza il saldo attuale dell'account prepagato e ricarica gli account prepagati o configura la ricarica automatica utilizzando un fornitore di servizi di pagamento di terze parti.
Gestisci i saldi postpagati utilizzando i limiti di credito Quando aggiungi una valuta supportata per un'organizzazione, puoi impostare un limite di credito per uno sviluppatore postpagato. Il limite di credito si applica a tutti gli sviluppatori postpagati dell'organizzazione. Inoltre, puoi impostare il limite di credito per un singolo sviluppatore postpagato. In questo caso, il limite di credito sostituisce qualsiasi limite impostato per la valuta solo per lo sviluppatore specificato.
Pubblica i rimborsi Pubblica i rimborsi agli sviluppatori per le transazioni di acquisto.
Pianifica i job di monetizzazione La monetizzazione fornisce un pianificatore di job e un insieme di job pre-pianificati per l'esecuzione in orari designati. Gestisci la pianificazione dei job di monetizzazione utilizzando l'API.
Visualizza lo stato delle transazioni Visualizza lo stato delle transazioni avvenute in un intervallo di tempo specificato utilizzando l'API.
Sincronizza i dati di Apigee Edge con la monetizzazione Se ti viene chiesto di farlo da Apigee, sincronizza di nuovo i dati con la monetizzazione per assicurarti che siano sincronizzati. Puoi sincronizzare l'organizzazione, i prodotti API, gli sviluppatori e le applicazioni.
Elimina 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.