Add a product in shop

This page describes the first step to configure an AI in-game shop offer using the Tentuplay console.

Assumptions

The AI in-game shop needs a product information file to make its offer work. All the subsequent offer settings are based on this product information. Thus, what you must do first when configuring an AI in-game shop offer is to add a product information in shop. It’s like a product listing on an online shop.

What is a product information file?

A product information file is a delimited text file with "csv" extension that contains the details of products that you want to expose in AI offers.

You can download the sample file in the TentuPlay console.

  1. Click AI In-Game Shop > Shop Operation > Setting/Management > Upload Information tab in the console.

  2. Click DOWNLOAD in the "This is an example file" row to download the sample.csv.

Let’s look at what’s inside in the sample.csv file.

sample csv
sample.csv

The header elements in the first row denotes the attributes that consist of each product information.

Name Description Required

purchasable_slug

The name of the item being sold

This value is recorded within TentuPlay’s event methods and must be the same as the unique slug used in game.

required

store

The alias of app store

This can be any name as long as you can identify it as an app store name (for example, android, ios, google, apple, appstore, playstore)

required

product_index

The unique index of a promotion or a product that is used by the game developer

optional

start_datetime

The beginning date and time of a promotion or an item’s sale

optional

end_datetime

The ending date and time of a promotion or an item’s sale

optional

purchase_link

Enter Roblox Developer Product ID

Both web links and deep links are allowed

required

  • If you want to make a field null, leave the cell blank.

  • For start_datetime and end_datetime

    • If there is no time limit to the promotion or sale, you can leave these values empty or set the start_datetime to a date far in the past (for example, 1970-01-01).

    • The standard used for start_datetime and end_datetime is ISO 8601. Keep this in mind when implementing time zones. (for example, 2021-09-23 19:30+09:00)

Upload a product information file

You can add a product in AI in-game shop by uploading a product information file to the TentuPlay server.

  1. Create a new product information file populated with your own records by consulting the sample.csv file.

  2. Click AI In-Game Shop > Shop Operation > Setting/Management > Upload Information tab in the console.

  3. Click UPLOAD FILE, select the newly created csv file, and click Open to upload the file.

    a3
    The file has been successfully uploaded

  • After a successful upload, you can download the product information file at any time to check whether its content and format are correct.

  • If you have something to change in the uploaded product information file, upload the updated file again. The previously uploaded product information file will be replaced with the new one.