Import and Export Purchases
The import and export system allows you to quickly add, update, and transfer purchase data between various platforms and your control panel.
Table of Contents
- Quick Start: Import Using Our CSV Template
- Updating Existing Purchases
- Import from Yandex Games
- Import from Any CSV
- Export Purchases
- Frequently Asked Questions
Quick Start: Import Using Our CSV Template
The easiest way to get started with importing is to use our ready-made CSV template.
Step 1: Export CSV Template
Open the "Purchases" section in your project
Click the "Export to CSV/JSON" button
In the opened window:
- Make sure all fields are selected
- Select the "CSV Table" format
- Click "Export"
The
products.csv
file will be downloaded to your computer
Step 2: Fill in the CSV File
Open the downloaded file in Excel, Google Sheets, or any spreadsheet editor
Fill in the rows according to column names:
- id - leave empty for new purchases
- tag - unique human-readable identifier (e.g.,
GOLD_1000
) - names.en - name in English
- names.ru - name in Russian
- descriptions.en - description in English
- descriptions.ru - description in Russian
- prices.YANDEX - price for Yandex Games
- prices.PLATFORM_NAME - price for the desired platform
- realPrices.RUB - price in real currency - rubles
- realPrices.CURRENCY - price in real currency - by currency code
- And other fields...
Save the file in CSV format
For new purchases, leave the id
field empty. The system will automatically create a new record.
Step 3: Upload CSV to Control Panel
Click the "Import from CSV" button
Drag the CSV file into the upload area or click to select file
The system will automatically recognize the "Our CSV Template" format
Step 4: Check Data and Import
Review the data table:
- Green rows - new purchases that will be added
- Cells with green line on the left - changed values
- Red cells - validation errors (fix before importing)
If necessary, edit the data directly in the table (click on cell)
Make sure there are no errors (red cells)
Click "Import"
Done! Purchases have been added to your project
Updating Existing Purchases
If you need to update already existing purchases, follow these instructions.
Method 1: Through Export and Import (recommended)
Export current purchase list:
- Click "Export to CSV/JSON"
- Select the "CSV Table" format
- Download the file
Make changes to the CSV file:
- Open the file in a spreadsheet editor
- Change the desired values in existing rows
- You can also add new rows for new purchases
- Do not delete the
id
column - it is used for matching
Upload the updated CSV:
- Click "Import from CSV"
- Upload the modified file
- The system will automatically identify existing purchases by the
id
field
Check the changes:
- Cells with a green stripe on the left show which values will be changed
- Green rows - new purchases
- Make sure everything is correct
Click "Import"
Method 2: Using Your Own CSV
If you have your own CSV file without an id
field, you can select another field for matching:
Upload your CSV file
- If you have a unique purchase identifier, place it as tag.
Select field for matching:
- In the "Match records by field" section, select:
- tag - if you have unique tags
- yandexId - if you have IDs from Yandex Games
- Or any other unique field
- In the "Match records by field" section, select:
The system will find existing purchases and update them
- When updating, only the fields specified in your CSV are changed
- Other fields remain unchanged
Import from Yandex Games
Import purchases directly from Yandex Games export.
Step 1: Download CSV from Yandex Games
Open the Yandex Games developer console
Go to the "In-app purchases" section
Click the three dots to the right of the "Upload CSV file" button, click "Download in-apps table"
Step 2: Upload CSV to Our Panel
- Click "Import from CSV" in the purchases section
- Upload the downloaded CSV file
- The system will automatically detect the Yandex Games CSV format and configure field mapping
Step 3: Configure Mapping (optional)
For convenience when working with new purchases, you can:
Add ID → Tag mapping:
- Click "Configure fields"
- Find the row with
id
→ (empty) - Select target field
tag
- This will automatically assign tags to new purchases
Step 4: Select Matching Key
For first import (new purchases):
- Leave the default key or select any, for example yandexId
- All records will be added as new
For updating existing purchases:
In the "Match records by field" field, select
yandexId
The system will find existing purchases by their Yandex ID and update the data
Step 5: Check and Import
Check the data preview
Make sure the mapping is correct
Click "Import"
When updating prices from Yandex Games, use yandexId
for matching to avoid creating duplicates.
Import from Any CSV
Import purchases from any CSV file with flexible field configuration.
When to use this method?
- You have a CSV from another platform (not Yandex Games)
- Column names in your CSV differ from ours
- You need to map one field to multiple target fields
Step 1: Upload Your CSV File
- Click "Import from CSV"
- Upload your CSV file
Step 2: System Will Automatically Create Field List
If the system did not recognize the format automatically, it will:
- Create a list of all columns from your CSV
- Try to automatically match similar fields
- Show examples of values from the first row
Step 3: Configure Field Mapping
For each field from CSV, select where to import it:
Example 1: Simple Mapping
CSV field: product_name → Target field: names.en
CSV field: price → Target field: realPrices.RUB
Below the name of your CSV field, an example is shown for easy orientation. Product name, price, etc.
Example 2: Price Mapping
For example, your CSV has a price_rub
field with price in rubles, you can import it to:
prices.YANDEX
- if selling on Yandex Gamesprices.VK_PLAY
- if selling on VK PlayrealPrices.RUB
- real price in rubles (for Xsolla, Robokassa, Stripe, Google Play and other platforms)Or all of these fields at once (by creating multiple mappings for one CSV field)
Step 4: Check and Import
- Click "Continue to preview"
- Check the data in the table
- Make sure everything is mapped correctly
- Click "Import"
Export Purchases
Export purchases in various formats for use on other platforms.
Available Export Formats
- CSV Table - universal format for Excel, Google Sheets
- JSON Array - for developers and programmatic processing
- JSON Object - object with key-value pairs
- Xsolla JSON - ready format for uploading to Xsolla
- Yandex Games CSV - ready format for uploading to Yandex Games
Export to CSV
Click "Export to CSV/JSON"
Select desired fields (all selected by default)
Select the "CSV Table" format
Click "Export"
Export to JSON
Click "Export to CSV/JSON"
Select desired fields
Select format:
- JSON Array - simple array of objects
- JSON Object - object with keys (need to select key field)
Configure options:
- ☑️ Compressed JSON - single-line format (smaller size)
- ☐ Compressed JSON - readable format with indentation
Click "Export"
Export to Xsolla Format
Special format for direct upload to Xsolla platform.
- Click "Export to CSV/JSON"
- Select the "Xsolla JSON" format
- Click "Export"
The system automatically:
- Uses
xsollaId
ortag
as product SKU - Converts all names and descriptions into objects with languages
- Converts prices to the required format with currency specification
- Adds required Xsolla API fields
The resulting JSON can be directly uploaded to Xsolla.
Export to Yandex Games Format (CSV)
Special CSV format for uploading purchases to Yandex Games developer console.
- Click "Export to CSV/JSON"
- Select the "Yandex Games CSV" format
- Click "Export"
The system automatically:
- Uses correct column names for Yandex Games
- Converts prices to the format expected by the platform
- Adds all necessary fields for correct import
- Formats data according to Yandex Games requirements
The resulting CSV file can be directly uploaded to Yandex Games developer console through the "In-app purchases" → "Upload CSV file" section.
Frequently Asked Questions
What to do if there are errors in the CSV?
Red cells show validation errors. Hover over the cell to see the error description. Click on the cell to fix the value directly in the table.
Can I change data directly in the preview table?
Yes! Just click on any cell, change the value and press Enter or click outside the cell.
How to avoid creating duplicates when importing?
Use the correct field for matching:
- id - for updating through our export
- tag - if you have unique tags
- yandexId - for purchases from Yandex Games
- xsollaId - for purchases from Xsolla
Can I import only some fields?
Yes! When importing, only the fields that are in your CSV are updated. Other fields remain unchanged.
What to do if the system did not recognize my CSV?
- Check that the file is in UTF-8 encoding
- Make sure the first row contains column headers
- Use the "Custom mapping" mode for manual field configuration
How to add a new field to existing purchases?
- Export current purchases to CSV
- Add a new column with the desired value
- Import the CSV back
- The system will update all purchases, adding the new field
Can I cancel an import?
No, the import is applied immediately. We recommend:
- Always check the preview before importing
- Make an export of current data before large changes
- Start with a test import on a small number of records
💡 Useful Tips
Working with Large Files
- For files with more than 100 records, use preview to ensure the first rows are correct
- Check the import statistics (how many new, changed, errors)
Multilingualism
- Use fields
names.en
,names.ru
,names.fr
, etc. for different languages - Same for descriptions:
descriptions.en
,descriptions.ru
, etc.
Prices on Different Platforms
prices.YANDEX
- price for Yandex Gamesprices.VK_PLAY
- price for VK Playprices.GOOGLE_PLAY
- price for Google PlayrealPrices.RUB
,realPrices.USD
- prices in real currencies
Stay in Touch
Other documents of this chapter available Here. To get started, welcome to the Tutorials chapter.
GamePush Community Telegram
: @gs_community.
For your suggestions e-mail
: official@gamepush.com
We Wish you Success!