Stai visualizzando la documentazione di Apigee Edge.
Consulta la
documentazione di Apigee X. info
Introduzione
Puoi impostare limiti relativi alla monetizzazione, come descritto in Applicare i limiti di monetizzazione utilizzando il criterio di controllo dei limiti di monetizzazione. Puoi anche configurare notifiche automatiche che avvisano gli sviluppatori, e/o gli utenti della tua organizzazione quando un limite si sta avvicinando o è stato raggiunto.
Puoi configurare notifiche automatiche per i limiti personalizzati e per i limiti impliciti. Ad esempio, il sistema imposta un limite implicito per gli sviluppatori prepagati, ovvero il loro saldo prepagato. Puoi configurare notifiche automatiche in modo che gli sviluppatori vengano avvisati se si stanno avvicinando o hanno raggiunto il loro saldo prepagato.
Cassetta degli attrezzi
Puoi configurare le notifiche automatiche per i limiti utilizzando l'interfaccia utente di gestione o l'API di monetizzazione. Se utilizzi l'interfaccia utente, configura le notifiche automatiche nella pagina Notifiche.
Se utilizzi l'API, configura le notifiche automatiche per i limiti modificando un modello di notifica fornito dalla monetizzazione. Poi specifica la condizione che determina l'invio della notifica fornita dal modello modificato.
Configurare le notifiche dei limiti utilizzando l'interfaccia utente
- Fai clic su Aggiungi nella sezione Notifiche della pagina Aggiungi limite. Si apre la sezione Notifiche.
- Seleziona un livello per la notifica. Si tratta di una soglia basata su un numero assoluto o su una
percentuale della base del limite. Seleziona:
- Il segno maggiore o uguale (?) o il segno minore o uguale (?) dal menu a discesa.
- Un numero intero (ovvero senza cifre decimali). Assoluto (per indicare un valore numerico) o Percentuale per indicare un valore percentuale. Per i limiti percentuali, assicurati sempre di impostare il limite su >, il che significa che la notifica viene inviata quando lo sviluppatore raggiunge o supera quel livello percentuale.
Ad esempio, se imposti un limite di spesa di 100 $e la notifica su maggiore o uguale al 90%, la notifica verrà inviata quando viene raggiunto o superato il 90% del limite (90 $).
- Nel campo Invia email, seleziona uno o più sviluppatori oppure uno o più utenti della tua
organizzazione. La notifica verrà inviata agli sviluppatori o agli utenti interessati.
Destinatari email: puoi inviare notifiche agli sviluppatori solo se imposti una condizione di limite dello sviluppatore "Qualsiasi" o una condizione di limite dello sviluppatore con uno sviluppatore specifico. Se hai selezionato "Qualsiasi", vedrai "Sviluppatore selezionato (Qualsiasi)" nell'elenco degli indirizzi email. Ciò significa che la monetizzazione invierà una notifica a tutti gli sviluppatori interessati. Se hai selezionato uno sviluppatore specifico, vedrai "Sviluppatore selezionato (
{developer_id})" nell'elenco degli indirizzi email (dove{developer_id}è l'identificazione dello sviluppatore selezionato). La monetizzazione invierà una notifica solo a quello sviluppatore specifico.Se non hai selezionato una condizione di limite dello sviluppatore "Qualsiasi" o uno sviluppatore specifico, non vedrai "Sviluppatore selezionato (Qualsiasi)" nel campo Invia email. Tuttavia, puoi scegliere quali utenti della tua organizzazione vuoi avvisare.
Puoi aggiungere gli indirizzi email degli utenti della tua organizzazione selezionando Utenti dell'organizzazione nella scheda Amministratore.
Modelli di email: vedrai un modello di email dopo aver selezionato nel campo Invia email "Sviluppatore selezionato (Qualsiasi)" o gli indirizzi email degli utenti della tua organizzazione (o entrambi).Ciò che viene visualizzato nel modello dipende da:
- Il livello della notifica.
- Se il limite era un limite di interruzione dell'esecuzione.
- Se l'email era destinata agli utenti dell'organizzazione, agli sviluppatori o a entrambi.
Ad esempio, se sono vere tutte le seguenti condizioni:
- La casella di controllo Interrompi esecuzione è selezionata.
- Il livello di notifica è 100% o lo stesso importo del limite.
- L'email è destinata solo agli utenti dell'organizzazione.
Il modello ha il seguente aspetto:
Supponiamo che il nome della società dello sviluppatore sia "XYZ company", il limite di volume delle transazioni sia impostato su 50 per un pacchetto API denominato "X Package" e un prodotto API denominato "Y Product", e la data di scadenza sia impostata al 30 settembre 2013. Il messaggio email inviato avrà il seguente aspetto:
Developer XYZ company has exceeded their transaction volume limit of 50 transactions for X package, Y product. Their API calls will be blocked till 2013-09-30
Se l'email è destinata a "Sviluppatore selezionato (Qualsiasi)", il modello ha il seguente aspetto:
Entrambi i modelli risolveranno le variabili pertinenti, come il nome dello sviluppatore (se applicabile), il nome del pacchetto (se applicabile) e il nome del prodotto (se applicabile). Puoi modificare il messaggio in base alle tue esigenze facendo clic su Modifica a sinistra del modello.
Se il limite è per "Qualsiasi" o un'applicazione specifica e "Qualsiasi" o un utente specifico, devi anche aggiungere variabili per le applicazioni e gli utenti al modello. Puoi farlo nel seguente modo:
- Fai clic su Modifica a sinistra del modello.
- Aggiungi
${user.name}user, depending on whether the limit is for application and/or user.
Di seguito è riportato un modello modificato per "Qualsiasi" o un'applicazione specifica.
Se Interrompi esecuzione non è selezionato o il livello di notifica è maggiore o uguale a 100%, il modello per uno sviluppatore selezionato ha il seguente aspetto:
Anche in questo caso, se il limite è per "Qualsiasi" (o un'applicazione specifica) o "Qualsiasi" (o un utente specifico) devi modificare il modello e poi aggiungere
${application.name}applicazione e/o${user.name}utente, a seconda che il limite sia per un'applicazione, un utente, o entrambi.Variabili del modello: quando modifichi il messaggio in un modello di email, puoi includere una delle seguenti variabili.
Variabile Descrizione ${developer.name}Il nome dello sviluppatore.
${developer.legalName}Il nome della società dello sviluppatore.
${ratePlan.monetizationPackage.displayName}Il nome del pacchetto API.
${application.name}Il nome dell'applicazione.
${USER}Il nome dell'utente.
${USAGE}Utilizzo attuale (entrate totali o addebiti o volume).
${PERCENT}La percentuale del limite raggiunto dall'utilizzo attuale.
${QUOTA_TYPE}Il tipo di limite (volume delle transazioni, limite di spesa o esposizione alle commissioni).
${QUOTA_UNIT}L'unità di base per il limite: valuta (per un limite di spesa) o chiamate (per un transazioni).
${QUOTA_LIMIT}L'importo del limite.
${EXPIRY_DATE}La data o l'ora di scadenza del limite o di ripristino.
Ad esempio, se vuoi ricevere una notifica quando uno sviluppatore ha raggiunto una determinata percentuale del volume delle transazioni per qualsiasi pacchetto su qualsiasi applicazione, puoi modificare il modello in modo che abbia il seguente aspetto:
${developer.legalName} has reached a total volume of ${USAGE} on ${ratePlan.monetizationPackage.displayName}. This is ${PERCENT} of the daily/weekly/monthly (state period of limit as appropriate) transaction volume limit of ${QUOTA_LIMIT}.
- Aggiungi le notifiche necessarie per i livelli aggiuntivi. Per ogni livello aggiuntivo, fai clic su Aggiungi. Vengono aggiunte un'area Livello, Invia email e Modello di email alla sezione Notifiche della pagina. Puoi aggiungere fino a 6 livelli per le notifiche. Ad esempio, se imposti la notifica su > 70%, 80%, 90%, 100%, verrà inviata una notifica quando viene raggiunto ciascuno di questi livelli.
- Dopo aver aggiunto tutte le notifiche, fai clic su Salva (per salvare e pubblicare le notifiche in un secondo momento), Salva e pubblica (per pubblicare ora) o Annulla (per annullare).
Configurare le notifiche dei limiti utilizzando l'API
La monetizzazione fornisce un insieme di modelli che forniscono il testo per vari tipi di notifiche, tra cui le notifiche dei limiti e le notifiche ad hoc, ad esempio per avvisare gli sviluppatori della disponibilità di nuovi prodotti. Puoi personalizzare uno di questi modelli in base alle tue esigenze. Per configurare una notifica automatica dei limiti, modifica prima un modello appropriato. Poi specifica la condizione che determina l'invio della notifica fornita dal modello modificato. Per ulteriori dettagli, vedi Configurare le notifiche utilizzando i modelli di notifica.
Passaggi successivi
Scopri come configurare le notifiche automatiche in modo da poter avvisare gli sviluppatori di eventi come nuovi prodotti, nuove versioni dei Termini e condizioni o nuovi piani tariffari. Consulta Configurare le notifiche utilizzando i modelli di notifica.