Passaggi per configurare la monetizzazione

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

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.
  • Monetizzazione dell'acquisto. Inizialmente Edge non include l'API di monetizzazione né integra la monetizzazione 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 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 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: prepagata, con pagamento posticipato o entrambi. Vedi Account prepagati e con pagamento posticipato.
  • Che tu voglia dati dettagliati o riepilogativi estratti dalla monetizzazione nel tuo sistema contabile e nel formato dei dati richiesto.
  • Indirizzo personalizzato per risposte via email. Per le notifiche via 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 tutti gli sviluppatori, le applicazioni e i prodotti API che hai creato utilizzando Apigee Edge. L'assistenza Apigee potrebbe richiedere di sincronizzare la tua organizzazione in futuro, come descritto in Sincronizzare i dati di Apigee Edge con la monetizzazione per i dettagli. Non sincronizzare i dati di monetizzazione a meno che non ti venga richiesto da Apigee.

Configura la monetizzazione

La tabella seguente riassume 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 configurerà il profilo della tua organizzazione.

Per aggiungere o aggiornare le relative informazioni, devi modificare il profilo dell'organizzazione, in base alle esigenze. Ad esempio, potrebbe essere necessario aggiornare il tipo di fatturazione, le impostazioni della 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 aggiungere o eliminare quelle supportate (in modo da riflettere quelle utilizzate da uno sviluppatore o da un piano tariffario).

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

Nota: i termini e le condizioni si trovano al di fuori del profilo della tua organizzazione. Nel profilo della tua organizzazione, specifichi la località (URL pubblico) dei Termini e condizioni. Puoi aggiungere più versioni dei Termini e condizioni per riflettere i cambiamenti nel tempo.
Applicare limiti di monetizzazione Associa la norma MonetizationLimitsCheck ai proxy API per applicare i limiti di monetizzazione.

In particolare, il criterio viene attivato alle seguenti condizioni:

  • Lo sviluppatore che accede all'API monetizzato non è registrato o non ha sottoscritto un abbonamento al piano tariffario.
  • Lo sviluppatore ha superato il volume di transazioni per il piano tariffario sottoscritto.
  • È stato raggiunto il saldo prepagato dell'account o il massimale di credito postpagato dello sviluppatore.
Configurare le notifiche Configura le notifiche per notificare a sviluppatori o fornitori di API un evento specifico, ad esempio un piano tariffario appena pubblicato.

Monetizza le tue API

Quando monetizzi le API, raggruppi uno o più prodotti basati su 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 data di inizio corrispondente alla data corrente o a una data futura). Gli sviluppatori possono registrare le loro 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 al momento in vigore, il pacchetto non viene monetizzato.

La seguente tabella riassume 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 classica di Edge e nell'API di monetizzazione, i pacchetti di prodotti sono denominati pacchetti API.

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

Configura la norma di registrazione delle transazioni per ciascuno dei tuoi prodotti API. Le norme per la registrazione delle transazioni definiscono gli elementi che vuoi acquisire nei record delle transazioni per un prodotto API, inclusi gli eventuali attributi personalizzati.

Per utilizzare l'API per configurare il criterio di registrazione delle transazioni, consulta:
Gestire e pubblicare 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:

Acquistare un piano tariffario pubblicato Acquistare un piano tariffario pubblicato e, se necessario, annullare un piano tariffario acquistato utilizzando l'API.
Configurare la monetizzazione nel portale per gli sviluppatori Configura la monetizzazione nel portale per gli sviluppatori per fornire agli sviluppatori un accesso self-service ad abbonamento del piano tariffario, elaborazione e fatturazione automatiche dei pagamenti, report, cataloghi dei prodotti e altre impostazioni specifiche per la monetizzazione.

Gestisci monetizzazione

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

Passaggio Descrizione
Gestire società e sviluppatori Gestito le aziende e gli sviluppatori che utilizzano le tue API. Uno sviluppatore è una singola entità identificata in modo univoco dall'indirizzo email. Una società è un insieme di sviluppatori gestito come un'unica entità.
Creare report Crea report sul saldo prepagato, sulle entrate e sulla variazione. Gli sviluppatori che hanno scelto il pagamento anticipato possono riconciliare i report sul saldo prepagato con i versamenti bancari.
Apportare aggiustamenti di fatturazione Ad esempio, apporta aggiustamenti di fatturazione per correggere le discrepanze nei dati.
Emettere crediti Se necessario, emetti crediti dello sviluppatore. Per uno sviluppatore prepagato, viene visualizzato un credito come riduzione dell'utilizzo che aumenta il saldo prepagato dello sviluppatore in futuro. Per uno sviluppatore con pagamento posticipato, il credito viene visualizzato come riga separata in una fattura, riducendo l'addebito in una fattura.
Gestire i saldi prepagati dell'account Visualizza il saldo prepagato attuale dell'account e ricarica gli account prepagati o configura il ricaricamento automatico tramite 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 massimale di credito per uno sviluppatore con pagamento posticipato. Il massimale di credito si applica a tutti gli sviluppatori con pagamento posticipato dell'organizzazione. Inoltre, puoi impostare il massimale di credito per un singolo sviluppatore con pagamento posticipato. In questo caso, il massimale di credito sostituisce qualsiasi limite impostato per la valuta solo per lo sviluppatore specificato.
Pubblicare rimborsi Pubblicare rimborsi per gli sviluppatori per le transazioni di acquisto.
Pianifica job di monetizzazione La monetizzazione fornisce uno strumento di pianificazione dei job e un insieme di job preprogrammati per l'esecuzione in orari designati. Gestire la pianificazione del job di monetizzazione utilizzando l'API.
Visualizzare lo stato delle transazioni Visualizza lo stato delle transazioni che si sono verificate durante 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, risincronizza i dati con la monetizzazione per assicurarti che siano sincronizzati. Puoi sincronizzare i seguenti elementi: organizzazione, prodotti API, sviluppatori e applicazioni.
Eliminare i dati di monetizzazione dall'organizzazione Potresti voler eliminare i dati di monetizzazione dalla tua organizzazione per cancellare un'organizzazione di test o eliminarla.