サービス設計
カテゴリ:
このドキュメントのトピック:
Monetization でこのセクションにアクセスするには、 Menu から Business configuration を選択し、Service design をクリックします。
情報:
Monetization には、ビジネスが内部で運用するために必要な service(s) を教える必要があります。たとえば、データ、音声、SMS サービスを持つ通信業界を想定します。これらのサービスは複数のフィールドまたはパラメータで構成されます。その一部のフィールドを使用して、レーティング対象の数量を決定できます。Service fields
このセクションにアクセスするには、Service fields をクリックします。すべての service fields のページ分割されたリストが表形式で表示されます。
service field は、service type の一部にできるパラメータです。このパラメータは、Monetization 内の 1 つのセッション/イベントに関する情報を保持します。
service fields の例
顧客が電話をかけられるようにする通信会社を想定します。service fields には次のようなものがあります。
- start_time
- origin
- destination
- duration
- direction
- quantity
情報:
これらの service fields は service に含めることができます。その後、その service の使用量イベントが届くたびに、Monetization はこれらのフィールドを期待し、それらのフィールドからレーティング可能な数量を取得できます。予約済みフィールド
session identifier と identifier は予約済みフィールドであり、service fields の一部として存在する必要があります。これらは、Monetization で site が作成されると自動的に作成されます。
identifier は、1 人の顧客の service identifier を表します。たとえば、データまたは音声サービスの携帯電話番号です。identifier は各 site で一意である必要があります。整数、デバイス、または顧客を一意に識別するために使用できる任意のものにできます。
session identifier は、各使用量イベントに含める必要があります。これにより、同じイベントが一度だけレーティングされ、重複できないようになります。
このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。
service field の作成
service fields で service field を作成するには、 Create new をクリックします。名前とコードを入力します。任意で説明を追加します。
情報:
複数の service fields を作成できます。service field 詳細ページ
service fields で service field の詳細全体を表示するには、 Details をクリックします。次の情報が含まれます。
- Name
- Code
- Description
service field の更新
service fields で service field を更新するには、まず Details をクリックします。service field の詳細が表示されます。次に、更新するには Update をクリックします。
情報:
service field の作成 セクションで入力したすべての情報は、Code を除いて更新できます。service field の削除
service fields で service field を削除するには、 Delete をクリックします。
注:
Monetization の他の部分ですでに使用されている service field は削除できません。service field への各参照を先に削除する必要があります。Service types
このセクションにアクセスするには、Service types をクリックします。すべての service types のページ分割されたリストが表形式で表示されます。
service type は Monetization 内の 1 つのサービスを表します。たとえば、音声またはデータサービスです。特定のサービスの 1 つのセッション/イベントに含まれるべき service fields を決定します。
さらに、service type は、特定のサービスの使用量イベントで Monetization が必要とする任意または必須の service fields と rating set fields を示すことで、サービスを定義します。
情報:
作成された product に service type が含まれる場合、購入済み product は service を提供できます。Monetization は service 使用量のイベントをレーティングできます。このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。
service type の作成
service types で service type を作成するには、 Create new をクリックします。
必須入力フィールドは次のとおりです。
- name
- code
- mandatory service field(s)
- authorization strategy
任意入力フィールドは次のとおりです。
- description
- optional service field(s)
- rating set fields
- Included on invoice
- Impact balances
注:
code はオブジェクトの一意識別子です。Monetization API との連携時に使用できます。情報:
session identifier と identifier を必須フィールドとして含めることは良い方法です。これらは予約済みフィールドとして知られています。詳細については、予約済みフィールド を参照してください。service の詳細を invoice に含めるには、Included on invoice トグルスイッチを使用して有効化/無効化します。この機能を有効にすると、Monetization は 1 つの invoice 用に生成される JSON オブジェクトにこのデータを取り込みます。
注:
パフォーマンス最適化のため、invoice に必要な情報のみを含めてください。Impact balances トグルスイッチを有効にすると、この service はリアルタイムで balances に影響を与え、予約し、balances と連動します。これが不要な場合、オフにするとレーティング性能が向上します。
Rating set fields
rating set field は、生文字列として照合する代わりに、複数の一致を持つことができる rating sets オブジェクトと比較されるフィールドです。prefix matching に役立ちます。
ヒント:
Monetization は rating set field をパターンにマッピングします。rating set field の例
通信業界の Slovenia rating sets には、電話番号プレフィックスを表す 003865、003867、003864 など複数の一致があります。origin service field が service type 上で rating set field として定義されている場合、Monetization が一致を探す際、そのフィールドの内容は Slovenia のすべてのプレフィックスと比較されます。したがって、origin が 003865123123 の場合、Slovenia rating set が一致します。
情報:
service field をゾーン階層と比較すると、rating set field になります。service type 詳細ページ
service types で service type の詳細全体を表示するには、 Details をクリックします。次の情報が含まれます。
- Name
- Code
- Description
- Mandatory fields
- Optional fields
- Rating set fields
- Authorization strategy
- Included on invoice
- Impact balances
service type の更新
service types で service type を更新するには、まず Details をクリックします。service type の詳細が表示されます。次に、更新するには Update をクリックします。
情報:
service type の作成 セクションで入力したすべての情報は、Code を除いて更新できます。注:
顧客およびイベントで使用されている services の情報を更新する際、service type に新しい service field を追加した場合、その service field は過去のすべてのイベントに存在しません。これは、その時点で Monetization がその service field を知らなかったためです。service type の削除
service types で service type を削除するには、 Delete をクリックします。
注:
Monetization の他の部分ですでに使用されている service type は削除できません。service type への各参照を先に削除する必要があります。Unit groups
このセクションにアクセスするには、Unit groups をクリックします。すべての unit groups のページ分割されたリストが表形式で表示されます。
unit group は、Monetization で関連する units を作成するために設計されています。Monetization が units 間の変換を自動的に行えるようにするには、conversion factor も指定する必要があります。
unit group の例
通信会社が顧客にデータサービスを提供しているとします。units を kilobytes (kB)、megabytes (MB)、gigabytes (GB) で設定した後、使用量イベントは kB の入力を持つことができ、同時に価格設定は MB で動作できます。
注:
各 unit group は、関連する units を保持する必要があります。たとえば、data unit group は kB、MB、GB で構成できます。また、Monetization が units 間で自動変換できる conversion factor を含める必要があります。たとえば、kB と MB 間の変換です。情報:
rate plan の作成 時に、可能な quantity unit conversion のための unit を指定できます。このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。
unit group の作成
unit groups で unit group を作成するには、 Create new をクリックします。名前とコードを入力します。任意で説明といくつかの units を入力します。
unit を追加するには、Units で Add unit をクリックします。名前、symbol、factor を入力します。特定の unit を base unit にするには、Base unit チェックボックスをオンにします。
注:
base unit の factor は 1 である必要があり、他の units は base unit と比較した factor を持つ必要があります。たとえば、unit group に次の units があるとします。
表 1: Unit group example
| Name | Symbol | Factor | Base unit |
|---|---|---|---|
| kilobyte | kB | 1 | |
| megabyte | MB | 1024 | |
| gigabyte | GB | 1048576 |
unit を削除するには、Units で Delete をクリックします。
unit group 詳細ページ
unit groups で unit group の詳細全体を表示するには、 Details をクリックします。次の情報が含まれます。
- Name
- Code
- Description
- Units - The units are shown in a tabular format.
unit group の更新
unit groups で unit group を更新するには、まず Details をクリックします。unit group の詳細が表示されます。次に、更新するには Update をクリックします。
情報:
unit group の作成 セクションで入力したすべての情報は、Code を除いて更新できます。unit group の削除
unit groups で unit group を削除するには、 Delete をクリックします。
Rating metrics
このセクションにアクセスするには、Rating metrics をクリックします。すべての rating metrics のページ分割されたリストが表形式で表示されます。
Monetization は rating metric を使用して、セッション/イベントの service field(s) に基づいてレーティング対象の数量を決定します。言い換えると、rating metric により、Monetization はイベントからレーティング可能な数量をどのように取得するかを認識できます。
情報:
Monetization で rating metric が作成されても、service や product には紐付けられません。これは rate plan を作成するときに行われます。このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。
rating metric の作成
rating metrics で rating metric を作成するには、 Create new をクリックします。名前とコードを入力します。任意で説明と metric expression(s) を入力します。
metric expression を追加するには、Metric expressions で Add metric expression をクリックします。priority、expression、unit を入力します。unit は unit groups で設定されます。詳細については、Unit groups を参照してください。
注:
Expression は、service type の service fields を直接参照する必要があります。たとえば、quantity service field が rating metric expression として挿入されているとします。Monetization は quantity service field からレーティング可能な数量を取得します。
注:
複数の metric expressions を異なる priorities で作成できます。たとえば、priority 0、priority 1、priority 2 などです。ただし、Monetization は最初に、より大きい priority number を持つ metric expression を使用します。metric expression では、加算、減算、乗算などの基本的な数式を実行して、レーティング可能な数量を決定できます。たとえば、end_time と start_time service field があるとすると、end_time - start_time 形式の rating metric expression を作成できます。
情報:
metric の実際の割り当ては、service product の作成時に後で行われます。rating metric 詳細ページ
rating metrics で rating metric の詳細全体を表示するには、 Details をクリックします。次の情報が含まれます。
- Name
- Code
- Description
- Metric expressions - The metric expressions are shown in a tabular format.
rating metric の更新
rating metrics で rating metric を更新するには、まず Details をクリックします。rating metric の詳細が表示されます。次に、更新するには Update をクリックします。
情報:
rating metric の作成 セクションで入力したすべての情報は、Code を除いて更新できます。rating metric の削除
rating metrics で rating metric を削除するには、 Delete をクリックします。
注:
Monetization の他の部分ですでに使用されている rating metric は削除できません。rating metric への各参照を先に削除する必要があります。Charge intervals
このセクションにアクセスするには、Charge intervals をクリックします。すべての charge intervals のページ分割されたリストが表形式で表示されます。
charge interval は、Monetization が rating metric から得たレーティング可能な数量をどのように丸めるかを表します。rating metric がレーティング対象の生数量を計算した後、charge interval は設定に基づいて切り上げまたは切り下げできます。
注:
Monetization がイベントを受信すると、レーティング可能な数量が取得されます。その後、charge interval と比較され、次のステップへ切り上げまたは切り下げられます。丸められた値が新しいレーティング可能な数量になります。このセクションでは、次の 4 つのアクション/サブページを実行または表示できます。
charge interval の作成
charge intervals で charge interval を作成するには、 Create new をクリックします。名前とコードを入力します。任意で説明、minimum step、step、rounding mode、unit を入力します。
minimum step は、レーティング可能な最小数量を表します。したがって、Monetization がそれを下回るイベントを受信した場合、minimum step に丸められます。たとえば、minimum step 設定が 0 で、Monetization が 0 未満のイベントを受信した場合、そのイベントは 0 に丸められます。
step は、レーティング可能な数量がどのように増分するかを表します。たとえば、Monetization がイベントを受信し、rating metric によりレーティング可能な数量が 550 であると判断したとします。step が 100 に設定されている場合、Monetization は rounding mode の設定に応じて数量を切り上げまたは切り下げます。
rounding mode が Up に設定されている場合、新しいレーティング可能な数量は 600 になります。一方、rounding mode が Down に設定されている場合、新しいレーティング可能な金額は 500 になります。
charge interval 詳細ページ
charge intervals で charge interval の詳細全体を表示するには、 Details をクリックします。次の情報が含まれます。
- Name
- Code
- Description
- Min step
- Step
- Rounding mode
- Unit
charge interval の更新
charge intervals で charge interval を更新するには、まず Details をクリックします。charge interval の詳細が表示されます。次に、更新するには Update をクリックします。
情報:
charge interval の作成 セクションで入力したすべての情報は、Code を除いて更新できます。charge interval の削除
charge intervals で charge interval を削除するには、 Delete をクリックします。
