高度な Balance modifier

高度な Balance modifier は、要求された取引金額、一日の時間、または以前のオペレーションで使用された特定のコインの金額などの条件に基づいて変更の金額を変更できるようにすることで、Basic modifier に対して柔軟性を提供します。
高度な Balance modifier は、マーケティング キャンペーンを導入する場合や特定のアクションを実行するユーザーにインセンティブを付与する場合に特に有用です。

Tiered

Tiered modifier は、元の取引金額に基づいて転送するコインの数を計算します。Tiered modifier 構成は一連の階層で構成され、それぞれ、転送する元のトランザクションの金額の範囲と、固定額または割合を定義します。この modifier は、トランザクションの規模に基づいてコインの使用を推奨するかどうかを決めるのに役立ちます。

プロパティ

Tiered modifier は、Basic modifier のプロパティを継承します。階層のリストを定義するための追加のプロパティが 1 つあります。

各階層には次のプロパティがあります。

UsageAmount は、構成中の階層の開始点を示す取引金額です。UsageAmount から始まる次の階層 (存在する場合) までの金額によって、この Balance modifier は階層の特定の構成を使用して実行されます。

📘

例

自分のコインエコノミーで、より多くの金額を消費した消費者に対するボーナスコインの支払額を増やしたい。

元の取引金額: 175
使用したコイン: 175
ボーナスの割合: 2
受け取ったボーナスコイン: 3

設定:
DecreaseTarget: “issuer”
IncreaseTarget: “consumer”
AvailableCoins: [“bonus”]
Tiers: [
UsageAmount:0, Amount:0
UsageAmount:100, Percent:2.0
UsageAmount:1000, Percent:5.0
]

🚧

制約

Amount または Percent を指定する必要があります。両方を指定した場合、Amount が使用されます。少なくとも1つの階層を構成する必要があり、最初の階層の使用額はゼロから開始する必要があります。

TieredDependent

TieredDependent modifier は、イベント内の前の modifier での特定のコインの使用状況に基づいて、転送するコインの数を計算します。Tiered modifier と同様、TieredDependent modifier は一連の階層で構成され、それぞれ、転送する元のトランザクションの金額の範囲と、固定額または割合を定義します。この modifier は、特定のコイン タイプを使用するユーザーに報酬を与える場合に特に役立ちます。

プロパティ

TieredDependent modifier は、Basic および Dependent modifier のプロパティを継承します。階層のリストを定義するための追加のプロパティが 1 つあります。

各階層には次のプロパティがあります。

UsageAmount 階層が使用される取引金額 (包含的) です。

📘

例

自分のコインエコノミーで、より多くの purple コインを消費した消費者に対するボーナスコインの支払額を増やしたい。

元の取引金額 (purple コイン): 1080
使用したコイン: 1080
受け取ったボーナス: 10% (ボーナスコイン 108 枚)

設定:
DecreaseTarget: “issuer”
IncreaseTarget: “consumer”
AvailableCoins: [“bonus”]
DependentCoinID: “purple”
Tiers: [
UsageAmount: 0, Amount: 0
UsageAmount: 100, Amount: 5
UsageAmount: 1000, Percent: 10.0
]

🚧

制約

• Amount または Percent を指定する必要があります。両方を指定した場合、Amount が使用されます。少なくとも1つの階層を構成する必要があり、最初の階層の使用額はゼロから開始する必要があります。

• TieredDependent modifier を使用してイベントを構成する場合、TieredDependent modifier はイベントで実行される最初の modifier であってはなりません。これにより、modifier が実行されたときに変更の金額は常にゼロになります。

TieredTime

TieredTime modifier は、トランザクションが発生する時間に基づいて、転送するコインの数を計算します。Tiered modifier と同様、TieredTime modifier は一連の階層で構成され、それぞれ、転送する元のトランザクションの金額の固定額または割合を定義します。この modifier は、ユーザーが 1 日の特定の時間にトランザクションを実行するよう推奨するのに役立ちます (タイムキャンペーン)。

プロパティ

TieredTime modifier は、Basic modifier のプロパティを継承します。Tiered modifier と同様、階層のリストを定義するプロパティがあります。

各階層には次のプロパティがあります。

Time は、構成されている階層の開始点を示すトランザクション時間です。Time から次の階層化された時間までの間に実行されたトランザクションによって、この Balance modifier が階層の指定の構成を使用して実行されます。

📘

例

自分のコインエコノミーで、17:00 ～ 20:00 の間にトランザクションを実行した消費者に対するボーナスコインの支払額を増やし、この時間帯での支出を促進したい。

元の取引金額: 100
トランザクションの時間: 19:06:21
使用したコイン: 100
ボーナスの割合: 10
受け取ったボーナスコイン: 10

設定:
DecreaseTarget: “issuer”
IncreaseTarget: “consumer”
AvailableCoins: [“bonus”]
Tiers: [
Time:00:00:00, Percent:0.0
Time:17:00:00, Percent:10.0
Time:20:00:00, Percent:1.0
]

🚧

制約

• Amount または Percent を指定する必要があります。両方を指定した場合、Amount が使用されます。
• 少なくとも 1 つの階層を構成する必要があり、最初の階層の使用額は深夜 (00:00:00) に開始する必要があります。

Priority Spend

Priority Spend modifierは、イベント実行時に、設定されている優先順位に基づいて消費するコインを計算します。
##プロパティ
Priority Spend modifierは、Basic balance modifierのプロパティを継承します。 追加で構成されるプロパティーはありません。
##ユーゼジ
/transactionsエンドポイントのリクエストパラメータmiscを使用し、優先順位を指定します。通常、miscはコインイベントに追加のコンテキストを追加するために使用されるオプションですが、Priority Spend modifierの場合はmiscを優先順位の設定に利用します。

🚧

制約

設定されたトランザクションの全額が消費されない場合は、エラーが返されます。

設定として、以下のパラメータを持つことができます：

Amount 、Percent の両方を指定した場合、Amount が使用されます。

📘

例

ブルーコインを使用する前に、レッドコインを使いたい。
...
"misc": {
[{
"coin": "red"
},{
"coin": "blue"
}]
}
...

📘

例

ブルーコインを使用する前に、150個のレッドコインを使いたい。
...
"misc": {
[{
"coin": "red",
"amount": "150"
},{
"coin": "blue"
}]
}
...