- Kaynak: Abonelik Teklifi
- Durum
- Abonelik Teklifi Aşaması
- RegionalSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPashePrices
- Abonelik Teklifi Hedefleme
- Edinme Hedefleme Kuralı
- HedeflemeKural Kapsamı
- Upgrade TargetingRule
- RegionalSubscriptionOfferConfig
- OtherRegionsSubscriptionOfferConfig
- Yöntemler
Kaynak: Abonelik Teklifi
Tek bir geçici teklif
JSON gösterimi |
---|
{ "packageName": string, "productId": string, "basePlanId": string, "offerId": string, "state": enum ( |
Alanlar | |
---|---|
packageName |
Zorunlu. Sabit. Üst aboneliğin ait olduğu uygulamanın paket adı. |
productId |
Zorunlu. Sabit. Bu teklifin ait olduğu üst aboneliğin kimliği. |
basePlanId |
Zorunlu. Sabit. Bu teklifin bir uzantı olduğu temel planın kimliği. |
offerId |
Zorunlu. Sabit. Bu abonelik teklifinin benzersiz kimliği. Temel plan içinde benzersiz olmalıdır. |
state |
Yalnızca çıkış. Bu teklifin mevcut durumu. Etkinleştirme ve Devre Dışı Bırakma işlemleri kullanılarak değiştirilebilir. Not: Temel plan durumu bu eyaletin yerini aldığından, temel plan etkin değilse etkin bir teklif sunulmayabilir. |
phases[] |
Zorunlu. Bu abonelik teklifinin aşamaları. En az bir giriş içermelidir ve en fazla beş giriş içerebilir. Kullanıcılar bu aşamaların tümünü her zaman belirtilen sırada alır. Aşamalar ilk oluşturulduktan sonra eklenemez, kaldırılamaz veya yeniden sıralanamaz. |
targeting |
Bu tekliften yararlanabilmek için kullanıcıların karşılaması gereken koşullar. Bir teklifin döndürülüp döndürülmeyeceğine karar vermek için Play'in değerlendireceği koşulları temsil eder. Geliştiriciler bu teklifleri kendileri için daha ayrıntılı şekilde filtreleyebilir. |
regionalConfigs[] |
Zorunlu. Bu teklifin bölgeye özgü yapılandırması. En az bir giriş içermelidir. |
otherRegionsConfig |
Play'in gelecekte kullanıma sunulacağı tüm yeni konumların yapılandırması. |
offerTags[] |
Bu teklif için en fazla 20 özel etiket içeren ve faturalandırma kitaplığı üzerinden uygulamaya döndürülen apks.list. |
Eyalet
Abonelik teklifinin mevcut durumu.
Sıralamalar | |
---|---|
STATE_UNSPECIFIED |
Varsayılan değer hiçbir zaman kullanılmamalıdır. |
DRAFT |
Abonelik teklifi, kullanıcılar tarafından kullanılamamaktadır ve hiçbir zaman sunulmamıştır. |
ACTIVE |
Abonelik teklifi yeni ve mevcut kullanıcılar tarafından kullanılabilir. |
INACTIVE |
Abonelik teklifi yeni kullanıcılara sunulmaz. Mevcut kullanıcılar yine erişime sahip olur. |
Abonelik Teklifi Aşamaları
Abonelik teklifinin tek bir aşaması.
JSON gösterimi |
---|
{ "recurrenceCount": integer, "duration": string, "regionalConfigs": [ { object ( |
Alanlar | |
---|---|
recurrenceCount |
Zorunlu. Bu aşamanın tekrar sayısı. Bu teklif aşaması ücretsiz değilse her yinelenme için kullanıcıdan bu fırsat aşamasının ücreti alınır. |
duration |
Zorunlu. Bu aşamanın tek bir tekrar süresi. ISO 8601 biçiminde belirtilir. |
regionalConfigs[] |
Zorunlu. Bu teklif aşamasının bölgeye özgü yapılandırması. Bu listede, abonelik teklifinin bölgesel konfigürasyona sahip olduğu her bölge için tam olarak bir giriş olmalıdır. |
otherRegionsConfig |
Play'in kullanıma sunulabileceği tüm yeni konumlar için fiyatlandırma bilgileri. |
RegionalSubscriptionOfferPhaseConfig
Abonelik teklifinin tek bir aşamadaki tek bir bölgesinde yapılandırma.
JSON gösterimi |
---|
{ "regionCode": string, // Union field |
Alanlar | |
---|---|
regionCode |
Zorunlu. Sabit. Bu yapılandırmanın geçerli olduğu bölge. |
Birlik alanı price_override . Bu aşamanın fiyatı geçersiz kılması. Zorunlu. price_override aşağıdakilerden yalnızca biri olabilir: |
|
price |
Bu teklif aşaması için kullanıcının ödediği mutlak fiyat. Fiyat, bu bölge için izin verilen minimum fiyattan daha düşük olmamalıdır. |
relativeDiscount |
Kullanıcının bu teklif aşaması için ödediği aşama süresi boyunca eşit olarak bölünmüş temel plan fiyatının oranı. Örneğin, bu bölgenin temel plan fiyatı 1 yıllık bir süre için 12 ABD dolarıysa 3 aylık bir aşama için% 50 indirim, 1,50 ABD doları olan bir fiyata karşılık gelir. İndirimin 0'dan büyük ve 1'den küçük olan bir kesir olarak belirtilmesi gerekir. Gösterilen fiyat, en yakın faturalandırılabilir birime yuvarlanır (ör. ABD doları için sent). İndirimli fiyatın bu bölgede izin verilen minimum fiyattan daha az olması durumunda, göreli indirim geçersiz olarak kabul edilir. |
absoluteDiscount |
Kullanıcının bu teklif aşaması için ödediği dönem boyunca temel plan fiyatından düşülen mutlak para tutarı. Örneğin, bu bölgenin temel plan fiyatı 1 yıllık bir süre için 12 ABD dolarıysa 3 aylık bir aşama için 1 ABD doları olan toplam indirim tutarı 2 ABD dolarına karşılık gelir. Ortaya çıkan fiyat, bu bölge için izin verilen minimum fiyattan daha düşük olmayabilir. |
free |
Bu teklifin ücretsiz olarak edinileceğini belirtmek için belirtin. |
OtherRegionsAbonelik TeklifiPhaseConfig
Tek bir teklif aşamasında Play'in başlatılacağı yeni konumların yapılandırması.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birlik alanı price_override . Bu aşamanın fiyatı geçersiz kılması. Zorunlu. price_override aşağıdakilerden yalnızca biri olabilir: |
|
otherRegionsPrices |
Bu teklif aşaması için kullanıcının ödediği mutlak fiyat. Fiyat, Play'in kullanıma sunulabileceği tüm yeni konumlar için izin verilen minimum fiyattan düşük olmamalıdır. |
relativeDiscount |
Kullanıcının bu teklif aşaması için ödediği aşama süresi boyunca eşit olarak bölünmüş temel plan fiyatının oranı. Örneğin, bu bölgenin temel plan fiyatı 1 yıllık bir süre için 12 ABD dolarıysa 3 aylık bir aşama için% 50 indirim, 1,50 ABD doları olan bir fiyata karşılık gelir. İndirimin 0'dan büyük ve 1'den küçük olan bir kesir olarak belirtilmesi gerekir. Gösterilen fiyat, en yakın faturalandırılabilir birime yuvarlanır (ör. ABD doları için sent). İndirimli fiyatın, Play'in başlatılacağı yeni konumların tamamında izin verilen minimum fiyattan daha düşük olması durumunda, göreli indirim geçersiz olarak kabul edilir. |
absoluteDiscounts |
Kullanıcının bu teklif aşaması için ödediği dönem boyunca temel plan fiyatından düşülen mutlak para tutarı. Örneğin, bu bölgenin temel plan fiyatı 1 yıllık bir süre için 12 ABD dolarıysa 3 aylık bir aşama için 1 ABD doları olan toplam indirim tutarı 2 ABD dolarına karşılık gelir. Gösterilen fiyat, Play'in kullanıma sunulabileceği yeni konumlar için izin verilen minimum fiyattan düşük olmayabilir. |
free |
Bu teklifin ücretsiz olarak edinileceğini belirtmek için belirtin. |
OtherRegionsAbonelik Teklifi
Play'in kullanıma sunulabileceği tüm yeni konumlar için fiyatlandırma bilgileri.
JSON gösterimi |
---|
{ "usdPrice": { object ( |
Alanlar | |
---|---|
usdPrice |
Zorunlu. Play'in kullanıma sunulacağı tüm yeni yerlerde kullanılmak üzere ABD doları cinsinden fiyat. |
eurPrice |
Zorunlu. Play'in kullanıma sunulacağı tüm yeni yerlerde kullanılmak üzere Euro cinsinden fiyat. |
Abonelik Teklifi Hedefleme
Kullanıcının bu teklifi almak için karşılaması gereken kuralı tanımlar.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birlik alanı
|
|
acquisitionRule |
Yeni kullanıcı edinme için teklif hedefleme kuralı. |
upgradeRule |
Kullanıcıların mevcut planlarını yükseltmesi için teklif hedefleme kuralı. |
Edinme Hedefleme Kuralı
Şu biçimde bir hedefleme kuralını temsil eder: Kullanıcı daha önce hiç {scope} kullanmadı.
JSON gösterimi |
---|
{
"scope": {
object ( |
Alanlar | |
---|---|
scope |
Zorunlu. Bu kuralın dikkate aldığı aboneliklerin kapsamı. Yalnızca bu aboneliğe ve uygulamada tüm aboneliklere izin verir. |
TargetingRuleScope
Bir hedefleme kuralının, teklifleri geçmişteki veya mevcut yararlanma haklarına göre kullanıcılara hedeflemek için eşleştirebileceği aboneliklerin kapsamını tanımlar.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birlik alanı
|
|
thisSubscription |
Mevcut hedefleme kuralının kapsamı, bu teklifin tanımlandığı aboneliktir. |
anySubscriptionInApp |
Mevcut hedefleme kuralının kapsamı, üst uygulamadaki herhangi bir aboneliktir. |
specificSubscriptionInApp |
Mevcut hedefleme kuralının kapsamı, belirtilen abonelik kimliğine sahip aboneliktir. Aynı üst uygulama içinde bir abonelik olmalıdır. |
Yükseltme Hedefleme Kuralı
Formun hedefleme kuralını temsil eder: Kullanıcının şu anda {scope} [faturalandırma dönemi {billing_period}] vardır.
JSON gösterimi |
---|
{
"oncePerUser": boolean,
"scope": {
object ( |
Alanlar | |
---|---|
oncePerUser |
Bu teklifi kullanıcı başına yalnızca bir kez kullanın. Doğru değerine ayarlanırsa kullanıcı bu teklife daha sonra abone olursa bu tekliften hiçbir zaman yararlanamaz. |
scope |
Zorunlu. Bu kuralın dikkate aldığı aboneliklerin kapsamı. Yalnızca bu uygulamada ve uygulamada belirli bir aboneliğe izin verir. |
billingPeriodDuration |
ISO 8601 biçiminde belirtilen, kullanıcının bu kurala uygun olması için abone olması gereken belirli bir fatura dönemi süresi. Belirtilmezse herhangi bir fatura dönemine abone olan kullanıcılar eşleştirilir. |
RegionalSubscriptionOfferConfig
Abonelik fırsatının tek bir bölgede yapılandırması.
JSON gösterimi |
---|
{ "regionCode": string, "newSubscriberAvailability": boolean } |
Alanlar | |
---|---|
regionCode |
Zorunlu. Sabit. ISO 3166-2'de tanımlandığı gibi bu yapılandırmanın geçerli olduğu bölge kodu (ör. "US&); |
newSubscriberAvailability |
Belirtilen bölgedeki abonelik teklifinin yeni aboneler için mevcut olup olmadığı. Bu değer false olarak ayarlanırsa mevcut abonelerin aboneliği iptal edilmez. Belirtilmezse varsayılan olarak false (yanlış) değeri kullanılır. |
DiğerRegionsSubscriptionOfferConfig
Play'in, bir abonelik teklifinde belirtilen yeni konumların açılabileceği yapılandırma.
JSON gösterimi |
---|
{ "otherRegionsNewSubscriberAvailability": boolean } |
Alanlar | |
---|---|
otherRegionsNewSubscriberAvailability |
Play teklifinin gelecekte kullanıma sunulabileceği yeni konumlarda abonelik teklifinin sunulup sunulmayacağı. Belirtilmezse varsayılan olarak false (yanlış) değeri kullanılır. |
Yöntemler |
|
---|---|
|
Abonelik teklifini etkinleştirir. |
|
Yeni abonelik teklifi oluşturur. |
|
Abonelik teklifini devre dışı bırakır. |
|
Abonelik teklifini siler. |
|
Tek bir teklifi okur |
|
Belirli bir abonelik kapsamındaki tüm teklifleri listeler. |
|
Mevcut bir abonelik teklifini günceller. |