- المورد: SubscriptionOffer
- الولاية
- SubscriptionOfferPhase
- RegionalSubscriptionOfferPhaseConfig
- RegionalSubscriptionOfferPhaseFreePriceOverride
- OtherRegionsSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhasePrices
- OtherRegionsSubscriptionOfferPhaseFreePriceOverride
- SubscriptionOfferTargeting
- AcquisitionTargetingRule
- TargetingRuleScope
- TargetingRuleScopeThisSubscription
- TargetingRuleScopeAnySubscriptionInApp
- UpgradeTargetingRule
- RegionalSubscriptionOfferConfig
- OtherRegionsSubscriptionOfferConfig
- الطُرق
المرجع: SubscriptionOffer
عرض مؤقت واحد
تمثيل JSON |
---|
{ "packageName": string, "productId": string, "basePlanId": string, "offerId": string, "state": enum ( |
الحقول | |
---|---|
packageName |
مطلوبة. غير قابل للتغيير. اسم حزمة التطبيق الذي ينتمي إليه الاشتراك الرئيسي. |
productId |
مطلوبة. غير قابل للتغيير. معرّف الاشتراك الرئيسي الذي ينتمي إليه هذا العرض. |
basePlanId |
مطلوبة. غير قابل للتغيير. رقم تعريف الخطة الأساسية التي يمثّل هذا العرض الترويجي إضافة إليها. |
offerId |
مطلوبة. غير قابل للتغيير. المعرّف الفريد لعرض الاشتراك هذا. يجب أن تكون القيمة فريدة ضمن الخطة الأساسية. |
state |
النتائج فقط. الوضع الحالي لهذا العرض يمكن تغييرهما باستخدام الإجراءين "تفعيل" و"إيقاف". ملاحظة: تحل حالة الخطة الأساسية محل هذه الحالة، لذلك قد لا يتوفّر عرض نشط إذا كانت الخطة الأساسية غير نشطة. |
phases[] |
مطلوبة. مراحل عرض الاشتراك هذا. يجب أن يحتوي على إدخال واحد على الأقل، وخمسة كحد أقصى. سيتلقّى المستخدمون دائمًا جميع هذه المراحل بالترتيب المحدد. لا يمكن إضافة المراحل أو إزالتها أو إعادة ترتيبها بعد إنشائها لأول مرة. |
targeting |
المتطلبات التي يجب أن يستوفيها المستخدمون ليكونوا مؤهّلين لهذا العرض تمثّل هذه السمة المتطلبات التي سيقيّمها Play لتحديد ما إذا كان يجب إرجاع أحد العروض. ويمكن للمطوّرين فلترة هذه العروض بأنفسهم. |
regionalConfigs[] |
مطلوبة. الإعدادات الخاصة بمنطقة معيّنة لهذا العرض الترويجي يجب أن تحتوي على إدخال واحد على الأقل. |
otherRegionsConfig |
وقد يتم إطلاق الإعدادات لأي مواقع جغرافية جديدة في Play في المستقبل. |
offerTags[] |
قائمة تضم ما يصل إلى 20 علامة مخصّصة تم تحديدها لهذا العرض، وتم إرجاعها إلى التطبيق من خلال مكتبة الفوترة. |
الحالة
الحالة الحالية لعرض الاشتراك.
عمليات التعداد | |
---|---|
STATE_UNSPECIFIED |
القيمة التلقائية، يجب عدم استخدامها مطلقًا. |
DRAFT |
عرض الاشتراك ليس متاحًا للمستخدمين ولم يكن متاحًا أبدًا. |
ACTIVE |
يتوفّر عرض الاشتراك للمستخدمين الجُدد والحاليين. |
INACTIVE |
لا يتوفّر عرض الاشتراك للمستخدمين الجُدد. ويحتفظ المستخدمون الحاليون بإمكانية الوصول. |
SubscriptionOfferPhase
مرحلة واحدة من عرض الاشتراك.
تمثيل JSON |
---|
{ "recurrenceCount": integer, "duration": string, "regionalConfigs": [ { object ( |
الحقول | |
---|---|
recurrenceCount |
مطلوبة. عدد مرات تكرار هذه المرحلة. إذا لم تكن مرحلة العرض هذه مجانية، سيفرض كل تكرار على المستخدم سعر مرحلة العرض هذه. |
duration |
مطلوبة. مدة التكرار الواحد لهذه المرحلة. تم تحديد التنسيق بتنسيق ISO 8601. |
regionalConfigs[] |
مطلوبة. الإعدادات الخاصة بمرحلة العرض هذا في المنطقة يجب أن تحتوي هذه القائمة على إدخال واحد فقط لكل منطقة تم ضبط عرض الاشتراك فيها على الإعدادات الإقليمية. |
otherRegionsConfig |
معلومات الأسعار لأي مواقع جغرافية جديدة قد يتم إطلاق Play فيها |
RegionalSubscriptionOfferPhaseConfig
عملية الإعداد لمرحلة واحدة من عرض الاشتراك في منطقة واحدة.
تمثيل JSON |
---|
{ "regionCode": string, // Union field |
الحقول | |
---|---|
regionCode |
مطلوبة. غير قابل للتغيير. المنطقة التي تنطبق عليها هذه الإعدادات. |
حقل الاتحاد price_override تمثّل هذه السمة قيمة إلغاء السعر في هذه المرحلة. مطلوبة. يمكن أن يكون الحقل "price_override " واحدًا فقط مما يلي: |
|
price |
السعر المطلق الذي يدفعه المستخدم مقابل مرحلة العرض هذه. يجب ألا يكون السعر أقل من الحد الأدنى للسعر المسموح به لهذه المنطقة. |
relativeDiscount |
الجزء من سعر الخطة الأساسية الموزّع بالتناسب على مدة المرحلة التي يدفعها المستخدم مقابل مرحلة العرض هذه. على سبيل المثال، إذا كان سعر الخطة الأساسية لهذه المنطقة هو 12 دولار أمريكي لمدة عام واحد، سيكون خصم% 50 لفترة 3 أشهر بسعر 1.50 دولار أمريكي. يجب تحديد الخصم على أنّه كسر أكبر من 0 وأصغر من 1 تمامًا. سيتم تقريب السعر الناتج إلى أقرب وحدة قابلة للفوترة (على سبيل المثال، بالسنت للدولار الأمريكي). يُعتبر الخصم النسبي غير صالح إذا أصبح السعر المخفَّض أقلّ من السعر الأدنى المسموح به في هذه المنطقة. |
absoluteDiscount |
المبلغ المطلق من المال المطروح من سعر الخطة الأساسية بالتناسب على فترة المرحلة التي يدفعها المستخدم لمرحلة العرض هذه. على سبيل المثال، إذا كان سعر الخطة الأساسية لهذه المنطقة هو 12 دولار أمريكي لمدة عام واحد، سيتطابق الخصم المطلق بقيمة دولار أمريكي واحد (أو ما يعادله بالعملة المحلية) عن فترة 3 أشهر بسعر 2 دولار أمريكي. قد لا يكون السعر الناتج أقلّ من السعر الأدنى المسموح به لهذه المنطقة. |
free |
يجب تحديد أنّ هذا العرض متاح مجانًا. |
RegionalSubscriptionOfferPhaseFreePriceOverride
لا يشتمل هذا النوع على أي حقول.
يمثّل هذا الخيار إعدادات إلغاء السعر مجانًا لمرحلة واحدة من عرض الاشتراك.
OtherRegionsSubscriptionOfferPhaseConfig
قد يتم إطلاق Play في أي مواقع جغرافية جديدة لمرحلة عرض واحدة.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد price_override تمثّل هذه السمة قيمة إلغاء السعر في هذه المرحلة. مطلوبة. يمكن أن يكون الحقل "price_override " واحدًا فقط مما يلي: |
|
otherRegionsPrices |
السعر المطلق الذي يدفعه المستخدم مقابل مرحلة العرض هذه. يجب ألا يكون السعر أقل من الحد الأدنى للسعر المسموح به لأي مواقع جغرافية جديدة قد يتم إطلاق Play فيها. |
relativeDiscount |
الجزء من سعر الخطة الأساسية الموزّع بالتناسب على مدة المرحلة التي يدفعها المستخدم مقابل مرحلة العرض هذه. على سبيل المثال، إذا كان سعر الخطة الأساسية لهذه المنطقة هو 12 دولار أمريكي لمدة عام واحد، سيكون خصم% 50 لفترة 3 أشهر بسعر 1.50 دولار أمريكي. يجب تحديد الخصم على أنّه كسر أكبر من 0 وأصغر من 1 تمامًا. سيتم تقريب السعر الناتج إلى أقرب وحدة قابلة للفوترة (على سبيل المثال، بالسنت للدولار الأمريكي). يُعتبَر الخصم النسبي غير صالح إذا أصبح السعر المخفَّض أقلّ من الحد الأدنى للسعر المسموح به في أي مواقع جغرافية جديدة قد يتم إطلاق Play فيها. |
absoluteDiscounts |
المبلغ المطلق من المال المطروح من سعر الخطة الأساسية بالتناسب على فترة المرحلة التي يدفعها المستخدم لمرحلة العرض هذه. على سبيل المثال، إذا كان سعر الخطة الأساسية لهذه المنطقة هو 12 دولار أمريكي لمدة عام واحد، سيتطابق الخصم المطلق بقيمة دولار أمريكي واحد (أو ما يعادله بالعملة المحلية) عن فترة 3 أشهر بسعر 2 دولار أمريكي. قد لا يكون السعر الناتج أقلّ من الحدّ الأدنى للسعر المسموح به في أي مواقع جغرافية جديدة قد يتم إطلاق Play فيها. |
free |
يجب تحديد أنّ هذا العرض متاح مجانًا. |
OtherRegionsSubscriptionOfferPhasePrices
معلومات الأسعار لأي مواقع جغرافية جديدة قد يتم إطلاق Play فيها
تمثيل JSON |
---|
{ "usdPrice": { object ( |
الحقول | |
---|---|
usdPrice |
مطلوبة. السعر بالدولار الأمريكي للاستخدام في أي مواقع جغرافية جديدة قد يتم إطلاق Play فيها |
eurPrice |
مطلوبة. السعر باليورو الذي يمكن استخدامه في أي مواقع جغرافية جديدة قد يتم إطلاق Play فيها |
OtherRegionsSubscriptionOfferPhaseFreePriceOverride
لا يشتمل هذا النوع على أي حقول.
يُمثِّل ذلك الإعدادات المجانية لإلغاء السعر لأي مواقع جغرافية جديدة قد يتم إطلاقها في Play لمرحلة عرض واحدة.
SubscriptionOfferTargeting
تحدد القاعدة التي يجب أن يستوفيها المستخدم لتلقي هذا العرض.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد rule يجب ترك هذا الحقل فارغًا للتعرف على أهلية العروض التي يحدِّدها المطوّر. يمكن أن يكون الحقل "rule " واحدًا فقط مما يلي: |
|
acquisitionRule |
تقديم قاعدة استهداف لاكتساب مستخدمين جدد. |
upgradeRule |
عرض قاعدة استهداف لترقية الخطط الحالية للمستخدمين |
AcquisitionTargetingRule
يمثل قاعدة استهداف بالشكل: لم يحصل المستخدم على {scope} من قبل.
تمثيل JSON |
---|
{
"scope": {
object ( |
الحقول | |
---|---|
scope |
مطلوبة. نطاق الاشتراكات التي تراعيها هذه القاعدة. السماح "بهذا الاشتراك" و "أي اشتراك في التطبيق" فقط. |
TargetingRuleScope
يُحدِّد نطاق الاشتراكات التي يمكن أن تتطابق قاعدة استهداف مع العروض الترويجية للمستخدمين استنادًا إلى الاستحقاق السابق أو الحالي.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد يمكن أن يكون الحقل " |
|
thisSubscription |
نطاق قاعدة الاستهداف الحالية هو الاشتراك الذي يتم تحديد هذا العرض فيه. |
anySubscriptionInApp |
نطاق قاعدة الاستهداف الحالية هو أي اشتراك في التطبيق الرئيسي. |
specificSubscriptionInApp |
نطاق قاعدة الاستهداف الحالية هو الاشتراك الذي يحمل رقم تعريف الاشتراك المحدّد. يجب أن يكون اشتراكًا داخل التطبيق الرئيسي نفسه. |
TargetingRuleScopeThisSubscription
لا يشتمل هذا النوع على أي حقول.
يُمثِّل نطاق قاعدة الاستهداف المقابل للاشتراكات التي تم تحديد هذا العرض فيها.
TargetingRuleScopeAnySubscriptionInApp
لا يشتمل هذا النوع على أي حقول.
يُمثِّل نطاق قاعدة الاستهداف المقابل لأي اشتراك في التطبيق الرئيسي.
UpgradeTargetingRule
تُمثِّل هذه السمة قاعدة استهداف على النحو التالي: يمتلك المستخدم حاليًا {scope} [مع المدة الزمنية للفوترة {billing_period}].
تمثيل JSON |
---|
{
"oncePerUser": boolean,
"scope": {
object ( |
الحقول | |
---|---|
oncePerUser |
يمكنك حصر هذا العرض مرة واحدة فقط لكل مستخدم. في حال ضبطها على "صحيح"، لا يمكن للمستخدم أن يكون مؤهلاً للاستفادة من هذا العرض مجددًا إذا سبق له الاشتراك فيه. |
scope |
مطلوبة. نطاق الاشتراكات التي تراعيها هذه القاعدة. السماح "بهذا الاشتراك" و "الاشتراك المحدد في التطبيق" فقط. |
billingPeriodDuration |
هي مدة المدد الزمنية المحدّدة للفوترة، المحددة بتنسيق ISO 8601، والتي يجب أن يكون المستخدم مشتركًا فيها حاليًا ليكون مؤهلاً لهذه القاعدة. وفي حال عدم تحديد أي مدة، ستتم مطابقة المستخدمين المشتركين في أي مدة زمنية للفوترة. |
RegionalSubscriptionOfferConfig
إعدادات عرض الاشتراك في منطقة واحدة
تمثيل JSON |
---|
{ "regionCode": string, "newSubscriberAvailability": boolean } |
الحقول | |
---|---|
regionCode |
مطلوبة. غير قابل للتغيير. رمز المنطقة الذي ينطبق عليه هذا الإعداد، وفقًا لمعيار ISO 3166-2، مثل "US". |
newSubscriberAvailability |
ما إذا كان عرض الاشتراك في المنطقة المحددة متاحًا للمشتركين الجدد. ولن يتم إلغاء اشتراك المشتركين الحاليين إذا تم ضبط هذه القيمة على "خطأ". إذا لم يتم تحديد القيمة، سيتم ضبط القيمة تلقائيًا على "خطأ". |
OtherRegionsSubscriptionOfferConfig
قد يتم إطلاق Play في أي مواقع جغرافية جديدة ضمن عرض الاشتراك المحدّد.
تمثيل JSON |
---|
{ "otherRegionsNewSubscriberAvailability": boolean } |
الحقول | |
---|---|
otherRegionsNewSubscriberAvailability |
ما إذا كان سيتم إطلاق عرض الاشتراك في أي مواقع جغرافية جديدة على Play في المستقبل إذا لم يتم تحديد القيمة، سيتم ضبط القيمة تلقائيًا على "خطأ". |
الطُرق |
|
---|---|
|
تفعِّل هذا الخيار عرض اشتراك. |
|
تتم قراءة عرض اشتراك واحد أو أكثر. |
|
لتعديل مجموعة من عروض الاشتراكات |
|
لتعديل مجموعة من حالات عروض الاشتراك |
|
ينشئ عرض اشتراك جديد. |
|
لإيقاف عرض الاشتراك. |
|
حذف عرض اشتراك |
|
قراءة عرض واحد |
|
يسرد كل العروض ضمن اشتراك معيّن. |
|
لتعديل عرض اشتراك حالي |