Pricing tool
Note
In case you are using Dynamic Pricing you should skip this step. You don’t need to set prices on our back-end.
Pricing tool overview
You can access the pricing tool from the payment administration tool. Use the pricing tool to set up price packages for a game or application. You can configure global prices applicable to all countries, or define specific pricing configurations on a per-country basis.
The basic details you need to define a price package are:
- Package price;
- SKU type and amount included in the specified package.
Pre-requisites
Before you start setting up prices and packages in the pricing tool, make sure you have the following assets:
- SKU thumbnails/images for each price package;
- SKU thumbnails/images for the SKU selection tab header on the payment selection screen.
SKU images for the price packages
Each price package needs to be associated to a SKU image that represents it visually on the payment selection screen.
Usually, we define 6 price packages for each different SKU type.
The table below sums up the asset requirements for these SKU images:
| Type | Size | Format | Example |
|---|---|---|---|
| Price packageSKU image | 90×45 px7 KB max. | PNG (transparent) |  |
SKU images for the tab headers
If your game or application offers more than one SKU type, users can select the desired SKU type on the payment selection screen by clicking the corresponding SKU type tab. As a tab header we use another, smaller SKU type image.
We use these images only when you implement multiple SKU types in your game or application. If you offer only one SKU type, there are no tabs on the payment selection screen.
The table below sums up the asset requirements for these SKU images:
| Type | Size | Format | Example |
|---|---|---|---|
| Tab headerSKU image | 30×25 px7KB max. | PNG (transparent) |  |
Access the pricing tool
- Login to the payment administration tool with the credentials you received from Spil Games. If you do not have the necessary details, contact our Integration support team.
- Go to the pricing tool by selecting the following menu option: Packages & Promotions | Packages, as shown in the screen shot below:
Game and SKU combination
In the pricing tool:
- Select a game from the corresponding drop-down menu, then
- Select the SKU type(s) associated with it;
- Click Load.
After making your game and SKU selections, the country overview is available.
Countries with no price package setup are represented by buttons with a white background color:
When you set price packages for a country, the corresponding button background color changes to notify that pricing for that country is active:
Price package setup
The default option for country selection is All other countries, whereas the default currency for prices is set to Euros.
You can manually configure each price package by entering the appropriate values in the corresponding input fields:
| Option | Type | Description |
|---|---|---|
| Pre-sel. | drop-down menu | It allows you to set the default pre-selected pricing package that is highlighted on the payment selection screen. |
| Price | numeric input |
It allows you to set the payable amount per package. Regardless the selected currency, insert the desired payable amount per package in cents.Examples:
|
| SKU | numeric input | It allows you to set the amount of SKU per package that a player can buy.Example:You can set a SKU package of 450 “shiny diamonds” (the SKU type name in this example) that users can purchase for EUR 2.50 — This is the payable amount they pay for the specified package. |
| Interval | drop-down menu | Use this option if you have active, or want to enable, subscriptions.When you set up a time-bound subscription for users to purchase for example special items, or discounted packages in your game or application, make a selection from this drop-down menu to define when it is due to expire. |
| Discount | integer | It allows you to set a specific discount rate per each package.The integer you enter defines the discount percentage you want to apply to the package.If you set discounts here, these values override the Discount rate for larger packages described further on in this document. |
| External ID | alphanumeric input | You can assign alphanumeric values to the External ID parameter.You can use the externalId parameter as an additional identifier, for example to validate or track a price package.The value assigned to External ID in the pricing tool is returned by the payment callback as part of the custom_parameters field:&externalId=<alphanumeric_value>. |
| Type | drop-down menu |
It allows you to define the price package type. There are 4 package types:
Normal is the default package selection. This is the package type that is used in most cases. If you are not sure about they package type you want to make available in your game or application, choose Normal. Premium packages are not based on a set SKU amount; they can be time-bound (i.e. they are available only during a specified period of time) or based on bundle packages combining multiple items. Subscription and Vip: if you are interested in these package types, contact the Integration support team to learn more. |
Mobile tariffs and default prices
When you click a country button, a pane is displayed with three sections:
- Mobile Tariffs,
- Default Prices, and
- Currency.
- Mobile Tariffs
- The recommended prices for each country.
- The amounts correspond to the mobile tariffs in use by the payment provider in the selected country.
- When you set up your price packages for SMS/mobile payments, we recommend applying these default prices or a pricing scheme that is similar to the suggested one.
- Mobile tariffs are displayed also in a drop-down menu when you double-click a price point under the Price column:
- Default Prices
- A list with the default, preset prices in the pricing tool.
- Currency
- Here you can find basic information about the currency in use in the selected country:
-
- The currency code;
- The currency to Euro ratio;
- The currency exponent to indicate whether the major currency has a minor currency
-
- (for example Euro and Euro cents, or Dollar and Dollar cents), and their relationship (usually, 1/100).
- For example, USD has exponent 2, meaning that it has a minor currency (cents), and that their relationship is 1/100.
SKU to Euro ratio and discounts
The Ratio SKU to EURO option offers a quick way to configure all six price packages at the same time:
- In the Ratio SKU to EURO input field, enter an integer.
- This integer value sets the SKU to Euro ratio, which corresponds to the amount of SKUs credited to the buyer for each Euro they spend.
For example, if you set Ratio SKU to EURO to 100, for each Euro players spend they are credited with 100 SKU units.
The Discount rate for larger packages option offers a quick way to apply a standard discount rate to the larger packages on offer:
- In the Discount rate for larger packages input field, enter an integer.
- This integer value sets the price percentage you are taking off the package price.
For example, if you set Discount rate for larger packages to 10, you apply a 10% discount to the larger SKU packages on offer.
When you apply a discount rate to either the larger packages only, or separately to all packages in the Discount column described earlier in this document, the discount rate does not reduce the buying price; instead, it increases the SKU amount users can buy for the same price.
Best value
The Best value option is a drop-down menu. It allows you to set the most convenient package on offer. When you set a best value package, the selected package is highlighted with a visual marker on the payment selection screen.
If you have also set discounts for the packages, a numeric value in a red ribbon notifies buyers about the amount of extra SKUs they can get for the price they would normally pay for the non-discounted package.
SKU Image
You can either send the necessary SKU images to Spil Games to be hosted by us, or you can host them on any publicly accessible server (recommended).
- In the input fields under SKU Image, enter the complete URL pointing to the SKU image.
- Insert one image link per each price package on offer.
- If the link points to an existing and publicly accessible image, when you exit a populated input field a preview of the corresponding image is generated.
See SKU images for the price packages earlier in this document to learn about the SKU image requirements.
Overview and save
When you are done with the previous task, click Save to save your package configuration.
If you wish, you can click Overview to generate a table with an overview of all active price packages for all selected countries.
When you save a package configuration, the pricing tool carries out a basic validation procedure on the input fields. This validation includes checks on:
- Empty fields and values (not allowed);
- Duplicate values for prices or SKU amounts (not allowed).