Acquisizione dei dati sulla monetizzazione

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza documentazione di Apigee Edge.

Apigee utilizza le variabili di monetizzazione per la valutazione, il calcolo della quota di condivisione delle entrate e le 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 puoi 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 Stringa Specifica la valuta per il calcolo delle entrate di una transazione.
perUnitPriceMultiplier Numero in virgola mobile Specifica il fattore (moltiplicatore) per cui viene moltiplicato il costo per transazione. Il costo per transazione è specificato nel piano tariffario Prezzi delle tariffe basate sul consumo. La moltiplicazione viene eseguita per una transazione solo se la transazione è monetizzabili. Una transazione è monetizzabile se una delle seguenti condizioni è soddisfatto:
  • Se la variabile transactionSuccess è true.
  • Se la variabile transactionSuccess è NULL e la variabile message.status.code è 2xx (esito positivo).
revShareGrossPrice Numero 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 dei valori

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, il valore della variabile minPrice nell'intestazione della risposta viene assegnato 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, il valore della variabile bookingStatus nell'intestazione di risposta viene assegnato alla variabile transactionSuccess:

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