Monetarisierungsdaten erfassen

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Apigee verwendet die Monetarisierungsvariablen für die Bewertung, die Berechnung der Umsatzbeteiligung und die Analyse. Wenn Ihre Apigee-Analyse die Monetarisierungsinformationen anzeigen soll. Mit den Monetarisierungsvariablen können Sie die Monetarisierungsfunktionen Ihrer Transaktionen verbessern.

Monetarisierungsvariablen

Die Namen der Monetarisierungsvariablen sind vordefiniert und Sie können die Variablen nicht erstellen, bearbeiten oder löschen. Sie können den Monetarisierungsvariablen entweder die Anfrage- oder die Antwortvariablen zuweisen.

In dieser Tabelle werden die in Apigee verfügbaren Monetarisierungsvariablen beschrieben:

Monetarisierungsvariable Datentyp Beschreibung
currency String Gibt die Währung für die Berechnung des Umsatzes aus einer Transaktion an.
perUnitPriceMultiplier Float Gibt den Faktor (Multiplikator) an, mit dem die Kosten pro Transaktion multipliziert werden. Die Kosten pro Transaktion werden in den nutzungsbasierten Gebühren des Tarifs angegeben. Die Multiplikation wird nur dann für eine Transaktion ausgeführt, wenn die Transaktion monetarisierbar ist. Eine Transaktion ist monetarisierbar, wenn eine der folgenden Bedingungen erfüllt ist:
  • Wenn die transactionSuccess-Variable true ist.
  • Wenn die transactionSuccess-Variable NULL ist und message.status.code den Wert 2xx (Erfolg) hat.
revShareGrossPrice Float

Gibt den Umsatz der Transaktion zur Berechnung des Entwickleranteils an. Apigee berechnet den Anteil des Entwicklers nur, wenn Sie die Umgebungsvariable in Ihrem Tarif aktiviert haben.
transactionSuccess Boolesch Gibt an, ob die Transaktion monetarisiert werden soll.
  • Die Transaktion wird monetarisiert, wenn die Variable auf true gesetzt ist.
  • Wenn die Variable auf false gesetzt ist, wird die Transaktion nicht monetarisiert.

    • Wenn Sie diese Variable nicht angeben, werden die Transaktionen basierend auf dem Wert des in der Variablen message.status.code verfügbaren HTTP-Statuscodes monetarisiert. Wenn der HTTP-Statuscode der Antwort NULL oder >=300 ist, wird eine Transaktion nicht monetarisiert. Für alle anderen Statuscodes wird die Transaktion monetarisiert.

Beispiele für die Wertzuweisung

Die folgenden Beispiele zeigen, wie Sie den Monetarisierungsvariablen Werte zuweisen:

currency

Im folgenden Beispiel wird der Wert des JSON-Elements booking[0].currency in der Antwort der Variable currency zugewiesen:

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

perUnitPriceMultiplier

Im folgenden Beispiel wird der Wert des JSON-Elements booking[0].factor in der Antwort der Variable perUnitPriceMultiplier zugewiesen:

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

revShareGrossPrice

Im folgenden Beispiel wird der Wert der Variable minPrice im Antwortheader der Variable revShareGrossPrice zugewiesen:

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

transactionSuccess

Im folgenden Beispiel wird der Wert der Variable bookingStatus im Antwortheader der Variable transactionSuccess zugewiesen:

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