Apigee Edge belgelerini görüntülüyorsunuz.
.
Git:
Apigee X belgeleri. bilgi
Giriş
Gelir paylaşımı planında API sağlayıcısı, bir yüzdesi geliştiriciyle paylaşılır. Her işlemden elde edilen gelir (bir işlemin brüt veya net fiyatına göre). Zaman bir gelir paylaşımı planı oluşturmanız gerekir. Paylaşım modeli belirtmeniz gerekir. veya esnek ve fiyatlandırma esasına göre (örneğin, gelir paylaşımının brüt veya net işlem tutarı dahil). İşlemin brüt veya net fiyatını işlem kaydetme politikasını oluştururken ayarlarsınız.
Sabit paylaşım modelinde, gelirin sabit bir yüzdesini geliştiriciyle paylaşırsınız. elde edilen gelirdir (bir işlemin brüt veya net fiyatına göre). esnek paylaşım modeli kullanarak, gelirin değişken bir yüzdesini geliştiriciyle paylaşırsınız. İlgili içeriği oluşturmak için kullanılan Gelir paylaşımı, belirli bir süre içinde elde edilen gelire bağlıdır. Kullanılan yüzde Gelir paylaşımı hesaplaması, işlemlerden elde edilen gelir tutarına göre değişebilir.
Gelir paylaşımı planı ayrıntılarını belirtmek için kullanıcı arayüzü
Gelir paylaşımı planlarını aşağıda açıklandığı şekilde yapılandırın.
Edge
Edge kullanıcı arayüzünü kullanarak bir gelir paylaşımı planı yapılandırmak için oluştururken veya düzenlerken Bir ücret planı için Gelir Paylaşımı veya Ücret Listesi ve Gelir Paylaşımı ücret planı türünü seçin ve Gelir paylaşımı bölümünde aşağıdaki bilgileri yapılandırın:
Alan | Açıklama |
Hesaplama modeli | Aşağıdaki fiyatlandırma türlerinden birini seçin:
|
Hesaplama sıklığı | İşlem hacminin (veya özel özellikle ilgili hacmin) hesaplandığı zaman aralığı. Ay sayısı (1-24 ay) seçin. |
Paylaşım modeli | Aşağıdaki gelir paylaşımı modellerinden birini seçin:
|
Sabit gelir paylaşımı | Sabit paylaşım modelinde, gelir paylaşımını hesaplamak için kullanılan yüzdeyi belirtir. Ondalık bir sayı (en fazla dört ondalık basamakla) girin. Örneğin, 80,5555 girerseniz gelir paylaşımı %80,5555 olur, yani bir API sağlayıcı olarak, her işlem için alınan fiyatın% 80,5555'ini geliştiriciye ödersiniz. |
Gelir paylaşımı aralıkları | Esnek paylaşım modeli için, bir veya daha fazla işlem geliri aralığı (her aralık bir "gelir aralığıdır"). Her bir gelir aralığına gelir paylaşımı yüzdesi atanabilir. İşlemler, işlemin toplam gelirinin ve gelir bandının hesaplanması için toplama esasına göre toplanır. Her işleme uygulanan gelir paylaşımı yüzdesi, işlemin gelir bandına bağlıdır. İlk bandın üst sınırını belirtin. Örneğin, en fazla 1.000 (alt sınır 0'dan büyük bir değere ayarlanır). İlave bant eklemek için +Yeni'yi tıklayın. Toplam gelir bu seviyenin üzerine çıktıktan sonra tüm işlemleri belirtmek için son bandın üst sınırını boş bırakın. Örneğin, Gelir Bandı bölümünde iki gelir bandı (>0-1000 ve 1000 ve üzeri) belirtirseniz >0-1000 gelir bandı için 80,5555 ve 1000 ve üstü gelir aralığı için 90,5 girebilirsiniz. Ayrıca para biriminin ABD doları olduğunu varsayalım. Ardından, 1.000 dolara varan gelir oluşturan işlemlerde gelir paylaşımı işlem fiyatının% 80, 5555'i olur. 1.000 dolardan fazla gelir oluşturan işlemler için gelir paylaşımı işlem fiyatının% 90, 5'i olur. |
Klasik Edge (Private Cloud)
Classic Edge kullanıcı arayüzünü kullanarak gelir paylaşımı planlarını yapılandırmak için:
- Ücret planı oluşturma adımlarını uygulayın.
- Gelir modelini yapılandırmak için Ücret Planı Türü açılır menüsünden Gelir Paylaşımı'nı seçin.
- Seçilen API paketi birden fazla API ürünü içeriyorsa aşağıdaki seçeneklerden birini belirleyin:
Not: API paketi tek bir API ürünü içeriyorsa bu adımı atlayabilirsiniz.
- Her API ürününün ücret planı ayrıntılarını ayrı ayrı yapılandırmak için Ürüne Özel Planlar.
- Tüm API ürünlerinde ücret planı ayrıntılarını yapılandırmak için Tüm Ürünler İçin Genel Plan.
- Genel ücret planı veya her bir API ürününe özel ücret planı için Gelir Paylaşımı'nı tıklayın.
Not: API ürününe özel planları yapılandırırken bir gelir paylaşımı planı yapılandırmanız gerekir. ürün feed'i oluşturmanız gerekir.
Gelir Paylaşımı penceresi açılır.
- Aşağıdaki paylaşım modellerinden birini seçin:
- Sabit: Bu modelde API sağlayıcısı, geliştiriciyle şu sabit yüzdeyi paylaşır: her bir işlemden elde edilen gelir (reklamın brüt veya net fiyatına göre) işlemi) ekleyebilirsiniz.
- Esnek: Bu modelde API sağlayıcısı, geliştiriciyle bir değişken paylaşır. yüzde 10'a varan oranda gelir. Gelir paylaşımı, belirli bir dönemde elde edilen gelire bağlıdır. kazanıyor. Gelir paylaşımı hesaplamasında kullanılan yüzde, tutara göre değişiklik gösterebilir. (işlemlerden elde edilen gelirin yüzde cinsinden değeri)
Sabit paylaşım modeli için:
Sabit paylaşım modelini seçerseniz Fiyatlandırma bölümüne aşağıdaki bilgileri girin bölümüne gidin:
Alan Açıklama Operatör (veya Kuruluş) Kuruluşunuzun adı. Bu alan, operatör (veya Kuruluş) alanındaki değere karşılık gelir.
Ülke Kuruluşunuzun faaliyet gösterdiği ülke. Bu alan, Kuruluş profilindeki ülke alanı değeri.
Para Birimi "Temel" şirketinizin kullandığı muhasebe para birimini temel alır. Bu alan önceden ayarlanmış kuruluş profilindeki Currency (Para Birimi) alanının değerini kullanarak.
Fiyatlandırma Türü Gelir paylaşımının temeli. Brüt veya Net'i seçin. Brüt'ü seçerseniz Gelir paylaşımı, bir işlemin brüt fiyatının belirli bir yüzdesine dayanır. Şu durumda: gelir paylaşımı, bir şirketin net fiyatının belirli bir yüzdesine göre, belirtir. Not: İşlemin brüt veya net fiyatını işlem kaydetme politikasını oluştururken ayarlarsınız.
Sabit Paylaşım Yüzdesi Gelir paylaşımını hesaplamak için kullanılan yüzde. Ondalık sayı girin ( en çok dört ondalık basamak). Örneğin, 80, 5555 girerseniz gelir paylaşımı %80,5555, yani API sağlayıcı olarak geliştiriciye fiyatın% 80, 5555'ini ödersiniz ücret alınır.
Esnek paylaşım modeli için:
Esnek paylaşım modelini seçerseniz Genel Gelir Paylaşımı aralığının ek alanlar gösterir. Bu alanları, toplama için bir temel belirtmek ve "gelir bantlarını", yani kullanabileceğiniz ve işlem tarafından oluşturulan gelir aralıklarını farklı gelir paylaşımı yüzdeleri uygulayabilirsiniz.
Genel Gelir Paylaşımı penceresine aşağıdaki bilgileri girin:
Alan Açıklama Toplama Temeli Gelirin toplandığı dönem. Toplam gelir Her bir işlemin gelir bandını (ve geçerli geliri) hesaplamak için kullanılır. paylaşım yüzdesi) için geçerli olacaktır. Ay sayısı seçin (1 ile 12 arasında).
Gelir Bantları Bir veya daha fazla işlem geliri aralığı (her aralık bir "gelir aralığıdır"). Her biri gelir bandına bir gelir paylaşımı yüzdesi atanabilir (bu yüzdeyi (Fiyatlandırma bölümünün Gelir Bantları alanına) girin.) İşlemler, toplam gelirini ve gelir aralığını hesaplarken kullanılacak dönüşümlerin belirtir. Her işleme uygulanan gelir paylaşımı yüzdesi gelir aralığı
İlk bandın üst sınırını belirtin. Örneğin, en fazla 1.000 (alt değer) limit 0'dan büyük bir değere ayarlanır). İkinci bir bant eklemek için + simgesini tıklayın. Örneğin, daha büyüktür. Daha fazla bant eklemek için + simgesini tıklayın. Üst taraftaki toplama işleminden sonraki tüm işlemleri belirtmek için boş son bant sınırı geliriniz bu seviyenin üzerine çıktı.
Fiyatlandırma Operatör (veya Kuruluş) Kuruluşunuzun adı. Bu alan, operatör (veya Kuruluş) alanındaki değere karşılık gelir.
Ülke Kuruluşunuzun faaliyet gösterdiği ülke. Bu alan, Kuruluş profilindeki ülke alanı değeri.
Para Birimi "Temel" kuruluşunuzun kullandığı muhasebe para birimi. Bu alan Bu hazır ayar, kuruluş profilindeki Para birimi alanı değeriyle belirlenir.
Fiyatlandırma Türü Gelir paylaşımının temeli. Brüt veya Net'i seçin. Brüt'ü seçerseniz Gelir paylaşımı, bir işlemin brüt fiyatının belirli bir yüzdesine dayanır. Şu durumda: gelir paylaşımı, bir şirketin net fiyatının belirli bir yüzdesine göre, belirtir. Not: İşlemin brüt veya net fiyatını işlem kaydetme politikasını oluştururken ayarlarsınız.
Gelir Bantları İçin % Payı Her bir ülkedeki işlemlere ait gelir paylaşımını hesaplamak için kullanılan yüzde gelir aralığı Her bant için bir yüzde belirtirsiniz. Ondalık sayı girin ( dört ondalık basamak). Örneğin, Gelir sütununda iki gelir bandı belirtirseniz Bant bölümü (>0-1000 ve 1000 ve üzeri), >0-1000 gelir bandı ve 1000 ve üstü gelir bandı için 90, 5. Ayrıca varsay para birimi ABD doları olmalıdır. Ardından, 1.000 dolara varan kazanç sağlayan işlemler için gelir paylaşımı, işlem fiyatının% 80, 5555'i kadar fazla gelir sağlayan işlemler için, gelir payının% 90,5 işlem fiyatıdır.
- Gelir paylaşımı ayrıntılarını kaydetmek ve Standart Ücret'e dönmek için Uygula ve Kapat'ı tıklayın Plan aralığı.
- API ürününe özel ücret planları için ek API ürünlerinin ücret planı ayrıntılarını gerektiği şekilde yapılandırın.
API'yi kullanarak gelir paylaşımı planı ayrıntılarını belirtme
Ücret planını oluştururken gelir paylaşımı planı ayrıntılarını belirtirsiniz. Ayrıntıları siz belirtin
ratePlanDetails
mülkünde,
/organizations/{org_name}/monetization-packages/{package_id}/rate-plans
. Neyi
ratePlanDetails
özelliğinde belirtirsiniz. Bu, seçtiğiniz paylaşım modeline bağlıdır:
veya esnek hale getirebilirsiniz.
Sabit paylaşım modeli için gelir paylaşımı planı ayrıntılarını belirtme
Sabit paylaşım modelini uygulamak için ücret planı ayrıntılarında aşağıdakileri belirtirsiniz:
- Ücret planının işlemlere dayalı olduğunu gösteren bir puan parametresi
(
VOLUME
).VOLUME
varsayılan değerdir. - Gelir paylaşımının birim başına sabit olduğunu gösteren bir sayaç türü (
UNIT
) (yani, esnek reklamlarda olduğu gibi, işlemlerin hacmine bağlı değildir.) paylaşım modeli) ekleyebilirsiniz. - Gelir türü (
GROSS
veyaNET
). Bu, Gelir paylaşımı, bir işlemin brüt veya net fiyatını temel alır. - Ödeme vadesi (örneğin, 30 gün).
- Kuruluşunuzun kimliği.
- "Temel" şirketinizin kullandığı muhasebe para birimini temel alır.
- Gelir paylaşımının nasıl hesaplandığına dair ayrıntıların yer aldığı ücret planı ücreti. Çünkü Paylaşım modeli sabit ücreti temel alıyorsa yalnızca bir ücret planı ücreti belirtirsiniz.
Ücret planı ayrıntı özelliklerinin tam listesi için Ücret planı ayrıntıları için yapılandırma mülkleri bölümüne bakın.
Ücret planı ücretinde şunları belirtirsiniz:
- Ücret planı ücretinin türü (
REVSHARE
). - Gelir paylaşımını hesaplamak için kullanılan yüzde. Örneğin, 80.5555 değerini belirtirseniz, gelir paylaşımı %80,5555'tir. Yani bir API sağlayıcı olarak, geliştiriciye her işlem için alınan fiyat (veya öğe sayısı bir işlemde aktarılan bayt miktarının toplamıyla, geliştiriciye ödemeniz gereken fiyatın% 80,5555 (belirtilen sayıda baytı iletirken).
- Ücret uygulamasının başlangıç birimi (
0
). Bu durumda, ücret uygulanır.
Ücret planı özelliklerinin tam listesi için Ücret planları için yapılandırma mülkleri bölümüne bakın.
Örneğin, aşağıda belirtilen sabit paylaşım modeliyle bir gelir paylaşımı planı oluşturulur. İlgili içeriği oluşturmak için kullanılan gelir paylaşımı yüzdesi %80,5555'tir. Gelir paylaşımı, belirtir. Sözleşme 15 Eylül 2013 tarihinden itibaren geçerli olup ödemenin 30 gün içinde ödenmesi gerekir. ( gelir paylaşımıyla ilgili ayrıntılar vurgulanmıştır.)
$ curl -H "Content-Type:application/json" -X POST -d \ '{ "name": "Fixed share plan", "developer":null, "developerCategory":null, "advance": false, "currency": { "id": "usd" }, "description": "Fixed share plan", "displayName": "Fixed share plan", "earlyTerminationFee": 10, "monetizationPackage": { "id": "location" }, "organization": { "id": "{org_name}" }, "paymentDueDays": "30", "prorate": false, "published": true, "ratePlanDetails": [ { "aggregateStandardCounters": true, "currency": { "id": "usd" }, "duration": 1, "durationType": "MONTH", "meteringType": "UNIT", "organization": { "id": "{org_name}" }, "paymentDueDays": "30", "ratePlanRates": [ { "revshare": 80.8555, "startUnit": 0, "type": "REVSHARE" } ], "ratingParameter": "VOLUME", "revenueType": "NET", "type": "REVSHARE" } ], "recurringStartUnit": 1, "recurringType": "CALENDAR", "setUpFee": 10, "startDate": "2013-09-15 00:00:00", "type": "STANDARD" }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \ -u email:password
Yanıt aşağıdaki gibi görünecektir (yanıtın yalnızca bir kısmı gösterilir):
{ "advance" : false, "currency" : { "id" : "usd", "name" : "USD", ... "organization" : { ... }, ... }, "description" : "Fixed share plan", "displayName" : "Fixed share plan", "earlyTerminationFee" : 10, "id" : "location_fixed_share_plan", "monetizationPackage" : { "description" : "Location", "displayName" : "Location", "id" : "location", "name" : "Location", "organization" : { ... }, "product" : [ { "customAtt1Name" : "user", "description" : "Location", "displayName" : "Location", "id" : "location", "name" : "location", "organization" : { ... }, "status" : "CREATED" } ], "status" : "CREATED" }, "name" : "Fixed share plan", "organization" : { ... }, "paymentDueDays" : "30", "prorate" : false, "published" : true, "ratePlanDetails" : [ { "aggregateFreemiumCounters" : true, "aggregateStandardCounters" : true, "currency" : { "id" : "usd", "name" : "USD", ... "organization" : { ... }, ... }, "duration" : 1, "durationType" : "MONTH", "id" : "c1720153-c60f-4f7f-b4e5-cdc7bc7bec5b", "meteringType" : "UNIT", "organization" : { ... }, "paymentDueDays" : "30", "ratePlanRates" : [ { "id" : "01c4d544-d907-423b-964e-4e2aed2816a3", "revshare" : 80.8555, "startUnit" : 0, "type" : "REVSHARE" } ], "ratingParameter" : "VOLUME", "revenueType" : "NET", "type" : "REVSHARE" } ], "recurringStartUnit" : 1, "recurringType" : "CALENDAR", "setUpFee" : 10, "startDate" : "2013-09-15 00:00:00", "type" : "STANDARD" }
Esnek paylaşım modeli için gelir paylaşımı planı ayrıntılarını belirtme
Esnek paylaşım modelinde, bir veya daha fazla ücret planı içeren ücret planı ayrıntılarını belirtirsiniz. ücret alabilir. Her ücret planı ücreti, işlem geliri aralığını (her bir aralık "gelir" kayış"). Her bir gelir aralığı için bir gelir paylaşımı yüzdesi atarsınız.
Ücret planı ücretlerine ek olarak ücret planı ayrıntılarında aşağıdakileri de belirtirsiniz:
- Ücret planının işlemlere dayalı olduğunu gösteren bir puan parametresi
(
VOLUME
).VOLUME
varsayılan değerdir. - Gelir paylaşımının aşağıdakileri temel almadığını gösteren bir sayaç türü (
VOLUME
) işlem hacmi (sabit paylaşımda olduğu gibi sabit değildir.) modeli). - Gelir türü (
GROSS
veyaNET
). Bu, Gelir paylaşımı, bir işlemin brüt veya net fiyatını temel alır. - Ödeme vadesi (örneğin, 30 gün).
- Kuruluşunuzun kimliği.
- "Temel" şirketinizin kullandığı muhasebe para birimini temel alır.
- Süre ve süre türü birlikte gelirin hangi zaman diliminde birleştirilir (buna "toplama temeli" de denir). İşlemler, toplama esasına göre (örneğin, 1 ay) kullanarak toplam geliri ve geçerli gelir aralığı Her işleme uygulanan gelir paylaşımı yüzdesi, işlemin gelirine bağlıdır var.
- Geçerli gelir aralığını belirlemek için kullanılan toplama sayaçları.
Ücret planı ayrıntı özelliklerinin tam listesi için Ücret planı ayrıntıları için yapılandırma mülkleri bölümüne bakın.
Her ücret planı ücreti için şunları belirtirsiniz:
- Gelir bandı (
REVSHARE
) için ücret planı ücret türü. - Gelir bandının gelir paylaşımını hesaplamak için kullanılan yüzde. Örneğin, 80.5555 değerini belirtirseniz gelir bandının gelir paylaşımı %80,5555, yani bir API olarak her işlem için alınan fiyatın% 80, 5555'ini geliştiriciye ödersiniz. gelir aralığı
- Gelir bandının başlangıç ve bitiş birimi. Başlangıç birimi,
sınırıdır ve bitiş birimi, gelir bandının üst sınırını belirtir. Örneğin,
Örneğin, başlangıç birimi 0 ve bitiş birimi olarak 1000 belirtirseniz gelir bandı
0'dan büyük ve belirtilen para biriminde 1000'e kadar olan işlem gelirini kapsar. Öğe
para birimi ABD doları, toplama esası 1 ay ve gelir yüzdesi
bant %80,5555'tir. Ayda 1.000 dolara kadar gelir oluşturan işlemler için
gelir paylaşımı, işlem fiyatının% 80,5555'i kadardır.
Nihai gelir bandı için bir bitiş birimi belirtmezseniz Bu bant, toplam gelir başlangıç birimini seçin. Örneğin, son bandın başlangıç birimi 1.000 ise (ABD doları olduğunu varsayın) ve bu bant için bir bitiş birimi belirtmezseniz gelir yüzdesinin, dönüşüm aralığı boyunca 1.000 ABD dolarının üzerindeki tüm işlemlere toplam süresidir.
Ücret planı özelliklerinin tam listesi için Ücret planları için yapılandırma mülkleri bölümüne bakın.
Örneğin aşağıdaki örnek, esnek paylaşım modeliyle bir gelir paylaşımı planı oluşturur. Google iki gelir bandını belirtir. İlk bant, 1.000'e kadar olan işlem gelirini kapsar. ABD doları cinsinden alınacaktır. İkinci bant, 1.000 ABD dolarının üzerindeki işlem gelirini kapsar. Elde edilen gelir için pay yüzdesi ilk gelir aralığı için% 80,5555, ikinci gelir bandında ise% 90,5'tir. Gelir paylaşımı, bir işlemin net fiyatını temel alır. Toplama esası 1 aydır. Sözleşme dönemi 15 Eylül 2013 tarihinden itibaren geçerlidir ve ödemenin 30 gün içinde yapılması gerekir. ( paylaşımla ilgili ayrıntılar vurgulanmıştır.)
$ curl -H "Content-Type:application/json" -X POST -d \ '{ "name": "Flexible share plan", "developer":null, "developerCategory":null, "advance": "true", "currency": { "id": "usd" }, "description": "Flexible share plan", "displayName": "Flexible share plan", "frequencyDuration": "30", "frequencyDurationType": "DAY", "earlyTerminationFee": "10", "monetizationPackage": { "id": "location" }, "organization": { "id": "{org_name}" }, "paymentDueDays": "30", "prorate": "false", "published": "true", "ratePlanDetails": [ { "currency": { "id": "usd" }, "duration": "1", "durationType": "MONTH", "meteringType": "VOLUME", "organization": { "id": "{org_name}" }, "paymentDueDays": "30", "ratePlanRates" : [ { "endUnit" : 1000, "revshare" : 80.5555, "startUnit" : 0, "type" : "REVSHARE" }, { "revshare" : 90.5, "startUnit" : 1000, "type" : "REVSHARE" } ], "ratingParameter" : "VOLUME", "revenueType" : "NET", "type" : "REVSHARE" } ], "recurringStartUnit": 1, "recurringType": "CALENDAR", "recurringFee": "10", "setUpFee": "10", "startDate": "2013-09-15 00:00:00", "type": "STANDARD" }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \ -u email:password
Yanıt aşağıdaki gibi görünecektir (yanıtın yalnızca bir kısmı gösterilir):
{ "advance" : true, "currency" : { "id" : "usd", "name" : "USD", "organization" : { ... }, ... }, "description" : "Flexible share plan", "displayName" : "Flexible share plan", "earlyTerminationFee" : 10, "frequencyDuration" : 30, "frequencyDurationType" : "DAY", "id" : "location_flexible_share_plan", "monetizationPackage" : { "description" : "Location", "displayName" : "Location", "id" : "location", "name" : "Location", "organization" : { ... }, "product" : [ { "customAtt1Name" : "user", "description" : "Location", "displayName" : "Location", "id" : "location", "name" : "location", "organization" : { ... }, "status" : "CREATED" } ], "status" : "CREATED" }, "name" : "Flexible share plan", "organization" : { ... }, "paymentDueDays" : "30", "prorate" : false, "published" : false, "ratePlanDetails" : [ { "aggregateFreemiumCounters" : true, "aggregateStandardCounters" : true, "currency" : { "id" : "usd", "name" : "USD", … "organization" : { ... }, ... }, "duration" : 1, "durationType" : "MONTH", "id" : "ba3353e3-14f4-4bc5-a9f1-c723fd34131c", "meteringType" : "VOLUME", "organization" : { ... }, "paymentDueDays" : "30", "ratePlanRates" : [ { "endUnit" : 1000, "id" : "5f13a51e-2250-4383-9aad-35e9a008ab40", "revshare" : 80.5555, "startUnit" : 0, "type" : "REVSHARE" }, { "id" : "d4196250-4ecc-480e-a7ed-dfab8e1c92ed", "revshare" : 90.5, "startUnit" : 1000, "type" : "REVSHARE" } ], "ratingParameter" : "VOLUME", "revenueType" : "NET", "type" : "REVSHARE" } ], "recurringFee" : 10, "recurringStartUnit" : 1, "recurringType" : "CALENDAR", "setUpFee" : 10, "startDate" : "2013-09-15 00:00:00", "type" : "STANDARD" }