Capturer les données de monétisation

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d'Apigee Edge.

Apigee utilise les variables de monétisation pour l'évaluation, le calcul du partage des revenus et l'analyse. Si vous souhaitez que vos analyses Apigee affichent les informations de monétisation. En utilisant les variables de monétisation, vous pouvez améliorer les capacités de monétisation de vos transactions.

Variables de monétisation

Les noms des variables de monétisation sont prédéfinis. Vous ne pouvez pas en créer, ni modifier ou supprimer les noms existants. Vous pouvez associer les variables de requête ou les variables de réponse aux variables de monétisation.

Ce tableau décrit les variables de monétisation disponibles dans Apigee :

Variable de monétisation	Type de données	Description
currency	Chaîne	Spécifie la devise utilisée pour calculer les revenus d'une transaction.
perUnitPriceMultiplier	Float	Spécifie le facteur (multiplicateur) par lequel le coût par transaction est multiplié. Le coût par transaction est spécifié dans les frais basés sur la consommation du plan tarifaire. La multiplication n'est effectuée pour une transaction que si celle-ci est monétisable. Une transaction est monétisable si l'une des conditions suivantes est remplie : La valeur de la variable `transactionSuccess` est `true`. La valeur de la variable `transactionSuccess` est `NULL` et la valeur de `message.status.code` est `2xx` (succès).
revShareGrossPrice	Float	Spécifie le revenu de la transaction pour le calcul de la part du développeur. Apigee ne calcule la part du développeur que si vous avez activé le partage des revenus dans votre plan tarifaire.
transactionSuccess	boolean	Indique si la transaction doit être monétisée. Si la variable est définie sur `true`, la transaction est monétisée. Si la variable est définie sur `false`, la transaction n'est pas monétisée. Si vous ne spécifiez pas cette variable, les transactions sont monétisées ou non en fonction de la valeur du code d'état HTTP disponible dans la variable `message.status.code`. Si le code d'état HTTP de la réponse est "NULL" ou supérieur à 300, la transaction n'est pas monétisée. Pour tous les autres codes d'état, la transaction est monétisée. Remarque : Si la valeur de `transactionSuccess` n'est pas une valeur booléenne, la règle DataCapture évalue la variable `mint.tx_success_result` comme `false`.

Exemples d'attribution de valeur

Les exemples suivants montrent comment attribuer des valeurs aux variables de monétisation :

currency

L'exemple suivant attribue la valeur de l'élément JSON booking[0].currency de la réponse à la variable currency :

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

perUnitPriceMultiplier

L'exemple suivant attribue la valeur de l'élément JSON booking[0].factor de la réponse à la variable perUnitPriceMultiplier :

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

revShareGrossPrice

L'exemple suivant attribue la valeur de la variable minPrice de l'en-tête de réponse à la variable revShareGrossPrice :

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

transactionSuccess

L'exemple suivant attribue la valeur de la variable bookingStatus de l'en-tête de réponse à la variable transactionSuccess :

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