Импорт и экспорт покупок

Система импорта и экспорта позволяет быстро добавлять, обновлять и переносить данные о покупках между различными платформами и вашей панелью управления.

---

Содержание

1. Быстрый старт: Импорт по нашему CSV шаблону
2. Обновление существующих покупок
3. Импорт из Яндекс Игр
4. Импорт из любого CSV
5. Экспорт покупок
6. Часто задаваемые вопросы

---

Быстрый старт: Импорт по нашему CSV шаблону

Самый простой способ начать работу с импортом - использовать наш готовый CSV шаблон.

Шаг 1: Экспортируйте шаблон CSV

1. Откройте раздел "Покупки" в вашем проекте

2. Нажмите кнопку "Экспортировать в CSV/JSON"

   

3. В открывшемся окне:

   • Убедитесь, что выбраны все поля
   • Выберите формат "CSV Таблица"
   • Нажмите "Экспортировать"

   

4. Файл products.csv будет скачан на ваш компьютер

Шаг 2: Заполните CSV файл

1. Откройте скачанный файл в Excel, Google Sheets или любом табличном редакторе

2. Заполните строки согласно названиям колонок:

   • id - оставьте пустым для новых покупок
   • tag - уникальный человекочитаемый идентификатор (например, GOLD_1000)
   • names.en - название на английском
   • names.ru - название на русском
   • descriptions.en - описание на английском
   • descriptions.ru - описание на русском
   • prices.YANDEX - цена для Яндекс Игр
   • prices.НАЗВАНИЕ_ПЛОЩАДКИ - цена для нужной площадки
   • realPrices.RUB - цена в настоящей валюте - рублях
   • realPrices.ВАЛЮТА - цена в настоящей валюте - по коду валюты
   • И другие поля...

3. Сохраните файл в формате CSV

tip

Для новых покупок оставляйте поле id пустым. Система автоматически создаст новую запись.

Шаг 3: Загрузите CSV в панель управления

1. Нажмите кнопку "Импортировать из CSV"

2. Перетащите CSV файл в область загрузки или нажмите для выбора файла

3. Система автоматически распознает формат "Наш CSV шаблон"

Шаг 4: Проверьте данные и импортируйте

1. Просмотрите таблицу с данными:

   • Зеленые строки - новые покупки, которые будут добавлены
   • Ячейки с зеленой чертой слева - измененные значения
   • Красные ячейки - ошибки валидации (исправьте перед импортом)

   

2. При необходимости отредактируйте данные прямо в таблице (клик по ячейке)

3. Убедитесь, что нет ошибок (красных ячеек)

4. Нажмите "Импортировать"

5. Готово! Покупки добавлены в ваш проект

---

Обновление существующих покупок

Если вам нужно обновить уже существующие покупки, следуйте этой инструкции.

Способ 1: Через экспорт и импорт (рекомендуется)

1. Экспортируйте текущий список покупок:

   • Нажмите "Экспортировать в CSV/JSON"
   • Выберите формат "CSV Таблица"
   • Скачайте файл

   

2. Внесите изменения в CSV файл:

   • Откройте файл в табличном редакторе
   • Измените нужные значения в существующих строках
   • Можете также добавить новые строки для новых покупок
   • Не удаляйте колонку id - она используется для сопоставления

3. Загрузите обновленный CSV:

   • Нажмите "Импортировать из CSV"
   • Загрузите измененный файл
   • Система автоматически определит существующие покупки по полю id

4. Проверьте изменения:

   • Ячейки с зеленой полосой слева показывают, какие значения будут изменены
   • Зеленые строки - новые покупки
   • Убедитесь, что всё корректно

   

5. Нажмите "Импортировать"

Способ 2: Использование своего CSV

Если у вас есть свой CSV файл без поля id, вы можете выбрать другое поле для сопоставления:

1. Загрузите ваш CSV файл

   • Если у вас есть уникальный идентификатор покупки, поместите его как tag.

   

2. Выберите поле для сопоставления:

   • В разделе "Сопоставлять записи по полю" выберите:
     • tag - если у вас есть уникальные теги
     • yandexId - если у вас ID из Яндекс Игр
     • Или любое другое уникальное поле

   

3. Система найдет существующие покупки и обновит их

tip

• При обновлении изменяются только те поля, которые указаны в вашем CSV
• Остальные поля остаются без изменений

---

Импорт из Яндекс Игр

Импортируйте покупки напрямую из экспорта Яндекс Игр.

Шаг 1: Скачайте CSV из Яндекс Игр

1. Откройте консоль разработчика Яндекс Игр

2. Перейдите в раздел "Инап-покупки"

3. Нажмите три точки справа от кнопки "Загрузить CSV-файл", нажмите "Скачать таблицу инапов"

   

Шаг 2: Загрузите CSV в нашу панель

1. Нажмите "Импортировать из CSV" в разделе покупок
2. Загрузите скачанный CSV файл
3. Система автоматически определит формат CSV Яндекс Игр и настроит сопоставление полей

Шаг 3: Настройте сопоставление (опционально)

Для удобства работы с новыми покупками вы можете:

1. Добавить сопоставление ID → Tag:

   • Нажмите "Настроить поля"
   • Найдите строку с id → (пусто)
   • Выберите целевое поле tag
   • Это автоматически присвоит тег новым покупкам

   

Шаг 4: Выберите ключ сопоставления

Для первого импорта (новые покупки):

• Оставьте ключ по умолчанию или выберите любой, например yandexId
• Все записи будут добавлены как новые

Для обновления существующих покупок:

1. В поле "Сопоставлять записи по полю" выберите yandexId

2. Система найдет существующие покупки по их Yandex ID и обновит данные

   

Шаг 5: Проверьте и импортируйте

1. Проверьте предпросмотр данных

2. Убедитесь, что сопоставление корректное

3. Нажмите "Импортировать"

   

tip

При обновлении цен из Яндекс Игр используйте yandexId для сопоставления, чтобы не создавать дубликаты.

---

Импорт из любого CSV

Импортируйте покупки из любого CSV файла с гибкой настройкой полей.

Когда использовать этот способ?

• У вас есть CSV из другой платформы (не Яндекс Игры)
• Названия колонок в вашем CSV отличаются от наших
• Вам нужно сопоставить одно поле с несколькими целевыми полями

Шаг 1: Загрузите ваш CSV файл

1. Нажмите "Импортировать из CSV"
2. Загрузите ваш CSV файл

Шаг 2: Система автоматически создаст список полей

Если система не распознала формат автоматически, она:

• Создаст список всех колонок из вашего CSV
• Попытается автоматически сопоставить похожие поля
• Покажет примеры значений из первой строки

Шаг 3: Настройте сопоставление полей

Для каждого поля из CSV выберите, куда его импортировать:

Пример 1: Простое сопоставление

CSV поле: product_name  →  Целевое поле: names.en
CSV поле: price         →  Целевое поле: realPrices.RUB

tip

Под названием поля вашего CSV показывается пример для удобного ориентирования. Название товара, цена и т.п.

Пример 2: Сопоставление цен

Например, вашем CSV есть поле price_rub с ценой в рублях, вы можете импортировать его в:

• prices.YANDEX - если продаете на Яндекс.Играх

• prices.VK_PLAY - если продаете в VK Play

• realPrices.RUB - реальная цена в рублях (для Xsolla, Robokassa, Stripe, Google Play и других площадок)

• Или сразу во все эти поля (создав несколько маппингов для одного поля CSV)

  

Шаг 4: Проверьте и импортируйте

1. Нажмите "Продолжить к предпросмотру"
2. Проверьте данные в таблице
3. Убедитесь, что всё сопоставлено корректно
4. Нажмите "Импортировать"

---

Экспорт покупок

Экспортируйте покупки в различных форматах для использования на других платформах.

Доступные форматы экспорта

1. CSV Таблица - универсальный формат для Excel, Google Sheets
2. JSON Массив - для разработчиков и программной обработки
3. JSON Объект - объект с ключами-значениями
4. Xsolla JSON - готовый формат для загрузки в Xsolla
5. Яндекс Игры CSV - готовый формат для загрузки в Яндекс Игры

Экспорт в CSV

1. Нажмите "Экспортировать в CSV/JSON"

2. Выберите нужные поля (по умолчанию выбраны все)

3. Выберите формат "CSV Таблица"

4. Нажмите "Экспортировать"

   

Экспорт в JSON

1. Нажмите "Экспортировать в CSV/JSON"

2. Выберите нужные поля

3. Выберите формат:

   • JSON Массив - простой массив объектов
   • JSON Объект - объект с ключами (нужно выбрать ключевое поле)

4. Настройте опции:

   • ☑️ Сжатый JSON - однострочный формат (меньше размер)
   • ☐ Сжатый JSON - читаемый формат с отступами

5. Нажмите "Экспортировать"

   

Экспорт в формат Xsolla

Специальный формат для прямой загрузки в платформу Xsolla.

1. Нажмите "Экспортировать в CSV/JSON"
2. Выберите формат "Xsolla JSON"
3. Нажмите "Экспортировать"

Система автоматически:

• Использует xsollaId или tag как SKU товара
• Преобразует все названия и описания в объекты с языками
• Конвертирует цены в нужный формат с указанием валюты
• Добавляет обязательные поля Xsolla API

Полученный JSON можно напрямую загрузить в Xsolla.

Экспорт в формат Яндекс Игр (CSV)

Специальный формат CSV для загрузки покупок в консоль разработчика Яндекс Игр.

1. Нажмите "Экспортировать в CSV/JSON"
2. Выберите формат "Яндекс Игры CSV"
3. Нажмите "Экспортировать"

Система автоматически:

• Использует правильные названия колонок для Яндекс Игр
• Преобразует цены в формат, ожидаемый платформой
• Добавляет все необходимые поля для корректного импорта
• Форматирует данные согласно требованиям Яндекс Игр

Полученный CSV файл можно напрямую загрузить в консоль разработчика Яндекс Игр через раздел "Инап-покупки" → "Загрузить CSV-файл".

---

Часто задаваемые вопросы

Что делать, если в CSV есть ошибки?

Красные ячейки показывают ошибки валидации. Наведите курсор на ячейку, чтобы увидеть описание ошибки. Кликните по ячейке, чтобы исправить значение прямо в таблице.

Можно ли изменять данные прямо в таблице предпросмотра?

Да! Просто кликните по любой ячейке, измените значение и нажмите Enter или кликните вне ячейки.

Как не создать дубликаты при импорте?

Используйте правильное поле для сопоставления:

• id - для обновления через наш экспорт
• tag - если у вас есть уникальные теги
• yandexId - для покупок из Яндекс Игр
• xsollaId - для покупок из Xsolla

Можно ли импортировать только некоторые поля?

Да! При импорте обновляются только те поля, которые есть в вашем CSV. Остальные поля остаются без изменений.

Что делать, если система не распознала мой CSV?

1. Проверьте, что файл в кодировке UTF-8
2. Убедитесь, что первая строка содержит заголовки колонок
3. Используйте режим "Кастомный маппинг" для ручной настройки полей

Как добавить новое поле в существующие покупки?

1. Экспортируйте текущие покупки в CSV
2. Добавьте новую колонку с нужным значением
3. Импортируйте CSV обратно
4. Система обновит все покупки, добавив новое поле

Можно ли отменить импорт?

Нет, импорт применяется сразу. Рекомендуем:

1. Всегда проверять предпросмотр перед импортом
2. Делать экспорт текущих данных перед большими изменениями
3. Начинать с тестового импорта на небольшом количестве записей

---

💡 Полезные советы

Работа с большими файлами

• Для файлов более 100 записей используйте предпросмотр, чтобы убедиться в корректности первых строк
• Проверьте статистику импорта (сколько новых, измененных, ошибок)

Многоязычность

• Используйте поля names.en, names.ru, names.fr и т.д. для разных языков
• То же самое для описаний: descriptions.en, descriptions.ru и т.д.

Цены на разных платформах

• prices.YANDEX - цена для Яндекс.Игры
• prices.VK_PLAY - цена для VK Play
• prices.GOOGLE_PLAY - цена для Google Play
• realPrices.RUB, realPrices.USD - цены в настоящих валютах

Оставайтесь на связи

С другими разделами документации вы можете ознакомиться здесь. Для начала работы вы можете ознакомиться с нашими туториалами.

Сообщество GamePush в Telegram: @gs_community.

Для ваших обращений e-mail: official@gamepush.com

Желаем вам успехов!