Risoluzione dei problemi di monetizzazione

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Questo argomento fornisce informazioni e indicazioni sulla risoluzione dei problemi di monetizzazione più comuni.

Sviluppatore sospeso

Sintomo

Lo sviluppatore è sospeso e non potrà effettuare ulteriori transazioni di monetizzazione chiamate API.

Messaggi di errore

<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>

Diagnosi

Per determinare il motivo della sospensione dello sviluppatore, segui questi passaggi:

  1. Esegui la seguente chiamata API per identificare il codice di errore associato allo sviluppatore sospeso:
    1. Se sei un utente di Public Cloud, utilizza l'API riportata di seguito: 
      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
    2. Se sei un utente di Private Cloud, utilizza l'API riportata di seguito: 
      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
  2. Confronta il codice di errore con i seguenti codici motivo per determinare il motivo della sospensione dello sviluppatore.

Vedi anche: Riepilogo dei codici motivo per gli sviluppatori sospesi

Codice motivo

Causa

Dettagli

INSUFFICIENT_FUNDS

Il saldo dell'account sviluppatore è esaurito

Se il saldo dell'account sviluppatore prepagato non ha fondi sufficienti per eventuali transazioni aggiuntive, lo sviluppatore verrà sospeso.

Per gli sviluppatori con pagamento posticipato, questo errore può verificarsi se superano il limite di credito o se il limite di credito impostato sulla valuta utilizzata è esaurito.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

Lo sviluppatore non può effettuare ulteriori transazioni

Ogni sviluppatore può effettuare un numero fisso di transazioni in base al piano tariffario acquistato. Se il numero di transazioni viene superato, lo sviluppatore viene sospeso e non può completare ulteriori transazioni.

NO_CURRENT_PUBLISHABLE_ENTITY

Lo sviluppatore non ha acquistato alcun piano tariffario

Uno sviluppatore deve acquistare un piano tariffario prima di completare qualsiasi transazione.

Risoluzione

Errore

Passaggi per la risoluzione

INSUFFICIENT_FUNDS

Lo sviluppatore deve assicurarsi che il saldo dell'account o credito disponibile sia sufficiente per completare eventuali transazioni aggiuntive.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED
  1. Esegui le seguenti chiamate API per ottenere rispettivamente i dettagli del piano tariffario e i dettagli della transazione dello sviluppatore:
    • Esegui la seguente chiamata API per ottenere la data di inizio e di fine di i piani tariffari acquistati dallo sviluppatore: 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans
    • Esegui la seguente chiamata API per ottenere il numero di transazioni riuscite effettuate dallo sviluppatore: 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D

  2. Nell'interfaccia utente di Edge, puoi anche controllare il numero di chiamate che uno sviluppatore può effettuare selezionando:

    Pacchetti > NomePacchetto > NomePianoTariffario > Tariffario

    Ad esempio, se il nome del pacchetto è Pacchetto Pro ed è un Piano senza costi, il percorso sarà:

    Pacchetti > Pacchetto Pro > Piano senza costi > Tariffario

NO_CURRENT_PUBLISHABLE_ENTITY

Lo sviluppatore deve acquistare un piano tariffario per poter effettuare chiamate API.

Problemi di configurazione della monetizzazione

Sintomi

I problemi di configurazione della monetizzazione possono manifestarsi con diversi sintomi, ad esempio:

  • Funzionalità dei webhook non funzionante
  • Impossibilità di creare webhook
  • Notifiche webhook non attivate
  • I report sulla monetizzazione non mostrano transazioni. Ad esempio, i dati di Analytics indicano che lo sviluppatore ha completato molte transazioni in un periodo di tempo specifico, ma i report sulla monetizzazione non elencano nessuna di queste transazioni.
  • Transazioni non registrate

Messaggi di errore

Potresti non visualizzare messaggi di errore, ma vedrai i problemi come spiegato nella sezione Sintomi.

Possibili cause

Se riscontri uno dei sintomi elencati nella sezione Sintomi, è molto probabile che le transazioni non vengano monetizzate.

Identificare la causa

  1. Utilizza la chiamata API di gestione descritta nella sezione seguente per verificare se le transazioni vengono monetizzate.

    Visualizzare lo stato delle transazioni

  2. Se non vedi alcuna transazione elencata come SUCCESS nel periodo di tempo specificato, significa che le transazioni non sono monetizzate.

Le cause tipiche della mancata monetizzazione delle transazioni sono:

Le sezioni seguenti descrivono come diagnosticare e risolvere ogni problema.

Criterio di controllo dei limiti di monetizzazione non utilizzato nel proxy API

Diagnosi

  1. Verifica se il criterio di controllo dei limiti di monetizzazione è collegato ai proxy API.
  2. Se il criterio non è collegato, questo potrebbe essere il motivo per cui le transazioni sono elencate come FAILED (NON RIUSCITE).

Risoluzione

Collega il criterio di controllo dei limiti di monetizzazione ai proxy API richiesti, come descritto in Applicare i limiti di monetizzazione ai proxy API.

Se il problema persiste, controlla APIProduct non monetizzato.

APIProduct non monetizzato

Diagnosi

  1. Verifica se il prodotto API è monetizzato (solo i prodotti API monetizzati vengono valutati e saranno elencati nelle transazioni). Un prodotto monetizzato è un prodotto che ha almeno un piano tariffario attivo disponibile.
  2. Utilizza la seguente chiamata API di gestione per ottenere l'elenco dei prodotti API monetizzati:
    1. Se sei un utente di Public Cloud, utilizza l'API riportata di seguito: 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
    2. Se sei un utente di Private Cloud, utilizza l'API riportata di seguito: 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
  3. Se il prodotto API associato al tuo proxy API non è monetizzato, questo potrebbe essere il motivo per cui le transazioni non vengono monetizzate.

Risoluzione

Per monetizzare un prodotto API, segui questi passaggi:

  1. Configura il criterio di registrazione delle transazioni.

  2. Verifica che il prodotto API abbia un piano tariffario attivo.

Se il problema persiste, controlla Criterio di registrazione delle transazioni definito in modo errato.

Criterio di registrazione delle transazioni definito in modo errato

Diagnosi

  1. Attiva la traccia dell'interfaccia utente per il proxy API a cui è collegato il criterio di controllo dei limiti di monetizzazione collegato.
  2. Seleziona una richiesta API specifica dalla traccia dell'interfaccia utente.
  3. Seleziona il flusso di Analytics AX e verifica se le seguenti variabili di flusso di monetizzazione (mint) hanno i valori corretti: 
    mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'.
mint.tx.app_id - Application id of API product.
mint.tx.prod_id - API product id.

  4. Di seguito è riportata una traccia dell'interfaccia utente di esempio che mostra che le variabili di flusso di mint sono configurate correttamente.

  5. Se osservi un errore nella variabile mint.tx.status, significa che il criterio di registrazione delle transazioni è definito in modo errato.

Risoluzione

  1. Assicurati che tutti i passaggi documentati in Creare un criterio di registrazione delle transazioni siano stati seguiti correttamente durante la creazione del criterio di registrazione delle transazioni.
  2. Il valore della chiave è il "criterio di successo della transazione" impostato nel criterio di registrazione delle transazioni. Vedi Esempi di impostazione dei criteri di successo delle transazioni in un criterio di registrazione delle transazioni

Lo sviluppatore non ha acquistato il piano tariffario

Diagnosi

  1. Utilizza la seguente chiamata API di gestione per verificare i piani tariffari acquistati dallo sviluppatore:
    1. Se sei un utente di Public Cloud, utilizza l'API riportata di seguito: 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
    2. Se sei un utente di Private Cloud, utilizza l'API riportata di seguito: 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
  2. In base alla risposta della chiamata precedente, trova il piano attivo al momento del completamento della transazione da parte dello sviluppatore.

Risoluzione

Lo sviluppatore deve acquistare il piano tariffario in base ai suoi requisiti ed eseguire le transazioni/API.

Se il problema persiste, contatta l'assistenza di Apigee Edge.