Raporları yönetin

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Giriş

Para kazanma raporları, odaklanmış kullanım bilgilerine ve işlem etkinliğine erişmenizi sağlar. Örneğin, hangi uygulamaların, geliştiricilerin, API ürün paketlerinin veya API ürünlerinin, belirli bir tarih aralığındaki işlem etkinliğidir. Para kazanma özelliğiyle, API kullanımını izleyen özet veya ayrıntılı raporlar oluşturabilirsiniz.

Para kazanma raporu türleri

Aşağıdaki türde para kazanma raporları oluşturabilirsiniz.

Veri saklama hakkında

Apigee Edge herkese açık bulutunda, para kazanma verilerinin saklanabilmesi plan kapsamındaki bir özelliktir. Bkz. https://cloud.google.com/apigee/specsheets adresine giderek para kazanma haklarından yararlanabilirsiniz. Para kazanma verilerinizin geçerlidir. Genişletilmiş veri saklama, istek sırasında etkinleştirilir ve orijinal veri saklama aralığından önceki verileri içerecek şekilde geriye dönük olarak etkinleştirilemez.

Yinelenen işlemler hakkında

Para kazanma işlemi raporlarını Analytics verileriyle karşılaştırırsanız az sayıda yinelenen işlem olduğunu fark edebilirsiniz. Para kazanma sistemi, herhangi bir zamanda paralel olarak işlenen birçok işlemle birlikte günde birkaç milyon işlem işleyebildiğinden bu beklenen bir davranıştır. Ortalama olarak, işlemlerin yaklaşık% 0,1'i kopya olabilir.

Para Kazanma Raporları sayfasını keşfetme

Aşağıda açıklanan şekilde Para Kazanma Raporları sayfasına erişin.

Raporu yapılandırma

Aşağıdaki bölümlerde açıklandığı gibi, kullanıcı arayüzünü kullanarak bir raporu yapılandırın.

Rapor yapılandırma adımları

Edge kullanıcı arayüzü veya Classice Edge kullanıcı arayüzünü kullanarak bir raporu yapılandırın.

Faturalandırma raporunu yapılandırma

Rapor yapılandırmaya yönelik adımları uygulayın ve rapor sayfasına aşağıdaki bilgileri girin:

Ön ödeme bakiyesi raporunu yapılandırma

Gelir raporunu yapılandırma

Rapor yapılandırma adımlarını uygulayın ve rapor sayfasına aşağıdaki bilgileri girin:

Gelir özeti raporlarına özel işlem özelliklerini ekleme

İşlem kaydı politikaları, işlemlerden özel özellik verilerini yakalamanıza olanak tanır. Bu özel özellikleri özet gelir raporlarına ekleyebilirsiniz. Kuruluşunuzun MINT.SUMMARY_CUSTOM_ATTRIBUTES mülkünü ayarlayarak para kazanma veritabanı tablolarına dahil edilecek varsayılan özel özellik grubunu tanımlayın.

Bu özelliği kullanırken üzerinde biraz düşünüp planlama yapmanızı gerektirir. Bu nedenle, aşağıdaki hususları gözden geçirin.

Cloud müşterisiyseniz mülkü ayarlamak için Apigee Edge Destek Ekibi ile iletişime geçin. Private Cloud için Apigee Edge müşterisiyseniz aşağıdaki API'ye Sistem Yöneticisi kimlik bilgileriyle bir PUT isteği göndererek işareti ayarlayın.

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:port/v1/o/{myorg} -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;partner_id&quot;,&quot;tax_source&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

Bu örnekte API çağrısı, Şuna partner_id ve tax_source sütunları ekler: veritabanını kullanarak kontrol edebilirsiniz. API çağrısındaki özel özellik dizisinin URL olarak kodlandığını unutmayın.

Raporlara özel işlem özellikleri eklerken dikkate alınması gereken noktalar

• API ile oluşturmadan önce kullanmak istediğiniz özellik adları konusunda emin olun. Bunlar veritabanındaki sütun adlarıdır ve özel özellik verileri her zaman burada depolanır.
• Her işlem kaydetme politikasında 10 özel özellik yuvası bulunur. aşağıdaki resimde gösteriliyor. Raporlara dahil edilecek ürünlerde aynı özellikler için bire bir aynı özellik adlarını ve konumlarını kullanın. Örneğin, aşağıdaki işlem kaydetme politikası, partner_id ve tax_source özel özellikleri sırasıyla 4 ve 5 numaralı kutuları doldurur. Bu kişinin ismi ve raporlamaya dahil edilecek ürünlerle ilgili işlem kaydetme politikaları.
  
  

Özelliği etkinleştirdikten sonra özet gelir raporuna özel özellikler eklemek için MintCriteria alanına transactionCustomAttributes ekleyerek rapor API'sini kullanın. Ölçüt yapılandırma seçeneklerine bakın.

Varyans raporunu yapılandırma (Desteği sonlandırıldı)

Rapor yapılandırmaya yönelik adımları uygulayın ve rapor sayfasına aşağıdaki bilgileri girin:

Rapor oluşturma ve indirme

Bir rapor oluşturduktan sonra, raporun sonuçlarını CSV veya zip dosyası biçiminde indirebilirsiniz. CSV veya ZIP dosyasını eşzamanlı ya da eşzamansız olarak oluşturabilirsiniz.

• Eşzamanlı rapor için rapor isteğini çalıştırırsınız ve istek engellenir yanıt verene kadar bekleyin. Ancak bir raporun hazırlanması ve büyük miktarda veri içeriyorsa (örneğin, 100 GB'lık) bir eşzamanlı rapor, zaman aşımı nedeniyle başarısız olabilir.

  Özet rapor düzeyi yalnızca eşzamanlı oluşturmayı destekler.

• Asenkron rapor için rapor isteğini çalıştırır ve sonuçları daha sonra alırsınız. Eşzamansız sorgu işlemenin iyi sonuç verebileceği bazı durumlar alternatifi şunlardır:

  • Uzun zaman aralıkları kapsayan raporları analiz etme ve oluşturma
  • Sorguya karmaşıklık katan çeşitli gruplandırma boyutları ve diğer kısıtlamalarla verileri analiz etme.
  • Bazı kullanıcılar veya kuruluşlar için veri hacimlerinin önemli ölçüde arttığını tespit ettiğinizde sorguları yönetme

  Ayrıntılı rapor düzeyi, eşzamansız oluşturmayı destekler.

CSV veya zip dosyası biçiminde bir rapor oluşturmak ve indirmek için aşağıdaki görevlerden birini gerçekleştirin:

1. Raporlar sayfasına gidin.
2. İmleci, indirmek istediğiniz raporun üzerine getirin.

3. Değiştirildi sütununda aşağıdakilerden birini tıklayın:

   1. simgesi veya simgesi (Özet raporu için). Rapor, senkronize olarak bir CSV veya zip dosyasına kaydedilir.
   2. İşi gönder (ayrıntılı rapor için). Eşzamansız iş başlar.

      1. Değiştirilme tarihi sütununda işin durumunu izleyin.

         Rapor indirilmeye hazır olduğunda disk simgesi gösterilir:

         
      2. İş tamamlandıktan sonra, raporu indirmek için disk simgesini tıklayın.

Aşağıda, özet faturalandırma raporu için bir CSV dosyası örneği verilmiştir.

Raporları düzenleme

Bir raporu düzenlemek için:

1. Raporlar sayfasına erişin.
2. İmleci düzenlemek istediğiniz raporun üzerine getirin ve işlemler menüsünde simgesini tıklayın.
3. Gerekirse rapor yapılandırmasını güncelleyin.
4. Güncellenen rapor yapılandırmasını kaydetmek için Raporu güncelle'yi tıklayın.

Rapor silme

Bir raporu silmek için:

1. Raporlar sayfasına gidin.
2. İmleci, silmek istediğiniz raporun üzerine getirin.
3. İşlemler menüsünde simgesini tıklayın.

API kullanarak para kazanma raporlarını yönetme

Aşağıdaki bölümlerde, API'yi kullanarak para kazanma raporlarının nasıl yönetileceği açıklanmaktadır.

API'yi kullanarak rapor yapılandırma

Bir kuruluşun tamamı için rapor yapılandırmak üzere şu adrese bir POST isteği gönderin: /organizations/{org_name}/report-definitions

Belirli bir geliştirici için rapor yapılandırmak üzere /organizations/{org_name}/developers/{dev_id}/report-definitions, burada: {dev_id}, geliştiricinin kimliğidir.

İsteği gönderirken raporun adını ve türünü belirtmeniz gerekir. Tür şulardan biri olmalıdır: BILLING, REVENUE, VARIANCE (desteği sonlandırıldı) veya PREPAID_BALANCE. Ayrıca, mintCriteria mülkünde raporu daha da yapılandıran ölçütler belirtebilirsiniz. Belirleyebileceğiniz çok çeşitli ölçütler vardır. Bu, raporu yapılandırma konusunda size büyük ölçüde esneklik sağlar. Ölçüt olarak belirtebileceğiniz şeylerden bazıları şunlardır:

• Faturalandırma veya ön ödemeli bakiye raporu için raporun faturalandırma ayı
• Bir gelir raporu için raporda yer alan işlemlerin türü (ör. satın alma) işlemler, ödeme alma işlemleri ve geri ödemeler
• Ön ödemeli bakiye raporu için raporun geçerli olduğu geliştirici
• Bir gelir raporu için, rapor geçerlidir
• Gelir veya varyans raporu için raporun geçerli para birimi
• Faturalandırma, ön ödemeli bakiye veya gelir raporları için raporun özet rapor mu yoksa ayrıntılı rapor mu olduğu
• Gelir özeti raporu için rapora özel işlem özellikleri ekleyin

Rapor ölçütlerinin tam listesi için Rapor yapılandırma seçenekleri başlıklı makaleyi inceleyin.

Örneğin, aşağıdaki ifade Temmuz 2015 ayına ait işlem etkinliğini özetleyen bir gelir raporu oluşturur. Bu rapor, transactionTypes mülküdür ve özellikle Payment API ürün paketi ve Ödeme API'si ürünü. Raporda belirli bir geliştirici veya uygulama belirtilmediği için bu rapor tüm geliştiriciler ve uygulamalar için geçerlidir. Ayrıca currencyOption özelliği LOCAL olarak ayarlanırsa raporun her satırında Geçerli ücret planının para birimi kullanılarak görüntülenmelidir. Ayrıca, groupBy mülkü, rapordaki sütunların aşağıdaki sırayla gruplandırılacağını belirtir: PACKAGE, PRODUCT, DEVELOPER, APPLICATION ve RATEPLAN (raporda ücret planı adını ve kimliğini içerir).

$ curl -H "Content-Type: application/json" -X POST -d \
'{
      "name": "July 2015 revenue report",
      "description": " July 2015 revenue report for Payment product",
      "type": "REVENUE",     
      "mintCriteria":{
         "fromDate":"2015-07-01 00:00:00",
         "toDate":"2015-08-01 13:35:00",
         "showTxDetail":true,
         "showSummary":true,
         "transactionTypes":[
            "PURCHASE",
            "CHARGE",
            "REFUND",
            "CREDIT",
            "SETUPFEES",
            "TERMINATIONFEES",
            "RECURRINGFEES"
         ],
         "monetizationPackageIds":[
            "payment"
         ],
         "productIds":[
            "payment"
         ],
         "currencyOption":"LOCAL",
         "groupBy":[
            "PACKAGE",
            "PRODUCT",
            "DEVELOPER",
            "APPLICATION",
            "RATEPLAN"
         ]
      }
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/report-definitions" \
-u email:password

Aşağıdaki komut, DEV FIVE adlı geliştiricinin Haziran 2015'teki etkinliğini gösteren ayrıntılı bir faturalandırma raporu oluşturur.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
      "name": "June billing report, DEV FIVE",
      "description": "June billing report, DEV FIVE",
      "type": "BILLING",      
      "mintCriteria":{
         "billingMonth": "JUNE",
         "billingYear": 2015,
         "showTxDetail":true,
         "showSummary":false,         
         "currencyOption":"LOCAL"         
      },
      "devCriteria":[{
         "id":"RtHAeZ6LtkSbEH56",
         "orgId":"myorg"}]
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/5cTWgdUvdr6JW3xU/report-definitions" \
-u email:password

API'yi kullanarak rapor yapılandırmalarını görüntüleme

Bir kuruluşa ait belirli bir rapor yapılandırmasını veya tüm rapor yapılandırmalarını görüntüleyebilirsiniz. Ayrıca, tek bir geliştiricinin rapor yapılandırmalarını da görüntüleyebilirsiniz.

Bir kuruluşa yönelik belirli bir rapor yapılandırmasını görüntülemek için şuna bir GET isteği gönderin: /organizations/{org_name}/report-definitions/{report_definition_id}, burada: {report_definition_id}, özel rapor yapılandırmasının ( Rapor yapılandırmasını oluşturduğunuzda yanıtta kimlik döndürülür). Örneğin:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/report-definitions/1f7fa53b-de5a-431d-9438-62131e1396c5" \
-u email:password

Kuruluşun tüm rapor yapılandırmalarını görüntülemek için /organizations/{org_name}/report-definitions adresine bir GET isteği gönderin.

Sonuçları filtrelemek ve sıralamak için aşağıdaki sorgu parametrelerini iletebilirsiniz:

Örneğin, aşağıdaki ifade kuruluşun rapor yapılandırmalarını döndürür ve getirme işlemini en fazla beş rapor yapılandırmasıyla sınırlandırır:

$ curl -H "Accept:application/json" -X GET \ 
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/report-definitions?size=5" \ 
-u email:password

Yanıtın görünümü aşağıdaki gibi olacaktır (yanıtın yalnızca bir kısmı gösterilmiştir):

{
  "reportDefinition" : [ {
    "description" : "Test revenue report",
    "developer" : null,
    "id" : "1f7fa53b-de5a-431d-9438-62131e1396c5",
    "lastModified" : "2015-08-27 15:44:03",
    "mintCriteria" : {
      "asXorg" : false,
      "currencyOption" : "LOCAL",
      "fromDate" : "2015-07-01 00:00:00",
      "groupBy" : [ "PACKAGE", "PRODUCT", "DEVELOPER", "APPLICATION", "RATEPLAN" ],
      "monetizationPackageIds" : [ "payment" ],
      "productIds" : [ "payment" ],
      "showRevSharePct" : false,
      "showSummary" : true,
      "showTxDetail" : true,
      "showTxType" : false,
      "toDate" : "2015-08-01 00:05:00",
      "transactionTypes" : [ "PURCHASE", "CHARGE", "REFUND", "CREDIT", "SETUPFEES", "TERMINATIONFEES", "RECURRINGFEES" ]
    },
    "name" : "Test revenue report",
    "organization" : {
      ...
    },
    "type" : "REVENUE"
  }, {
    "description" : "June billing report, DEV FIVE",
    "developer" : null,
    "id" : "fedac696-ce57-469b-b62c-a77b535fd0eb",
    "lastModified" : "2015-08-27 17:13:20",
    "mintCriteria" : {
      "asXorg" : false,
      "billingMonth" : "JUNE",
      "billingYear" : 2015,
      "currencyOption" : "LOCAL",
      "showRevSharePct" : false,
      "showSummary" : false,
      "showTxDetail" : true,
      "showTxType" : false
    },
    "name" : "June billing report, DEV FIVE",
    "organization" : {
      ...
    },
    "type" : "BILLING"
  } ],
  "totalRecords" : 2
}

Belirli bir geliştiricinin rapor yapılandırmalarını görüntülemek için /organizations/{org_name}/developers/{dev_id}/report-definitions adresine bir GET isteği gönderin. Burada {dev_id}, geliştiricinin kimliğidir. Bu isteği gönderirken verileri filtrelemek ve sıralamak için yukarıda açıklanan sorgu parametrelerini belirtin.

Örneğin, aşağıdaki örnek, belirli bir geliştiriciye ait rapor yapılandırmalarını döndürür ve rapor adına göre yanıt:

$ curl -H "Accept:application/json" -X GET \ 
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/5cTWgdUvdr6JW3xUreport-definitions?sort=name" \ 
-u email:password

API'yi kullanarak rapor yapılandırmasını güncelleme

Rapor yapılandırmasını güncellemek için bir PUT isteği gönderin: /organizations/{org_name}/report-definitions/{report_definition_id}, burada: {report_definition_id}, özel rapor yapılandırmasının tanımıdır. Güncellemeyi yaparken istek gövdesinde güncellenmiş yapılandırma değerlerini ve rapor yapılandırmasının kimliğini belirtmeniz gerekir. Örneğin, aşağıdaki istek, raporu özet rapor olarak günceller (güncellenen özellikler vurgulanmıştır):

$ curl -H "Content-Type: application/json" -X PUT -d \
 '{
       "id": "fedac696-ce57-469b-b62c-a77b535fd0eb",
       "name": "June billing report, DEV FIVE",
       "description": "June billing report, DEV FIVE",
       "type": "BILLING",      
       "mintCriteria":{      
         "billingMonth": "JUNE",
         "billingYear": 2015,
         "showTxDetail":false,
         "showSummary":true    
        }     
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/report-definitions/fedac696-ce57-469b-b62c-a77b535fd0eb" \
-u email:password

Yanıtın görünümü aşağıdaki gibi olacaktır (yanıtın yalnızca bir kısmı gösterilmiştir):

{
 "description" : "June billing report, DEV FIVE",
  "developer" : null,
  "id" : "fedac696-ce57-469b-b62c-a77b535fd0eb",
  "lastModified" : "2015-08-27 17:47:29",
  "mintCriteria" : {
    "asXorg" : false,
    "billingMonth" : "JUNE",
    "billingYear" : 2015,
    "showRevSharePct" : false,
    "showSummary" : true,
    "showTxDetail" : false,
    "showTxType" : false
  },
  "name" : "June billing report, DEV FIVE",
  "organization" : {
    ... 
  },
  "type" : "BILLING"
}

API'yi kullanarak rapor yapılandırmasını silme

Bir rapor yapılandırmasını silmek için /organizations/{org_namer}/report-definitions/{report_definition_id} adresine DELETE isteği gönderin. Bu adreste {report_definition_id}, silinecek rapor yapılandırmasının kimliğidir. Örneğin:

$ curl -H "Accept:application/json" -X DELETE \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/report-definitions/fedac696-ce57-469b-b62c-a77b535fd0eb" \
-u email:password

API kullanarak rapor oluşturma

Yapılandırdığınız raporları görüntülemek için virgülle ayrılmış değerler (CSV) dosya biçiminde oluşturabilirsiniz.

Rapor oluşturmak için bir POST isteği gönderin organizations/{org_id}/{report_type}; burada {report_type}, türünü seçin. Türler şunlardır:

• billing-reports
• revenue-reports
• prepaid-balance-reports
• variance-reports

Örneğin, faturalandırma raporu oluşturmak için organizations/{org_name}/billing-reports adresine POST isteği gönderin.

İstek gövdesinde (tüm rapor türleri için) rapora ilişkin arama ölçütlerini belirtin. Tekliflerinizi otomatikleştirmek ve optimize etmek için Arama ölçütlerini belirtmek için mintCriteria özelliklerini kullanın. Daha fazla ayrıntı için Ölçüt yapılandırma seçenekleri bölümüne bakın.

Örneğin, aşağıdaki istek çeşitli ölçütlere dayalı olarak bir gelir raporu arar. (ör. rapor başlangıç ve bitiş tarihleri ile işlem türleri)

$ curl -H "Content-Type:application/json" -H "Accept: application/octet-stream" -X POST -d \
'{
      "fromDate":"2015-07-01 00:00:00",
      "toDate":"2015-08-01 13:35:00",
      "showTxDetail":true,
      "showSummary":true,                
      "transactionTypes":[
        "PURCHASE",
        "CHARGE",
        "REFUND",
        "CREDIT",
        "SETUPFEES",
        "TERMINATIONFEES",
        "RECURRINGFEES"
      ],
      "currencyOption":"LOCAL",
      "groupBy":[
        "PACKAGE",
        "PRODUCT",
        "DEVELOPER",
        "APPLICATION",
        "RATEPLAN"]
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/revenue-reports" \
-u email:password

Gelir raporu bulunursa CSV dosyası biçiminde oluşturulur. Aşağıda, rapor çıkışına dair bir örnek verilmiştir:

Reporting Period:,From:,2015-07-01,  To:,2015-07-31
API Product:,All
Developer:,All
Application:,All
Currency:,Local
Type of Report:,Summary Revenue Report

Monetization Package,Package ID,API Product,Product ID,Developer Name,Developer ID,Application Name,Application ID,Rate Plan,Plan ID,Currency,Transaction Type,Provider Status,Total Volume,Charged Rate,
Location,location,foo_product,foo_product,Apigee,QQ7uxeMGf3w9W08B,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,
Location,location,foo_product,foo_product,BarCompany,barcompany,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,
Location,location,foo_product,foo_product,fremont,fremont,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,
Location,location,foo_product,foo_product,Juan's Taco Shack,juan-s-taco-sha,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,

Gelir raporlarına geliştirici özel özelliklerini eklemek için API

Yalnızca gelir raporları için rapora özel özellikler ekleyebilirsiniz. özelliği tarafından tanımlanmıştır. Geliştiricilere geliştirici eklerken özel Uygulama geliştiricilerini yönetme bölümünde açıklandığı şekilde kuruluşunuzda.

Bir gelir raporuna özel özellikler eklemek için organizations/{org_name}/revenue-reports adresine bir POST isteği gönderin ve istek gövdesine devCustomAttributes dizisini ekleyin:

"devCustomAttributes": [
    "custom_attribute1",
    "custom_attribute2",
    ...
]

Not: Önceden tanımlanmış MINT_* ve devCustomAttributes dizisindeki ADMIN_* özellikleri.

Örneğin, aşağıdaki örnekte raporda BILLING_TYPE, SFID ve ORG_EXT olmak üzere üç özel özellik (geliştirici için tanımlanmışsa) yer alır:

$ curl -H "Content-Type:application/json" -H "Accept: application/octet-stream" -X POST -d \
'{
      "fromDate":"2015-07-01 00:00:00",
      "toDate":"2015-08-01 13:35:00",
      "showTxDetail":true,
      "showSummary":true,                
      "transactionTypes":[
        "PURCHASE",
        "CHARGE",
        "REFUND",
        "CREDIT",
        "SETUPFEES",
        "TERMINATIONFEES",
        "RECURRINGFEES"
      ],
      "currencyOption":"LOCAL",
      "groupBy":[
        "PACKAGE",
        "PRODUCT",
        "DEVELOPER",
        "APPLICATION",
        "RATEPLAN"
      ],
      "devCustomAttributes": [
         "BILLING_TYPE",
         "SFID",
         "ORG_EXT"
      ]
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/revenue-reports" \
-u email:password

Aşağıda, iki özel rapora ait değerleri içeren bir rapor çıkışı örneği gösterilmektedir özellikler:

Reporting Period:,From:,2015-07-01,  To:,2015-07-31
API Product:,All
Developer:,All
Application:,All
Currency:,Local
Type of Report:,Summary Revenue Report

Monetization Package,Package ID,API Product,Product ID,Developer Name,Developer ID,Application Name,Application ID,Rate Plan,Plan ID,Currency,Transaction Type,Provider Status,Total Volume,Charged Rate,BILLING_TYPE,SFID,ORG_EXT 
Location,location,foo_product,foo_product,Apigee,QQ7uxeMGf3w9W08B,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,PREPAID,123,3AA,
Location,location,foo_product,foo_product,BarCompany,barcompany,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,PREPAID,123,3AA,
Location,location,foo_product,foo_product,fremont,fremont,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,PREPAID,123,3AA,
Location,location,foo_product,foo_product,Juan's Taco Shack,juan-s-taco-sha,my_app,my_app,rate_plan_1,location_rate_plan_1,USD,SETUPFEES,SUCCESS,1,15.0000,PREPAID,123,3AA,

API'yi kullanarak işlem etkinliğini raporlama

/organizations/{org_name}/transaction-search adresine POST isteği göndererek bir kuruluşun işlem etkinliğini görüntüleyebilirsiniz. Talebinizi iletirken şunları yapmanız gerekir: alınması için ölçütleri belirtir. Ölçüt olarak belirtebileceğiniz bazı şeyler:

• İşlemlerin yapıldığı bir veya daha fazla API ürününün kimliği.
• İşlemlerin fatura ayı ve yılı.
• İşlemi gerçekleştiren geliştiriciler.
• İşlemin türü (ör. satın alma ve kurulum ücretleri).
• İşlemin başarılı ve başarısız gibi durumudur.

Ölçütlerin tam listesi için Ölçüt yapılandırma seçenekleri başlıklı makaleyi inceleyin.

Örneğin, aşağıdaki işlemler, faturalandırma için belirli bir geliştirici tarafından gerçekleştirilen işlemleri döndürür. ay Haziran 2015:

$ curl -H "Content-Type:application/json" -X POST -d \
 '{        
    "billingMonth": "JUNE",
    "billingYear": 2015,
    "devCriteria": [{
      "id": "RtHAeZ6LtkSbEH56",
      "orgId":"myorg"}],
    "transactionTypes": ["PURCHASE", "CHARGE", "SETUPFEES"],
    "transactionStatus": ["SUCCESS", "FAILED"]
    }'
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/transaction-search \
-u email:password

Ayrıca, hangi uygulamaların, geliştiricilerin, API ürün paketlerinin veya API ürünlerinin, belirli bir tarih aralığındaki işlem etkinliğidir. Bu bilgileri her biri için olacaktır. Örneğin, belirli bir başlangıç ve bitiş tarihi aralığında, para kazanılan API ürün paketlerinizdeki API'lere erişen uygulamalarla ilgili bilgileri görüntüleyebilirsiniz.

İşlem etkinliğiyle ilgili bilgileri görüntülemek için aşağıdakilerden birine GET isteği gönderin kaynaklar:

İsteği gönderirken sorgu parametreleri olarak başlangıç ve bitiş tarihi belirtmeniz gerekir seçin. Örneğin, aşağıdaki istek, elde etti.

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers-with-transactions?START_DATE=2015-08-01&END_DATE=2015-08-31" \
-u email:password

Yanıtın görünümü aşağıdaki gibi olacaktır (yanıtın yalnızca bir kısmı gösterilmiştir):

{
  "developer" : [ {
    "address" : [ {
      "address1" : "Dev Five Address",
      "city" : "Pleasanton",
      "country" : "US",
      "id" : "0917f15f-9521-4e69-9376-07aa7b7b32ca",
      "isPrimary" : true,
      "state" : "CA",
      "zip" : "94588"
    } ],
    "approxTaxRate" : 0.0900,
    "billingType" : "POSTPAID",
    "broker" : false,
    "developerRole" : [ ],
    "email" : "dev5@myorg.com",
    "hasSelfBilling" : false,
    "id" : "tJZG6broTpGGGeLV",
    "legalName" : "DEV FIVE",
    "name" : "Dev Five",
    "organization" : {
      ...
    },
    "registrationId" : "dev5",
    "status" : "ACTIVE",
    "type" : "UNTRUSTED"
  }, {
    "address" : [ {
      "address1" : "Dev Seven Address",
      "city" : "Pleasanton",
      "country" : "US",
      "id" : "f86d8c9f-6ed1-4323-b050-6adf494096c9",
      "isPrimary" : true,
      "state" : "CA",
      "zip" : "94588"
    } ],
    "approxTaxRate" : 0.0900,
    "billingType" : "POSTPAID",
    "broker" : false,
    "developerRole" : [ ],
    "email" : "dev7@myorg.com",
    "hasSelfBilling" : false,
    "id" : "VI3l8m8IPAvJTvjS",
    "legalName" : "DEV SEVEN",
    "name" : "Dev Seven",
    "organization" : {
      ...
    },
    "registrationId" : "dev7",
    "status" : "ACTIVE",
    "type" : "UNTRUSTED"
  }, ...
  ]
}

API için rapor yapılandırma seçenekleri

API'de aşağıdaki rapor yapılandırma seçenekleri kullanılabilir:

Ölçüt yapılandırma seçenekleri

mintCriteria mülkü aracılığıyla raporlar için aşağıdaki yapılandırma seçenekleri kullanılabilir:

"devCriteria":[{
    "id":"RtHAeZ6LtkSbEH56",
    "orgId":"my_org"}
]
                

"devCustomAttributes": [
    "custom_attribute1",
    "custom_attribute2",
    ...
]