Configura le notifiche sui limiti

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

Introduzione

Puoi impostare limiti relativi alla monetizzazione, come descritto in Applicare i limiti di monetizzazione utilizzando le norme sul controllo dei limiti di monetizzazione. Puoi anche configurare notifiche automatiche che avvisano gli sviluppatori e/o gli utenti della tua organizzazione quando un limite sta per raggiungere o è stato raggiunto.

Puoi impostare notifiche automatiche per limiti personalizzati e limiti impliciti. Ad esempio, il sistema imposta un limite implicito per gli sviluppatori con pagamento anticipato, ovvero il saldo prepagato. Puoi configurare le notifiche automatiche in modo che i tuoi sviluppatori vengano avvisati se si stanno avvicinando o hanno raggiunto il saldo prepagato.

Strumenti

Puoi impostare notifiche automatiche per i limiti utilizzando l'interfaccia utente di gestione o l'API di monetizzazione. Se utilizzi l'interfaccia utente, puoi impostare le notifiche automatiche nella pagina Notifiche.

Se utilizzi l'API, puoi impostare notifiche automatiche relative ai limiti modificando un modello di notifica fornito dalla monetizzazione. Quindi specifichi la condizione che comporta l'invio della notifica fornita dal modello modificato.

Impostazione delle notifiche relative ai limiti mediante l'interfaccia utente

  1. Fai clic su Aggiungi nella sezione Notifiche della pagina Aggiungi limite. Viene aperta la sezione Notifica.

  2. 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 a (?) o il segno minore o uguale a (?) nel menu a discesa.
    • Un numero intero (ovvero senza decimali). Assoluto (per indicare un valore numerico) o Percentuale per indicare un valore percentuale. Per i limiti percentuale, 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 imposti la notifica su un valore maggiore o uguale al 90%, la notifica verrà inviata quando viene raggiunto o superato il 90% del limite (90 $).

  3. Nel campo Invia email, seleziona uno o più sviluppatori oppure uno o più utenti della tua organizzazione. Verrà inviata una notifica agli sviluppatori o agli utenti interessati.

    Destinatari email: puoi inviare notifiche agli sviluppatori soltanto se imposti "Qualsiasi" come condizione per il limite per sviluppatori o se imposti una condizione per il limite per sviluppatori con uno sviluppatore specifico. Se hai selezionato "Qualsiasi", vedrai "Sviluppatore selezionato (Qualsiasi)" nell'elenco degli indirizzi email. Ciò significa che per la monetizzazione verrà inviata una notifica a tutti gli sviluppatori interessati. Se hai selezionato uno sviluppatore specifico, vedrai "Sviluppatore selezionato ({developer_id})" nell'elenco di indirizzi email (dove {developer_id} è l'identificazione dello sviluppatore selezionato). Per la monetizzazione verrà inviata una notifica soltanto allo sviluppatore specifico.

    Se non hai selezionato la condizione "Qualsiasi" per gli sviluppatori o uno sviluppatore specifico, non vedrai "Sviluppatore selezionato (qualsiasi)" nel campo Invia email. Tuttavia, puoi scegliere a quali utenti della tua organizzazione inviare notifiche.

    Puoi aggiungere gli indirizzi email degli utenti della tua organizzazione selezionando Utenti dell'organizzazione nella scheda Amministrazione.

    Modelli email: una volta selezionato nel campo Invia email, "Sviluppatore selezionato (qualsiasi)" verrà visualizzato un modello email o gli indirizzi email degli utenti della tua organizzazione (o entrambi).Ciò che viene visualizzato nel modello dipende dai seguenti fattori:

    • Il livello della notifica.
    • Indica se il limite era un limite di interruzione dell'esecuzione.
    • Se l'email era per utenti dell'organizzazione, sviluppatori o entrambi.

    Ad esempio, se tutte le seguenti condizioni sono vere:

    • La casella di controllo Interrompi esecuzione è selezionata.
    • Il livello di notifica è 100% o uguale al limite.
    • L'indirizzo email è riservato agli utenti dell'organizzazione.

    Il modello ha il seguente aspetto:

    Supponiamo che il nome dell'azienda dello sviluppatore sia "Società XYZ", il limite del volume di transazioni è impostato su 50 per un pacchetto API denominato "X Package" e un prodotto API denominato "Y Product" e la data di scadenza è 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 è "Sviluppatore selezionato (qualsiasi)", il modello viene visualizzato come segue:

    Entrambi i modelli consentono di risolvere le variabili pertinenti, ad esempio nome sviluppatore (se applicabile), nome pacchetto (se applicabile) e nome del prodotto (se applicabile). Puoi modificare il messaggio per soddisfare i tuoi requisiti facendo clic su Modifica a sinistra del modello.

    Se il limite è relativo a "Qualsiasi", a un'applicazione specifica e a "Qualsiasi" o a un utente specifico, devi anche aggiungere variabili al modello per le applicazioni e gli utenti. A tale scopo, procedi 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 l'opzione Halt running non è selezionata o il livello di notifica è maggiore o uguale al 100%, il modello per uno sviluppatore selezionato avrà il seguente aspetto:

    Anche in questo caso, se il limite è "Qualsiasi" (o un'applicazione specifica) o "Qualsiasi" (o un utente specifico), devi modificare il modello e poi aggiungere l'applicazione ${application.name} e/o l'utente ${user.name}, a seconda che il limite sia per un'applicazione, un utente o entrambi.

    Variabili modello: quando modifichi il messaggio in un modello email, puoi includere una qualsiasi delle seguenti variabili.

    Variabile Descrizione
    ${developer.name}

    Il nome dello sviluppatore.
    ${developer.legalName}

    Il nome dell'azienda 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 o addebiti totali o volume).
    ${PERCENT}

    La percentuale del limite raggiunto dall'utilizzo corrente.
    ${QUOTA_TYPE}

    Il tipo di limite (volume di transazioni, limite di spesa o esposizione alle commissioni).
    ${QUOTA_UNIT}

    L'unità di base del limite: valuta (per un limite di spesa) o chiamate (per un limite di transazioni).
    ${QUOTA_LIMIT}

    L'importo del limite.
    ${EXPIRY_DATE}

    La data o l'ora di scadenza o di reimpostazione del limite.

    Ad esempio, se vuoi ricevere una notifica quando uno sviluppatore raggiunge una determinata percentuale del volume delle transazioni per qualsiasi pacchetto in qualsiasi applicazione, puoi modificare il modello in questo modo:

    ${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}.
  4. Per i livelli aggiuntivi, aggiungi le notifiche in base alle necessità. Per ogni livello aggiuntivo, fai clic su Aggiungi. Questa azione aggiunge le aree Livello, Invia email e Modello email alla sezione Notifiche della pagina. Puoi aggiungere fino a sei livelli per le notifiche. Ad esempio, se imposti la notifica su > 70%, 80%, 90%, 100%, verrà inviata una notifica quando viene raggiunto ognuno di questi livelli.
  5. 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).

Impostazione delle notifiche relative ai limiti mediante l'API

La monetizzazione fornisce un insieme di modelli che forniscono il testo per vari tipi di notifiche, incluse notifiche relative ai limiti e notifiche ad hoc, come avvisi agli sviluppatori sulla disponibilità di nuovi prodotti. Puoi personalizzare uno qualsiasi di questi modelli in base alle tue esigenze. Per impostare una notifica automatica dei limiti, devi prima modificare un modello appropriato. Quindi, specifica la condizione che determina l'invio della notifica fornita dal modello modificato. Per maggiori dettagli, consulta Configurare le notifiche utilizzando i modelli di notifica.

Passaggi successivi

Scopri come configurare le notifiche automatiche per avvisare gli sviluppatori di eventi quali nuovi prodotti, nuove versioni di termini e condizioni o nuovi piani tariffari. Consulta Configurare le notifiche utilizzando i modelli di notifica.