Acquisizione dei dati sulla monetizzazione

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Apigee utilizza le variabili di monetizzazione per la valutazione, il calcolo della quota di entrate e l'analisi. Se vuoi che le analisi Apigee mostrino le informazioni sulla monetizzazione. Utilizzando le variabili di monetizzazione, puoi migliorare le funzionalità di monetizzazione delle tue transazioni.

Variabili di monetizzazione

I nomi delle variabili di monetizzazione sono predefiniti e non puoi creare, modificare o eliminare le variabili. Puoi assegnare variabili di richiesta o di risposta alle variabili di monetizzazione.

Questa tabella descrive le variabili di monetizzazione disponibili in Apigee:

Variabile di monetizzazione Tipo di dati Descrizione
currency Stringa Specifica la valuta per il calcolo delle entrate derivanti da una transazione.
perUnitPriceMultiplier Numero in virgola mobile Specifica il fattore (moltiplicatore) per cui viene moltiplicato il costo per transazione. Il costo per transazione è specificato nei prezzi delle commissioni basate sul consumo del piano tariffario. La moltiplicazione viene eseguita per una transazione solo se la transazione è monetizzabile. Una transazione è monetizzabile se è soddisfatta una delle seguenti condizioni:
  • Se la variabile transactionSuccess è true.
  • Se la variabile transactionSuccess è NULL e message.status.code è 2xx (operazione riuscita).
revShareGrossPrice Numero in virgola mobile

Specifica le entrate della transazione per calcolare la quota dello sviluppatore. Apigee calcola la quota dello sviluppatore solo se hai attivato la condivisione delle entrate nel tuo piano tariffario.
transactionSuccess boolean Specifica se la transazione deve essere monetizzata.
  • Se la variabile è impostata su true, la transazione viene monetizzata.
  • Se la variabile è impostata su false, la transazione non viene monetizzata.

    • Se non specifichi questa variabile, la monetizzazione delle transazioni si basa sul valore del codice di stato HTTP disponibile nella variabile message.status.code. Se il codice di stato HTTP della risposta è NULL o >=300, una transazione non viene monetizzata; per tutti gli altri codici di stato, la transazione viene monetizzata.

Esempi di assegnazione di valori

I seguenti esempi mostrano come assegnare valori alle variabili di monetizzazione:

currency

L'esempio seguente assegna il valore dell'elemento JSON booking[0].currency nella risposta alla variabile currency:

<Capture>
  <Collect>
    <Source>response</Source>
    <JSONPayload>
      <JSONPath>booking[0].currency</JSONPath>
    </JSONPayload>
  </Collect>
  <DataCollector scope="monetization">currency</DataCollector>
</Capture>

perUnitPriceMultiplier

L'esempio seguente assegna il valore dell'elemento JSON booking[0].factor nella risposta alla variabile perUnitPriceMultiplier:

<Capture>
  <Collect>
    <Source>response</Source>
    <JSONPayload>
      <JSONPath>booking[0].factor</JSONPath>
    </JSONPayload>
  </Collect>
  <DataCollector scope="monetization">perUnitPriceMultiplier</DataCollector>
</Capture>

revShareGrossPrice

L'esempio seguente assegna il valore della variabile minPrice nell'intestazione della risposta alla variabile revShareGrossPrice:

<Capture>
  <Collect>
    <Source>response</Source>
    <Header name="minPrice">
      <Pattern ignoreCase="true">{$}</Pattern>
    </Header>
  </Collect>
  <DataCollector scope="monetization">revShareGrossPrice</DataCollector>
</Capture>

transactionSuccess

L'esempio seguente assegna il valore della variabile bookingStatus nell'intestazione della risposta alla variabile transactionSuccess:

<Capture>
  <Collect>
    <Source>response</Source>
    <Header name="bookingStatus">
      <Pattern ignoreCase="true">{$}</Pattern>
    </Header>
  </Collect>
  <DataCollector scope="monetization">transactionSuccess</DataCollector>
</Capture>