Acquisizione dei dati di 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 condivisione delle entrate e l'analisi. Se vuoi che le analisi di 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 è possibile crearle, modificarle o eliminarle. Puoi assegnare variabili di richiesta o risposta alle variabili di monetizzazione.

Questa tabella descrive le variabili di monetizzazione disponibili in Apigee:

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

Specifica le entrate della transazione per il calcolo della 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, la transazione non viene monetizzata; per tutti gli altri codici di stato, la transazione viene monetizzata.

Esempi di assegnazione del valore

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

currency

Nell'esempio seguente viene assegnato 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

Nell'esempio seguente viene assegnato 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

Nell'esempio seguente viene assegnato 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

Nell'esempio seguente viene assegnato 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>