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 classificazione, il calcolo della quota di condivisione delle entrate e l'analisi. Se vuoi che gli Analytics 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 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 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 prezzo 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 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 è 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

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

Nell'esempio seguente, il valore della variabile minPrice nell'intestazione di 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>