Set up and sell DLCs
Last updated on November 6, 2023
Overview
In-app Purchase integration enables you to sync player purchases from third-party platforms such as PlayStation or Xbox to AccelByte Gaming Services (AGS). In order to achieve this, items sold on a third-party platform need to be correctly mapped to items created in AGS. This guide focuses on how to map durable items in AGS to items defined on third-party platforms.
Goals
- Explain and guide users to configure DLCs in AGS manually or using JSON file
- Guide user to add DLC mappings for third-party platforms manually or using JSON file
Prerequisites
- Items are properly configured on a third-party platform
- Corresponding items are created in the AGS Store
Configure DLCs in AGS
Add DLC
If you would like to sell DLCs on a third-party platform (Epic, Steam, Xbox, PlayStation), after creating the DLCs on a third-party platform, you will also need to add DLCs on the Admin Portal.
- Go to E-Commerce section, find the In-App Purchase section and click DLC Settings. Under ‘DLC Configuration’ tab, click ‘Add DLC’ button and a pop-up window will be displayed.
- On the pop-up window:
- Fill in ‘DLC ID’
- Choose a ‘Reward Type’ (Item/Currency)
- Choose an ‘Item Identity’ (SKU/ID) and search an item by using an item name,
- Input ‘Item Type’ (COINS, INGAMEITEM, BUNDLE, CODE, SEASON, MEDIA)
- Input Quantity
- Click ‘Add’ button to save
Add DLC (JSON format)
- If you would like to add JSON file instead of adding items manually each by each, you can click ‘Add JSON’ button. A JSON template will be displayed in the next screen and you can follow the template to configure your JSON file
- If there is an existing DLC configured already, you may also Edit/Delete the JSON file.
Map DLCs in AGS to third-party platforms
Add DLC Mapping
- After DLC Configuration is completed, you can move to the DLC Mapping tab to map the DLC you created on AccelByte to the corresponding DLCs on each of the third-party platforms.
- Click ‘Add Mapping’ button under a desired third-party platform.
- Fill in the required fields 8. third-party Platform Item ID 9. DLC ID - This is the ID you created in the 2nd Step
Add DLC Mapping (JSON format)
- Click ‘Add JSON’ to add a JSON file instead of adding DLC mapping manually. Follow the templates in the next screen to configure your JSON file