課金
カテゴリ:
このドキュメントのトピック:
Monetization でこのセクションにアクセスするには、 Menu から Business configuration を選択し、Charging をクリックします。
Tags
このセクションにアクセスするには、Tags をクリックします。すべての tags のページ分割されたリストが表形式で表示されます。
Tags は、Monetization で主に割引目的に使用されます。tag は charge tag として product に適用でき、discounts を作成するときに対象にできます。
注:
tag を使用することで、invoice レベルの discounts と各イベントのリアルタイム discounting を作成できます。Monetization が resource balance に impact を与えるたびに、これらの impacts にも discounting の対象にできる tags があります。
たとえば通信業界では、Austria 発の data event に tag data_AUS を付け、Slovenia 発の event に tag data_SVN を付けることができます。
これらの tags により、1 つの tag にのみ適用される discounts を設定でき、特定の使用タイプだけに割引を適用できます。
このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。
tag の作成
tags で tag を作成するには、 Create new をクリックします。名前、コード、タイプを入力します。任意で説明を追加します。
注:
code はオブジェクトの一意識別子です。Monetization API との連携時に使用できます。type では、charge tag または resource tag を選択できます。charge tag と resource tag の違いについては、Charge tags と Resource tags を参照してください。
Charge tags と Resource tags
charge tag は、products と rate plan の resource infos に使用されます。rate plan の上位レベルで使用され、Monetization は tag の下にある複数の resources に impact を与えることができます。
resource tag は、rate plan の下位レベルで使用されます。rate plan details で使用され、Monetization は 1 つの resource balance にのみ impact を与えることができます。
注:
rate plan の設定中に resource tag と charge tag を作成して組み合わせることができ、discount 対象を絞り込めます。情報:
discount filter は charge tag と resource tag の両方を対象にできるため、柔軟性が高まります。tag 詳細ページ
tags で tag の詳細全体を表示するには、 Details をクリックします。次の情報が含まれます。
- Name
- Code
- Description
- Type
tag の更新
tags で tag を更新するには、まず Details をクリックします。tag の詳細が表示されます。次に、更新するには Update をクリックします。
情報:
tag の作成 セクションで入力したすべての情報は、Code を除いて更新できます。tag の削除
tags で tag を削除するには、 Delete をクリックします。
注:
product、discount、または rate plan ですでに使用されている tag は削除できません。tag への各参照を先に削除する必要があります。Resources
このセクションにアクセスするには、Resources をクリックします。すべての resources のページ分割されたリストが表形式で表示されます。
情報:
このセクションでは、Monetization で resources を作成する方法を示します。たとえば、monetary resources（Euro、US Dollar など）、free resources（free SMS、free data など）などです。resource は、Monetization 内で値を保持できるオブジェクトを表します。たとえば、値 10 を持つ monetary resource です。
さらに、resource は顧客の balance として存在できます。balance は、特定の balance group 内にある一意の resource value です。
resource の balances は、顧客が product を購入したり usage event をトリガーしたりするたびに、Monetization で自動的に作成されます。たとえば、plan に 100 free minutes を付与する product がある場合、顧客がその plan を購入すると、関連する balance group に 100 free minutes の balance が作成されます。
情報:
balance は API 経由で手動作成することもできますが、これは自動化よりも管理目的で使用されます。resources は、product catalog を作成する際に不可欠です。顧客が購入できる products は resource balance impact をもたらすためです。たとえば、顧客に 100 ユーロを課金する、または 100 free credits を付与するなどです。
resource の例
以下は resource の 5 つの例と、その業界です。
- Euro — Any industry — 現在の cycle 内の顧客の現在の monetary balance を表します。
- Free minutes — Telecommunications
- Total consumption kWh — Utility
- Minimum fare fee — Car sharing/Taxis — 顧客が各乗車で支払う必要がある minimum fee を保持する helper resource
- API calls total — Cloud services — 生成された API call events の数を追跡するため
注:
customer が product を購入したり usage event を生成したりすることで、resource balance は増減する場合があります。customer が product を購入する、または usage event をトリガーする service を使用するたびに、customer の balance は影響を受けます。このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。
resource の作成
resources で resource を作成するには、 Create new をクリックします。必須および任意の入力フィールドがあります。
必須入力フィールドは次のとおりです。
- Name
- Code
- Balance consumption order
- Default value
- Validity period
注:
code はオブジェクトの一意識別子です。Monetization API との連携時に使用できます。任意入力フィールドは次のとおりです。
- Description
- Temporary
- Currency
- Included on invoice
注:
Monetization で最も重要な resource は monetary resource です。これは顧客が支払う通貨を表すためです。Monetary resource
Monetary resource は Monetization における実際のお金を意味し、通貨（例: euro、dollars など）を表します。monetary resource を作成するには、resource の作成 で名前（例: euro）、コード（例: euro）、説明（例: euro monetary resource）、および balance consumption order を入力します。
monetary resource では、最も古い balance が最初に消費されるべきであるため、balance consumption order に earliest start time and earliest expiration time (ESTEET) が設定されます。
通常、default value は 0 に設定されます。ただし、正または負の値（例: 100）に変更できます。Monetization が最初に resource の balance を作成するとき、default value から開始します。
ヒント:
free resource の default value を 0 から変更しないことを推奨します。default value は、作成されたすべての resource balances に対してすべての顧客へグローバルに適用されるためです。代わりに、顧客に一定量の free resources を付与する product を作成します。
通常、Monetization は free resources を customer plan に基づけます。ある顧客は 1GB の free data を持ち、別の顧客は 2GB を持つ場合があります。したがって、その plan 用の product を作成し、plan に応じた正しい量を付与します。
情報:
balance がゼロに向かって減少する counter を表す resource を作成できます。この場合、default value は任意の正の数に設定できます。
product の購入によって resource balance を初期設定する代わりに、resource balance は resource balance 作成時に resource の default value に設定されます。有用性の詳細については、helper resources を参照してください。
resource を temporary resource にするには、Temporary トグルスイッチを使用して有効化/無効化します。この機能を有効にすると、Monetization が rating を完了した直後に、resource は default value に戻ります。主に helper resources に使用されます。
デフォルトでは、resource は作成日から無期限に常に有効です。ただし、将来のある時点で期限切れになるように設定できます。通常、monetary resource は無期限の validity を持つべきです。
注:
resource に currency が割り当てられると monetary resource になります。一方、non-monetary resource については non-monetary resource を参照してください。resource を invoice に含めるには、Included on invoice トグルスイッチを使用して有効化/無効化します。この機能を有効にすると、Monetization は 1 つの invoice 用に生成される JSON オブジェクトにこのデータを取り込みます。
注:
パフォーマンス最適化のため、invoice に必要な情報のみを含めてください。Balance consumption order
Balance consumption order は、同じ resource の複数の balances が balance group 内に存在する場合、resource balance に impact を与える順序を指定します。
たとえば、customer balance group に次があるとします。
- 1 月 1 日から 2 月 15 日まで有効な 100 free minutes
- 2 月 1 日から 3 月 1 日まで有効な 50 free minutes
今日が 2 月 10 日だとすると、両方の balances は有効です。したがって、customer は現在合計 150 free minutes を持っています。その後、customer が 120 free minutes のイベントを生成します。balance consumption order 設定は、validity period に基づいてどの balance を先に消費するかを決定します。
balance consumption order が ESTEET に設定されている場合、customer は 2 月 1 日 から 3 月 1 日 まで有効な 30 free minutes を持つことになります。一方、balance consumption order が最新の resource を先に消費するよう設定されている場合、customer は 1 月 1 日 から 2 月 15 日 まで有効な 30 free minutes を持つことになります。
一部用語の説明
- EST
- balance consumption order を earliest start time (EST) に設定すると、最も早い validity start time を持つ balance が最初に使用されます。
- LST
- balance consumption order を latest start time (LST) に設定すると、最も遅い validity start time を持つ balance が最初に使用されます。
- EET
- balance consumption order を earliest expiration time (EET) に設定すると、最も早い validity end time を持つ balance が最初に使用されます。
- LET
- balance consumption order を latest expiration time (LET) に設定すると、最も遅い validity end time を持つ balance が最初に使用されます。
- ESTLET
- balance consumption order を earliest start time and latest expiration time (ESTLET) に設定すると、最も早い validity start time を持つ balance が最初に使用されます。同じ validity start time を持つ balances が複数ある場合、最も遅い end time を持つものが最初に使用されます。
- ESTEET
- balance consumption order を earliest start time and earliest expiration time (ESTEET) に設定すると、最も早い validity start time を持つ balance が最初に使用されます。同じ validity start time を持つ balances が複数ある場合、最も早い end time を持つものが最初に使用されます。
ヒント:
ESTEET を default balance consumption order として使用するべきです。- LSTEET
- balance consumption order を latest start time and earliest expiration time (LSTEET) に設定すると、最も遅い validity start time を持つ balance が最初に使用されます。同じ validity start time を持つ balances が複数ある場合、最も早い end time を持つものが最初に使用されます。
- LSTLET
- balance consumption order を latest start time and latest expiration time (LSTLET) に設定すると、最も遅い validity start time を持つ balance が最初に使用されます。同じ validity start time を持つ balances が複数ある場合、最も遅い end time を持つものが最初に使用されます。
- EETEST
- balance consumption order を earliest expiration time and earliest start time (EETEST) に設定すると、最も早い validity end time を持つ balance が最初に使用されます。同じ validity end time を持つ balances が複数ある場合、最も早い start time を持つものが最初に使用されます。
- EETLST
- balance consumption order を earliest expiration time and latest start time (EETLST) に設定すると、最も早い validity end time を持つ balance が最初に使用されます。同じ validity end time を持つ balances が複数ある場合、最も遅い start time を持つものが最初に使用されます。
- LETEST
- balance consumption order を latest expiration time and earliest start time (LETEST) に設定すると、最も遅い validity end time を持つ balance が最初に使用されます。同じ validity end time を持つ balances が複数ある場合、最も早い start time を持つものが最初に使用されます。
- LETLST
- balance consumption order を latest expiration time and latest start time (LETLST) に設定すると、最も遅い validity end time を持つ balance が最初に使用されます。同じ validity end time を持つ balances が複数ある場合、最も遅い start time を持つものが最初に使用されます。
Helper resources
helper resource は顧客に直接関連しませんが、Monetization は rating に使用します。たとえば、Monetization が何かを追跡するために使用する counter resource です。
helper resource の例
1 つの data session/event で customer が使用した MB 数を追跡するための resource MBs used in a session を想定します。counter resource 形式の helper resource を使用できます。
customer が 1 つの session 内で 10MBs を消費した後に pricing が変わることが想定される場合、つまり multi-tier pricing がある場合、Monetization が data event を受信するとすぐに、rate plan に従ってレーティングされます。counter resource は、異なる価格で rating を開始するタイミングを把握するために、customer が使用した数量を追跡できます。
単一イベントがレーティングされた後、counter resource 形式の helper resource MBs used in a session は、次のイベントに備えるためゼロにリセットされます。
注:
各 rating 後に resource を default value にリセットするには、Temporary トグルスイッチを有効にする必要があります。Non-monetary resource
non-monetary resource は monetary value を持たないため、お金として扱われません。non-monetary resources の例には、free data、free SMS などがあります。
情報:
resource を一般的に作成する方法については、monetary resource を参照してください。注:
non-monetary resource には currency を設定しないでください。resource に currency を割り当てると monetary resource になります。resource 詳細ページ
resources で resource の詳細全体を表示するには、 Details をクリックします。次の情報が含まれます。
- Status — active status の resource は、その resource がまだ有効であることを意味します。
- Name
- Code
- Description
- Balance consumption order
- Default value
- Type (Standard or Temporary)
- Valid from
- Valid to
- Currency (if any)
- Included on invoice
resource の更新
resources で resource を更新するには、まず Details をクリックします。resource の詳細が表示されます。次に、更新するには Update をクリックします。
情報:
resource の作成 セクションで入力したすべての情報は、Code を除いて更新できます。resource の削除
resources で resource を削除するには、 Delete をクリックします。
注:
Monetization の他の部分ですでに使用されている resource は削除できません。resource への各参照を先に削除する必要があります。Thresholds
このセクションにアクセスするには、Thresholds をクリックします。すべての thresholds のページ分割されたリストが表形式で表示されます。
threshold は、resource balance が credit limit で定義され、credit profile によって resource にリンクされた threshold を超えた場合に notification をトリガーできる設定値です。
このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。
threshold の作成
thresholds で threshold を作成するには、 Create new をクリックします。必須および任意の入力フィールドがあります。
必須フィールドは次のとおりです。
- Name (e.g., T_200)
- Code (e.g., T_200)
- Type (amount or percentage)
- Value (e.g., 200)
注:
code はオブジェクトの一意識別子です。Monetization API との連携時に使用できます。任意フィールドは次のとおりです。
- Description (e.g., threshold for 200)
amount として設定された threshold は、値が固定であることを意味します。たとえば 200 です。したがって、balance が 200 を超えると notification がトリガーされます。
注:
amount として設定された threshold value は負の値にもできます。percentage として設定された threshold は、値が別の resource balance に対して相対的であることを意味します。たとえば、次の 2 つの balances を想定します。
表 1: Threshold percentage example
| Resource name | Balance |
|---|---|
| Granted free MBs | 1000 |
| Free MBs | 900 |
Free MBs の percentage threshold が Granted free MBs balance の 80% に設定されている場合、その threshold は 800 でトリガーされます。
ヒント:
percentage threshold は、別の resource balance に基づいて値を変更できるため便利です。customer レベルでより柔軟にできます。一方、amount threshold は設定された値に基づいて常に一定です。情報:
threshold が作成されても、何にも接続されません。むしろ Monetization 内に存在し、credit limit 作成時に使用できるオブジェクトです。threshold 詳細ページ
thresholds で threshold の詳細全体を表示するには、 Details をクリックします。次の情報が含まれます。
- Name
- Code
- Description
- Type
- Value
threshold の更新
thresholds で threshold を更新するには、まず Details をクリックします。threshold の詳細が表示されます。次に、更新するには Update をクリックします。
情報:
threshold の作成 セクションで入力したすべての情報は、Code を除いて更新できます。threshold の削除
thresholds で threshold を削除するには、 Delete をクリックします。
注:
credit limit にすでにリンクされている threshold は削除できません。threshold への各参照を先に削除する必要があります。Notifications
特定の resource の balance が threshold を超える、または下回ると、Monetization は notification をトリガーします。threshold は credit limit にリンクされ、credit profile によって特定の resource に対して設定されます。
notifications は、Monetization の customer account page で確認できます。詳細については、Notifications を参照してください。
Credit limits
このセクションにアクセスするには、Credit limits をクリックします。すべての credit limits のページ分割されたリストが表形式で表示されます。
credit limit は、顧客が resource を正または負の値としてどこまで使用できるかを制限するために使用できます。複数の thresholds を追加することもでき、顧客が設定値を超えるにつれてそれらを超過する場合があります。
これは、resource balance の最小および最大制限と、超過時にどの thresholds がトリガーされるかを表します。
このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。
credit limit の作成
credit limits で credit limit を作成するには、 Create new をクリックします。必須および任意の入力フィールドがあります。
必須フィールドは次のとおりです。
- Name
- Code
- Start
- Stop
注:
code はオブジェクトの一意識別子です。Monetization API との連携時に使用できます。任意フィールドは次のとおりです。
- Description
- Thresholds
複数の thresholds を追加できます。たとえば、threshold value が 200 の credit limit を想定します。resource balance が 200 を超えるたびに、notification がトリガーされます。
注:
Start と Stop フィールドは、それぞれ 1 つの resource balance が持てる最小値と最大値を表します。Start と Stop フィールドは、正または負の数として設定できます。さらに、 Pick value をクリックすることで、Start と Stop フィールドを、より使いやすい No minimum または No maximum に設定することもできます。
No minimum と No maximum の値は、値が負の無限大から正の無限大まで進むため、無制限にできることを意味します。
ヒント:
prepaid monetary resource の Stop 値は 0 に設定する必要があります。これにより、resource balance が 0 を超えないようにできます。
これは一般的です。prepaid customers は、利用可能なお金がある間のみ service(s) を使用できるためです。したがって、monetary balance が 0 を下回ることを許可する意味はありません。
さらに、limit が 0 に設定されている場合、Monetization はお金がなくなったタイミングを判断でき、以降は events を rating しなくなります。
注:
resource balance を credit limit の Start および Stop 値の外に移動することはできません。さらに、resource limit に達すると、customer が消費する service をすぐに無効化できます。たとえば、お金を使い切った prepaid customer です。credit limit 詳細ページ
credit limits で credit limit の詳細全体を表示するには、 Details をクリックします。次の情報が含まれます。
- Name
- Code
- Description
- Thresholds
- Start
- Stop
credit limit の更新
credit limits で credit limit を更新するには、まず Details をクリックします。credit limit の詳細が表示されます。次に、更新するには Update をクリックします。
情報:
credit limit の作成 セクションで入力したすべての情報は、Code を除いて更新できます。credit limit の削除
credit limit を削除するには、 Delete をクリックします。
注:
credit profile にすでにリンクされている credit limit は削除できません。credit limit への各参照を先に削除する必要があります。Credit profiles
このセクションにアクセスするには、Credit profiles をクリックします。すべての credit profiles のページ分割されたリストが表形式で表示されます。
credit profile は、特定の payment type に対して credit limit を特定の resource にリンクします。たとえば、euro（monetary）resource がどのように動作するべきか、customer account 上の balance として利用できるときにどの credit limit を使用するべきかを示します。
このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。
credit profile の作成
credit profiles で credit profile を作成するには、 Create new をクリックします。必須および任意の入力フィールドがあります。
必須フィールドは次のとおりです。
- Name
- Code
- Payment type
- Resource
- Credit limit
注:
code はオブジェクトの一意識別子です。Monetization API との連携時に使用できます。任意フィールドは次のとおりです。
- Description
注:
credit profile は各 payment type に対して作成する必要があります。これは payment type に関連する balance behaviours を表すためです。存在しない場合、balance は作成できません。情報:
credit profile を設定すると、各 resource に、customer の payment type に基づいてどのように制限されるかを示す説明を付与できます。postpaid payment type の場合
postpaid payment type では、Start 値が No minimum、Stop 値が No maximum の credit limit が推奨されます。
これは、customer に属する resource が負の値（customer に credit が付与されたため）または正の値（customer が何かを支払う必要があるため）のいずれにもなり得ることを意味します。
pay-now payment type の場合
pay-now payment type では、Start 値が No minimum、Stop 値が No maximum の credit limit が推奨されます。
これは、customer に属する resource が負の値（customer に credit が付与されたため）または正の値（customer が何かを支払う必要があるため）のいずれにもなり得ることを意味します。
prepaid payment type の場合
prepaid payment type では、customer balance が 0 を超えないようにするため、Start 値が No minimum、Stop 値が 0 の credit limit を選択することが推奨されます。
たとえば、prepaid customer が monetary resource である 100 euros を提供する product を購入するとします。これは customer の balance に -100 euros の credit として表示されます。customer はその resource を消費でき、何も支払う必要はありません。
しかし、resource を消費し続けると、balance は 0 に達するまで減少します。これは customer が resource を使い切ったことを示します。
credit profile 詳細ページ
credit profiles で credit profile の詳細全体を表示するには、 Details をクリックします。次の情報が含まれます。
- Name
- Code
- Description
- Payment type
- Credit limit
- Resource
credit profile の更新
credit profiles で credit profile を更新するには、まず Details をクリックします。credit profile の詳細が表示されます。次に、更新するには Update をクリックします。
情報:
credit profile の作成 セクションで入力したすべての情報は、Code を除いて更新できます。credit profile の削除
credit profiles で credit profile を削除するには、 Delete をクリックします。
Event types
このセクションにアクセスするには、Event types をクリックします。すべての event types のページ分割されたリストが表形式で表示されます。
event type は、Monetization における時間間隔を表します。recurring product に対して設定され、product がどのように更新されるかを決定するために作成されます。また、customer に対して設定され、customer がどの頻度で請求されるかを決定します。
event type には異なる cycles を設定できます。たとえば、monthly cycle、three months cycle、semi-annual cycle、annual cycle などです。
このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。
event type の作成
event types で event type を作成するには、 Create new をクリックします。名前、コード、interval unit、interval duration、interval time は必須で、description は任意です。
interval unit は 3 つの値で構成されます。
- Days
- Weeks
- Months
interval duration は interval unit に与えられる期間の長さを指定します。たとえば 6 か月です。interval time の default value は 12:00 AM です。
たとえば、以下の表があるとします。
表 2: Event type interval example
| Interval unit | Interval duration | Interval time |
|---|---|---|
| Months | 6 | 12:00 AM |
recurring product に上記の event type が指定された場合、その product は 6 か月ごとの 12:00 AM に更新されることを意味します。同様に、billing profile で customer に event type を設定すると、customer は 6 か月ごとの 12:00 AM に請求されます。
event type 詳細ページ
event types で event type の詳細全体を表示するには、 Details をクリックします。次の情報が含まれます。
- Name
- Code
- Description
- Interval unit
- Interval duration
- Interval time
event type の更新
event types で event type を更新するには、まず Details をクリックします。event type の詳細が表示されます。次に、更新するには Update をクリックします。
情報:
event type の作成 セクションで入力したすべての情報は、Code を除いて更新できます。event type の削除
event types で event type を削除するには、 Delete をクリックします。
注:
Monetization の他の部分ですでに使用されている event type は削除できません。event type への各参照を先に削除する必要があります。Rounding modes
このセクションにアクセスするには、Rounding modes をクリックします。
Rounding modes は、rating のさまざまな段階で行われる計算を小数点以下何桁に丸めるかを決定するため、各 site に対して設定されます。
scale を適用する 4 つの異なるコンポーネントがあります。
- Rating
- Discounting
- Taxation
- Billing
これら 4 つのコンポーネントのいずれかが Monetization でトリガーされるたびに、rounding mode が適用され、設定された小数点以下桁数に値が丸められます。
Scale は、小数点以下の桁数を示す数値を指します。Mode は Half Up または Half Down に設定できます。たとえば、Half Up に設定されている場合、7.5 は 8 に丸められます。一方、Half Down に設定されている場合、7.5 は 7 に丸められます。
