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.
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:
|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:
|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:
|Pre-sel.||drop-down menu||It allows you to set the default pre-selected pricing package that is highlighted on theÂ payment selection screen.|
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>.|
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
- 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.
- 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.
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.
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).