Risoluzione dei problemi di monetizzazione

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

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

Sviluppatore sospeso

Sintomo

Lo sviluppatore è stato sospeso e non potrà effettuare altre transazioni di monetizzazione o chiamate API.

Messaggi di errore

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

Diagnostica

Per determinare il motivo per cui lo sviluppatore è stato sospeso, svolgi i passaggi che seguono:

  1. Esegui la seguente chiamata API per identificare il codice di errore associato allo sviluppatore sospeso:
    1. Se sei un utente del cloud pubblico, utilizza l'API seguente: 
      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
    2. Se sei un utente Private Cloud, utilizza l'API seguente: 
      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 dei motivi 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 prepagato dell'account sviluppatore non dispone di fondi sufficienti per eventuali transazioni aggiuntive, lo sviluppatore verrà sospeso.

Per gli sviluppatori con pagamento posticipato, questo errore può verificarsi se superano il massimale di credito o se il massimale di credito impostato nella 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 è tenuto ad acquistare un piano tariffario prima di completare qualsiasi transazione.

Risoluzione

Errore

Procedura per la risoluzione

INSUFFICIENT_FUNDS

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

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED
  1. Effettua le seguenti chiamate API per ottenere rispettivamente il piano tariffario e i dettagli della transazione per sviluppatori:
    • Esegui la seguente chiamata API per ottenere le date di inizio e di fine dei 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. Nella UI di Edge, puoi anche controllare il numero di chiamate che uno sviluppatore è autorizzato a effettuare selezionando:

    Pacchetti > PackageName > RatePlanName > Tariffario

    Ad esempio, se il nome del pacchetto è Pacchetto Pro e si tratta di 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, tra cui:

  • Funzionalità webhook non funzionante
  • Impossibile creare webhook
  • Notifiche webhook non attivate
  • I report sulla monetizzazione non mostrano alcuna transazione. Ad esempio, i dati di Analytics indicano che lo sviluppatore ha completato molte transazioni in un determinato periodo di tempo, ma nei report Monetizzazione non viene elencata nessuna di queste transazioni.
  • Le transazioni non vengono registrate

Messaggi di errore

Potresti non notare alcun messaggio di errore, ma vedrai i problemi come spiegato nella sezione Sintomi.

Possibili cause

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

Diagnosi della causa

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

    Visualizzare lo stato delle transazioni

  2. Se nessuna transazione viene elencata come SUCCESS nella durata specificata, significa che le transazioni non sono monetizzate.

Le cause tipiche della mancata monetizzazione delle transazioni sono:

Le seguenti sezioni descrivono come diagnosticare e risolvere ciascun problema.

Norme sul controllo dei limiti di monetizzazione non utilizzate nel proxy API

Diagnostica

  1. Verifica se le norme sul controllo dei limiti di monetizzazione sono collegate ai proxy API.
  2. Se il criterio non è associato, questo potrebbe essere il motivo per cui le transazioni sono indicate come FAILED.

Risoluzione

Allega le norme sul controllo dei limiti di monetizzazione ai proxy API richiesti, come descritto in Applicare i limiti di monetizzazione sui proxy API.

Se il problema persiste, controlla Il prodotto API non è monetizzato.

Il prodotto API non è monetizzato

Diagnostica

  1. Controlla se il prodotto API è monetizzato (solo i prodotti API monetizzati sono valutati e saranno elencati nelle transazioni). Per prodotto monetizzato è disponibile almeno un piano tariffario attivo.
  2. Utilizza la seguente chiamata API di gestione per ottenere l'elenco dei prodotti API monetizzati:
    1. Se sei un utente del cloud pubblico, utilizza l'API seguente: 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
    2. Se sei un utente Private Cloud, utilizza l'API seguente: 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
  3. Se il prodotto API associato al 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, consulta la sezione Norme di registrazione delle transazioni definite in modo errato.

Norme di registrazione delle transazioni definite in modo errato

Diagnostica

  1. Abilita la traccia UI per il proxy API a cui sono allegate le norme sul controllo dei limiti di monetizzazione.
  2. Seleziona una richiesta API specifica dalla traccia UI.
  3. Seleziona il flusso AX di Analytics 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 UI di esempio che mostra che le variabili di flusso del mint sono configurate correttamente.

  5. Se noti un errore nella variabile mint.tx.status, significa che il criterio di registrazione delle transazioni non è definito correttamente.

Risoluzione

  1. Assicurati di aver seguito correttamente tutti i passaggi documentati in Creare il criterio di registrazione delle transazioni durante la creazione del criterio di registrazione delle transazioni.
  2. Il valore chiave è il "criterio di esito positivo delle transazioni" impostato nel criterio di registrazione delle transazioni. Consulta la sezione Esempi di impostazione dei criteri di esito positivo delle transazioni in un criterio di registrazione delle transazioni

Lo sviluppatore non ha acquistato il piano tariffario

Diagnostica

  1. Utilizza la seguente chiamata API di gestione per verificare i piani tariffari acquistati dallo sviluppatore:
    1. Se sei un utente del cloud pubblico, utilizza l'API seguente: 
      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 seguente: 
      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 alla chiamata precedente, trova il piano che era attivo nel momento in cui la transazione è stata completata dallo sviluppatore.

Risoluzione

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

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