製品

product は、顧客への charge の作成、または顧客への service の提供に使用する基本オブジェクトです。製品は one-time fees、resource grantors、recurring fees、または service products にできます。

このドキュメントのトピック:

Monetization でこのセクションにアクセスするには、 Menu から Catalog を選択し、Products をクリックします。

Products

このセクションにアクセスするには、Products をクリックします。すべての products のページ分割されたリストが表形式で表示されます。

product は regular product または service product のいずれかにできます。regular product は顧客が支払う月額料金または one-time fee にでき、service product は顧客が data service や voice service などの services を使用できるようにします。


このセクションでは、次の 5 つのアクション/サブページを実行または表示できます。

product の作成

products で product を作成するには、 Create new をクリックします。これは次の 4 つのセクションで構成されます。

product info セクション

info セクションでは、product の名前、コード、説明が必須です。

invoice に product を含めるには、Included on invoice トグルスイッチを使用して有効化/無効化します。この機能を有効にすると、Monetization は 1 つの invoice 用に生成される JSON object にこのデータを取り込みます。

configuration セクション

configuration セクションには多数の入力フィールドがあります。ただし、product typecyclequantityprice typebill itemresourcesversions、price のみが必須で、その他は任意です。

Product type

product type の選択は必須で、次の 2 つのオプションがあります。

  1. Subscription
  2. One-time
Subscription
subscription product は、product が interval に基づいて recurring であることを意味します。この interval は event type と呼ばれ、Monetization で設定できます。event types の設定の詳細については、Event types を参照してください。
One-time
one-time product は、product が recurring ではなく、renewals なしで一度だけ購入されることを意味します。そのため、one-time product には event type が含まれない場合があります。
Event type

event type は Monetization で設定された cycle です。たとえば weekly、monthly、yearly cycles です。詳細については、Event types を参照してください。

monthly subscription の場合、顧客の billing cycle が切り替わるたび(つまり Monetization が billing を発行するたび)に、顧客が monthly interval(event type)も持っていれば、Monetization は購入済み products のすべてを確認し、どれを更新すべきかを判断します。

weekly subscription の場合、顧客が monthly interval(event type)を持っているとします。顧客の billing cycle が切り替わるたび(つまり Monetization が billing を発行するたび)に、Monetization はその product を 4 回 charge するよう判断します。そのため、顧客 cycle にわたって product を更新します(月次顧客が weekly product を持つ場合)。

Duration

product の duration は任意であり、terms を優先するため deprecated です。Monetization は以前、duration フィールドを使用して subscription product が何 cycles 有効であるべきかを指定していました。たとえば 6 か月です。しかし現在、Monetization は product がどのくらい有効であるべきか、いつ終了すべきかを把握するために terms を使用します。

詳細については、Terms を参照してください。

Cycle

product cycle は必須で、Forward または Arrear として設定できます。Forward cycle では、顧客は product の料金を前払いします。これは、顧客の最初の invoice で Monetization が 2 回 charge することを意味します。1 つ目は直前に終了した product service の利用分、2 つ目は後続の利用分です。

product が Arrear cycle を使用するよう設定すると、顧客は product の料金を前払いしません。代わりに product が rated され、顧客は billing cycle の終了時に charge されます。

Priority

任意の priority を設定すると、bundle 内である product を別の product より重要にできます。これは、account balance が限られている prepaid payment type を扱う場合により重要です。

顧客のために複数の products を含む bundle を購入する場合、どの product を先に購入し、どの product を最後に購入するかを決定できます。

さらに、複数の service products を扱う場合、priority の設定は重要です。たとえば、SMS service を提供する 2 つの products があるとします。1 つ目の product は通常の messaging 用で、regular messages 用の rate plan を持っています。2 つ目の product は、特定の顧客向けに特別料金で 1 つ目の上に購入されます。

2 つ目の product に 1 つ目より高い priority が与えられているとします。これは、Monetization がその顧客の usage event を受信したとき、SMS service を提供する 2 つの products を見つけることを意味します。Monetization は、適用する価格を判断するために 2 つの products の rate plan のみを必要とします。ただし、最も高い priority を持つ product(2 つ目の product)が使用されます。

したがって、product は既存の product の上に購入でき、前の product の価格を上書きできます。

Quantity

必須の quantity は、顧客が初めに product を購入する回数を示します。product purchase 時に提供される default quantity を表し、通常は 1 です。ただし、product の実際の購入時には quantity を上書きできます。

Price type

必須の price type は Debit または Credit にでき、product に対して resources がどのように impact されるかを示します。debit price type では resource に正の impact を与え、credit price type では resource に負の impact を与えます。

Bill item

必須の bill item は、charge を bill/invoice 上でどのように表示するかを扱います。Bill items は MonetizationBusiness configuration Finance Bill Items で設定できます。

詳細については、Bill Items を参照してください。

Quantity override resource

quantity override resource は任意です。ただし、設定した場合、product が購入されるか新しい billing cycle 中に更新されるとき、その product の quantity を設定済み resource の現在の balance で上書きするオプションがあることを意味します。

たとえば、product(通常は Arrear cycle)が quantity override resource を設定しているとします。この場合、Monetization は顧客の設定済み resource の balance を使用して product の quantity を決定します。

これは、1 cycle で消費された総 kWh に依存する Network Access Tariff など、総消費量に関連する products がある utility industries で特に役立ちます。kWh counter resource(helper resources)を使用でき、billing cycle 全体を通じて更新されます。そして cycle の終了時、その counter resource の値が Network Access Tariff の quantity になります。

Charge tag

任意の charge tag は、Monetization が discounting で product をどのように対象にできるかを示します。product に特定の charge tag が付与されると、discounts を作成するときにその charge tag を参照して対象にできます。

charge tag は MonetizationBusiness configuration Charging Tags で設定できます。

詳細については、Tags を参照してください。

Charge interval

任意の charge interval は、service product を作成するときに追加する必要があります。これは、特定の charge interval に記載された設定に従って、usage events から得られた ratable quantity を丸めることを扱います。

Charge intervals は MonetizationBusiness configuration Service design Charge Intervals で設定できます。

詳細については、Charge intervals を参照してください。

Tax supplier

tax supplier は任意ですが、Monetization が提供する third-party taxation gateway と連携する場合にははるかに重要です。

Tax suppliers は MonetizationBusiness configuration Finance Tax suppliers で設定できます。

General ledger

general ledger は任意ですが、設定すると、financial purposes のために product がどのように振る舞い、動作すべきかを Monetization に伝えます。general ledger では accounts が mapped され、product が購入されるたびにどの account に credit し、どの account に debit するかを指定します。

General ledgers は MonetizationBusiness configuration Finance General ledgers で設定できます。

Rollover

Rollover は任意ですが、設定すると、billing cycles 間で product から特定の resources を transfer できます。

たとえば、購入時に顧客へ 1GB の data を提供する product があるとします。しかし billing cycle が終了する前に、顧客にはまだ 200MB の未使用 data があります。この場合、rollover により、Cycle rollover amount に記載されたとおり、未使用 resource を次の billing cycle に移行できます。

Rollovers は MonetizationCatalog Products Rollovers で設定できます。

詳細については、Rollovers を参照してください。

Service

service は任意ですが、service product を作成する場合は必須です。

Services は MonetizationBusiness configuration Service design Service Types で設定できます。

詳細については、Service types を参照してください。

Provisioning tag

provisioning tag は任意ですが、provisioning server が設定されている場合は連携して動作します。networking solution integration を扱う場合、一部の service products(Data、Voice、SMS - SIM card に関連)は、Monetization で使用できるようになる前に network で provisioned される必要があります。

たとえば、顧客が product を購入した後、Monetization は(web link が設定されていれば)provisioning server に request を送信し、特定の SIM card と特定の番号が product を購入したことを provisioning server に伝えます。server がそれを provision すると、Monetization はすべて問題ないことを確認する response を期待し、その後にのみ product が顧客に対して activated されます。

Non-active rating

non-active rating は任意ですが、products と discounts で設定できます。これは、それらの products と discounts が inactive または closed になった後も、Monetization が関連する impacts を適用するかどうかを意味します。

設定可能なオプションは 3 つあります。

  • FORBIDDEN — Monetization は、その product が active の場合にのみ rating できることを意味します。
  • RATE_INACTIVE — Monetization は、その product が active または inactive の場合にのみ rating でき、closed の場合は rating できないことを意味します。
  • RATE_INACTIVE_AND_CLOSED — Monetization は、その product が active、inactive、closed のいずれであっても一貫して rating することを意味します。

たとえば、inactive service product の non-active rating が RATE_INACTIVE である場合、Monetization がその service の usage event を受信すると、Monetization は product を rate します。ただし、non-active rating が FORBIDDEN に設定されている場合、その usage event はその product に対して rated されません。

Resources

Resources は必須であり、product に紐付けられる resource(s) を示します。つまり、顧客が product を購入すると、その見返りとして resource(s) を受け取ります。その後、顧客は resource(s) を消費できます。

Resources は MonetizationBusiness configuration Charging Resources で設定できます。

詳細については、Resources を参照してください。

resource を追加するには、 Add resource をクリックし、product purchase に付随する特定の resource を選択します。

resource を削除するには、 Delete をクリックします。

Versions

Versions は resource と連動し、validity period configuration に基づいて有効です。デフォルトでは、product version は product が作成された日から無期限まで有効です。ただし、product の別の version を含める必要がある場合は、まず現在の version の終了日を infinite period から特定の日付に変更します。

product の変更/更新のたびに新しい product を作成する必要はありません。代わりに product version を更新できます。product versions の履歴も Monetization に保持されます。そのため、過去の日付に設定されていた内容にも引き続きアクセスできます。

product version を追加するには、 Add version をクリックします。validity period と price は必須です。さらに、rate plans と tax は任意で設定できます。

version を削除するには、 Delete をクリックします。

proration セクション

Prorated は、特定の期間に合わせて調整することを意味します。このセクションでは、Purchase action を次の 3 つの変数のいずれかに設定できます。

  1. Full amount
  2. Prorated amount
  3. None

Full amount として設定した場合、たとえば product の価格が 50 ユーロで、顧客が月の 16 日に購入しても、Monetization は顧客に同じ 50 ユーロを charge します。

Prorated amount として設定した場合、たとえば product の価格が 50 ユーロで、顧客が月の 16 日に購入した場合、Monetization は顧客に 50 ユーロを charge しません。代わりに、顧客と product の cycle を考慮します。これに基づいて、顧客が支払う正確な価格を計算します。

product summary

このセクションには、前の 3 つのセクション(product info セクションconfigurationproration)で入力した内容の summary が表示されます。product を作成する前に product details を確認できます。

product のコピー

products で既存の product をコピーすると、新しい product をすばやく作成できます。基本的には、 Copy をクリックすると product creation page にリダイレクトされ、コピー元 product のデータが含まれます。

たとえば、gold、diamond、platinum product があり、名前と価格だけが異なるとします。それぞれの product をゼロから作成する代わりに、1 つを作成し、前のものから残り 2 つをコピーして名前と価格を編集できます。

product 詳細ページ

products で product の詳細全体を表示するには、 Details をクリックします。次のセクションが含まれます。

  • Info
  • Configuration
  • Proration

product の更新

products で product を更新するには、まず Details をクリックします。product の詳細が表示されます。次に、更新するには Update をクリックします。

product の削除

products で product を削除するには、 Delete をクリックします。

Rate plans

このセクションにアクセスするには、Rate plans をクリックします。すべての rate plans のページ分割されたリストが表形式で表示されます。

Overview
Rate plans は service type の fields を matching し、1 つの mapping に対して特定の impacts(prices)を適用するために使用されます。たとえば、Slovenia 発の data service は、United States 発のものとは異なる impacts/prices を持ちます。
Definition
Rate plans は usage events を rating するために使用される mappings です。product が service product(つまり service type が設定されている)である場合、通常、service からの events をどのように rated するかを Monetization に伝える rate plan も持ちます。
どのように機能しますか?
Monetization が特定の service の event を受信すると、その service が属する service product を探し、その product に Monetization が event をどのように rated すべきか判断するための rate plan が紐付いているかを確認します。
Specification
Rate plans は、rating events のために特定の service を提供する products に付与されます。product は複数の rate plans を持つことができます。さらに、顧客はより高い priority rate plan を持つ新しい product を購入でき、これにより pricing が変更されます。これは marketing strategy のために行えます。

このセクションでは、次の 5 つのアクション/サブページを実行または表示できます。

rate plan の作成

rate plans で rate plan を作成するには、 Create new をクリックします。これは次の 3 つのセクションで構成されます。

rate plan info セクション

info セクションでは、名前、コード、説明、validity period を入力します。general ledger は、Monetization が financial accounting purposes のために rate plan をどのように記録するかを示します。さらに、rate plan の servicerating metric を選択します。

mappings セクション

mappings セクションには、初期状態では空の mappings リストがあります。

Mapping fields

mapping field は rate plan row の 1 列を表します。Mapping fields は service type fields に関連し、charges を適用する正しい rate plan mapping を決定するために、string values または rating sets と比較されます。

mapping field では、rate plan info セクション に含められた service type にある service fields を drop-down で選択できます。特定の service field を選択したら Add をクリックします。追加後、mapping field を削除するには をクリックします。

Mappings

無限の数の mappings を作成できます。それぞれが一意の event entry を担当でき、各 mapping には priority があります。rate plan mapping を作成するには、Mappings Add mapping をクリックします。

各 mapping row に特定の mapping field を追加したら、usage event 内の parameters が特定の mapping row に一致するために必要な値を入力します。

mapping field が rating set field の場合、Monetizationrating sets セクションで設定された hierarchy structure を表示します。

mapping をコピーするには、Mappings Copy をクリックし、mapping を削除するには Delete をクリックします。mapping をコピーすると、コピー元 mapping のデータを保持したまま新しい mapping row が作成されます。

Mapping groups

各 mapping は複数の mapping groups を持つことができます。mapping group を作成するには、Mappings で、まず Toggle をクリックし、次に Add mapping group をクリックします。

各 mapping group には rating metric を含めることができます。rating metric を含めると、rate plan info セクション に入力された rating metric を上書きできます。また、rating process 全体で複数の rating metrics を使用できるようになります。

各 mapping group には複数の tariffs も含めることができます。

各 mapping group には charge tag も含めることができ、これは主に discounting に使用されます。詳細については、Tags を参照してください。さらに、各 mapping group の下で ranges を設定できます。詳細については、Ranges を参照してください。

Ranges

rate plan mapping が決定されると、ranges は、顧客に free resources が利用可能かどうかの確認など、追加条件に使用されます。

range condition が true の場合、Monetization は range 内にある details を適用します。Monetization は unrated quantity が残っている限り、range details を適用し続けます。

range を作成するには、Mapping groups Add range をクリックします。

range の例

2 つの ranges があるとします。1 つ目は Priority1BaseFree Data resource、Start value が No minimumStop value が 0 です。

2 つ目は Priority0BaseUS-Dollar resource、Start value が No minimumStop value が No maximum です。

顧客が free 20MB を持っているが 25MB を消費したとします。free 20MB は有効な range(-20 から 0)にあるため、Free Data resource に適用されます。しかし、残りの 5MB はその range に収まらなくなるため、monetary charge として適用されます(常に有効な 2 つ目の range から)。

Multi-tier checkbox option は、ranges を段階的に進むために使用されます。たとえば、次の ranges があるとします。

  1. Quantity_Counter; 0-100 — 1 unit あたり 1 euro を適用
  2. Quantity_Counter; 100-200 — 1 unit あたり 2 euro を適用
  3. Quantity_Counter; 200-infinite — 1 unit あたり 3 euros を適用

quantity が 250 の event があるとします。Multi-tier が disabled の場合、amount は次のようになります。

250 × 3 euro = 750 euro 全 quantity が、該当する range(3)に基づいて charge されます。

Multi-tier が enabled の場合、price は次のようになります。

100 × 1 euro + 100 × 2 euro + 50 × 3 euro = 450 euro quantity は各 tier を順番に進みます。

Details

details は Monetization で発生する impacts を指します。

detail を作成するには、Ranges Toggle をクリックし、次に Add detail をクリックします。priority、resource、amount、impact type、bill item、general ledger、unit、resource tag を入力します。

いくつかの用語の説明
  • amount は price を指します。amount(debit)は、顧客に charge していることを意味します。

  • impact type(scaled)は、Monetization が受け取った calculated quantity に amount を掛けることを意味し、impact type(fixed)は、受け取った quantity によって price が掛けられないことを意味します。

  • bill item は、charge が invoice にどのように表示されるかを Monetization に伝えるために使用されます。

  • unit は、可能な quantity unit conversion に使用されます。詳細については、Unit groups を参照してください。

  • resource tag は discount targeting に使用されます。

  • general ledger は、financially に物事をどのように追跡するかを Monetization に伝えます。general ledger を作成するとき、どの account を credited または debited するかを決定するために複数の account mappings が提供されます。

rate plan summary

このセクションには、前の 2 つのセクションで入力した情報が表示され、rate plan を作成する前に確認できます。

rate plan のコピー

rate plans で既存の rate plan をコピーすると、新しい rate plan をすばやく作成できます。基本的には、 Copy をクリックすると rate plan creation page にリダイレクトされ、コピー元 rate plan のデータが含まれます。

この機能を使用すると、以前に作成した rate plan をモデルとして新しい rate plan をすばやく作成できます。

rate plan 詳細

rate plans で rate plan の詳細全体を表示するには、 Details をクリックします。次の内容が含まれます。

  • Name
  • Code
  • Description
  • General ledger
  • Service
  • Rating metric
  • Validity

情報の下には、rate plan mappings が表形式で表示され、その ranges と details も含まれます。

rate plan の更新

rate plans で rate plan を更新するには、まず Details をクリックします。rate plan の詳細が表示されます。次に、更新するには Update をクリックします。

rate plan の削除

rate plan を削除するには、 Delete をクリックします。

Rating

Rating は Monetization の process であり、各 products または rate plan resource details に設定された quantity と amounts に従って resource balance impacts を適用します。

Rating sets

このセクションにアクセスするには、Rating sets をクリックします。すべての rating sets が表示されます。

Overview
Rating sets は、zoning hierarchy を作成できる場所を示します。usage events を設定するにはどちらか一方が必要になるため、rate plans と密接に結び付いています。
Definition
Rating sets は、rate plan mapping に柔軟性の層を追加するために複数の match sets を持つ hierarchical objects です。string mapping の代わりに、RatingSet object 全体の match set と照合されます。
Example
最も一般的な例は countries の prefixes です。たとえば Slovenia prefix は +386 で、Slovenia の Telemach operator は +38670、+38640、別の operator は +38641 になる場合があります。これにより zoning hierarchies が作成され、rate plan mappings で参照できるようになります。

このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。

rating set の作成

rating sets で parent rating set を作成するには、 Create a new parent rating set をクリックします。

名前とコードを入力します。Match Set は、正しい rate plan mapping を決定するために usage event 内の field と比較される string values のセットです。match set を作成するには、Match Set Create new をクリックします。

Info Set は、rating set の custom information を保存するために使用される key-value pairs のセットです。processing logic への impact はありません。info set を作成するには、Info Set Create new をクリックします。

rating set の例

telecommunication industry では、Slovenia rating set に +386、+38671、+38641 の match values があり、United States rating set に +1 と +12 の match values があるとします。

origin が +3865541234 に設定された voice call の usage event が到着します。この event は、string prefix が Slovenia rating set の match value と一致するため、Slovenia rate plan mapping に mapped されます。

一方、event の origin が +14234235435 に設定されている場合、United States rate plan mapping に map されます。

rating set 詳細

rating sets で rating set の詳細全体を表示するには、rating set の名前をクリックします。次の情報が含まれます。

  • Name
  • Code
  • Match set
  • Info set

rating set の更新

rating sets で rating set を更新するには、まず rating set の名前をクリックします。詳細が表示されます。次に、更新するには Update をクリックします。

rating set の削除

rating sets で rating set を削除するには、まず rating set の名前をクリックします。詳細が表示されます。次に、削除するには Delete をクリックします。

Rollovers

このセクションにアクセスするには、Rollovers をクリックします。すべての rollovers のページ分割されたリストが表形式で表示されます。

Rollovers は、billing cycles 間で resource balances をどのように transfer できるかを決定する設定済み rules です。顧客は未消費の resource units の一部を次の billing cycle に移動できます。

たとえば、顧客は毎月 free 200MB の data を受け取りますが、rollover は未消費の場合に 100MB の data を次の cycle に繰り越せると定義します。


このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。

rollover の作成

rollovers で rollover を作成するには、 Create new をクリックします。これは次の 4 つのセクションで構成されます。

rollover info セクション

info セクションでは、名前、コード、説明を入力します。

validity セクション

validity セクションでは、rollover の active period を示す日付を設定します。

rollover details セクション

このセクションでは、名前とコードを入力します。Priority は、複数の rollovers がある場合に最初に使用される rollover を決定します。

Cycle rollover amount は、transfer できる最大 amount を指定します。cycle rollover amount を -1 に設定すると、maximum amount は infinite になります。

Transfer type は、新しく transferred された balance を元の balance から差し引く(modified source)か、copy として作成する(leave source)かを決定します。

Resource transfer from は、balance を transfer する resource を示します。

Resource transfer to は、特定の balance を受け取る resource を示します。

General ledger は、rollover が accounting purposes のためにどのように記録されるかを示します。

rollover summary

このセクションには、前の 3 つのセクションの情報が表示され、rollover を作成する前に確認できます。

rollover 詳細ページ

rollovers で rollover の詳細全体を表示するには、 Details をクリックします。次のセクションが含まれます。

  • Info
  • Validity
  • Rollover details

rollover の更新

rollovers で rollover を更新するには、まず Details をクリックします。rollover の詳細が表示されます。次に、更新するには Update をクリックします。

rollover の削除

rollovers で rollover を削除するには、 Delete をクリックします。

Tariffs

このセクションにアクセスするには、Tariffs をクリックします。すべての tariffs のページ分割されたリストが表形式で表示されます。

Tariffs は Monetization における Time of Use を示します。service events の特定の time of use を表すために使用されます。tariffs を使用することで、夜間/昼間、週末/平日などに発生する usage events に対して異なる pricing を設定できます。


このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。

tariff の作成

tariffs で tariff を作成するには、 Create new をクリックします。名前、コード、タイプ、priority、validity period を入力します。任意で説明を追加します。

選択した type に基づいて、tariff は date(dd-mm-yy)、day of the week(1-7)、time range(08:00-10:00)、month 内の day range(8-12)、day and time range(8 日から 12 日の 08:00-10:00 の間)を表すことができます。

たとえば、type が 12:00 AM から 5:00 AM までの start time と stop time を持つ time range を使用するよう設定されている場合、その tariff を rate plan に適用すると異なる pricing につながります。

さらに、tariffs は priority に基づいて matched されます。たとえば、workday tariff が priority 1 で Mon-Fri のすべての日を対象にしていても、Tuesday, 13th Sep 2022 の Holiday Date tariff が priority 2 で上書きします。

tariff 詳細ページ

tariffs で tariff の詳細全体を表示するには、 Details をクリックします。次の内容が含まれます。

  • Status
  • Name
  • Code
  • Description
  • Type
  • Priority
  • Validity period

tariff の更新

tariffs で tariff を更新するには、まず Details をクリックします。tariff の詳細が表示されます。次に、更新するには Update をクリックします。

tariff の削除

tariffs で tariff を削除するには、 Delete をクリックします。