Внедрение продуктов IAP

Unity рекомендует добавлять продукты IAP и управлять ими в консоли UDP. Каталог IAP в консоли UDP – это источник достоверной информации, отправляемой на внутренние системы магазина. Кроме того, консоль UDP позволяет:

• Управление несколькими ценами и валютами IAP
• Добавить описания на нескольких языках
• Групповая загрузка элементов через CSV-файл (поддерживается несколько валют и языков)

Примечание. Если вы используете только пакет UDP, вам все равно следует создать хотя бы один элемент IAP в редакторе Unity, чтобы проверить, правильно ли он синхронизируется с консолью UDP. Если вы используете IAP Unityсокращение от Unity In App Purchase
См. в пакете Словарь (реализация без кода), необходимо добавить каждый элемент IAP в Редактор Unity и загрузите их все в консоль UDP. Если вы используете пакет IAP Unity и реализовали IAP в коде, создайте элементы IAP в консоли UDP.

Если вы поддерживаете IAP-каталог в своем игровом клиенте, UDP обеспечивает его синхронизацию между редактором Unity и консолью UDP.

Управление покупками в приложении на консоли UDP

В консоли UDP перейдите к своей игре на странице "Мои игры". На странице информации об игре нажмите кнопку EDIT INFO, чтобы войти в режим редактирования. Чтобы сохранить изменения, выберите СОХРАНИТЬ. Чтобы отменить изменения, выберите ОТМЕНА. В этом разделе рассказывается, как редактировать, создавать и удалять продукты IAP из консоли UDP.

Создание новых элементов IAP

Чтобы создать новые элементы IAP в консоли UDP:

1. Выберите ИЗМЕНИТЬ ИНФОРМАЦИЮ на странице информации об игре.
2. Выберите Добавить элемент, чтобы создать новый элемент.
3. Укажите и сохраните информацию о продукте.
   1. Следуйте требованиям к идентификаторам продуктов, чтобы убедиться, что они действительны для магазинов приложений.
   2. Убедитесь, что продукты IAP, которые вы определяете в своей игре, используют тот же идентификатор продукта, который установлен в каталоге IAP.
4. Выберите Управление суммами и валютами, чтобы:
   1. Конвертировать цену IAP из долларов США в иностранную валюту.
   2. Скорректируйте цены в этих валютах.
5. Нажмите СОХРАНИТЬ, чтобы сохранить изменения.

Примечание. Если вам нужно создать много элементов IAP, рассмотрите возможность использования функции Массовый импорт IAP, чтобы создать сразу все элементы IAP, включая локализованное описание и цены в нескольких валютах.

При использовании пакета UDP любые новые элементы IAP, которые вы добавляете в консоль, синхронизируются с вашим проектом Unity. Вам не нужно перестраивать игру, чтобы включить их.

Редактирование описаний IAP

Чтобы изменить описания IAP, выполните следующие действия.

1. Выберите ИЗМЕНИТЬ ИНФОРМАЦИЮ на странице информации об игре.
2. Выберите язык, для которого вы хотите изменить описание, с помощью раскрывающегося списка языков.
3. В разделе «Покупки в приложении» выберите значок карандаша, чтобы изменить существующий элемент IAP.
4. Измените информацию об элементе IAP:
   1. Название продукта, название элемента IAP
   2. Описание, чтобы кратко описать элемент IAP
5. Нажмите СОХРАНИТЬ, чтобы сохранить изменения.

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

Редактирование цен и валют IAP

1. Выберите ИЗМЕНИТЬ ИНФОРМАЦИЮ на странице информации об игре.
2. Выберите Управление суммами и валютами для элемента IAP, чтобы:
   1. Изменить цену IAP.
   2. Конвертировать доллары США в иностранную валюту.
   3. Скорректируйте цены в этих валютах.
3. Нажмите СОХРАНИТЬ, чтобы сохранить изменения.

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

Примечание. Если у вас есть много элементов IAP и валют для поддержки, вы можете использовать функцию Конвертировать для автоматического преобразования всех ваших цен IAP в глобальные валюты на основе Сумма в долларах США, установленная для каждого элемента IAP. Это переопределяет любые местные цены, которые вы установили ранее.

В качестве альтернативы можно использовать Массовый импорт IAP, чтобы импортировать всю эту информацию одновременно.

Удаление элементов IAP

1. Выберите ИЗМЕНИТЬ ИНФОРМАЦИЮ на странице информации об игре.
2. Нажмите значок корзины, чтобы удалить элемент IAP.
3. Нажмите СОХРАНИТЬ, чтобы сохранить изменения.

Массовый импорт элементов IAP

1. Выберите ИЗМЕНИТЬ ИНФОРМАЦИЮ на странице информации об игре.
2. Выберите ИМПОРТ КАТАЛОГ в правом верхнем углу панели покупок в приложении.
   Полное описание этой функции см. в разделе Массовый импорт IAP.
3. Нажмите СОХРАНИТЬ, чтобы сохранить изменения.

Импорт информации об игре из Google Play

Если вы уже опубликовали свою игру в Google Play, вы можете импортировать основную информацию, используя URL-адрес вашей игры в Google Play:

1. Выберите Импорт из Google Play.
2. Вставьте URL-адрес своей игры в Google Play в поле ввода.
3. Чтобы указать, какой именно язык импортировать, используйте URL-адрес Google Play, содержащий языковой суффикс, например, для итальянского используйте &hl=it.
   Если ваш URL-адрес Google Play не содержит языкового суффикса, UDP извлекает информацию для языка, который вы сейчас редактируете в консоли UDP (если он установлен в Google Play).
4. Выберите Импорт.
5. Перепроверьте результат, так как в некоторых случаях IP-адрес вашего компьютера может в конечном итоге определить, на каком языке вы обслуживаетесь.

Массовый импорт IAP

Функция массового импорта IAP упрощает управление каталогом IAP, если у вас много элементов IAP. Это позволяет загружать CSV-файлы в обычном формате UDP и в формате Google Play в UDP-консоль со всеми сведениями о вашем продукте IAP, включая цены в разных валютах и ​​описания на разных языках.

Unity рекомендует по-прежнему добавлять элемент IAP в редактор Unity в целях тестирования, чтобы убедиться, что вы можете приобрести элемент IAP в тестовой среде.

Примечание. Если ваш CSV-файл содержит несколько языков, добавьте поддерживаемые языки перед импортом CSV-файла.

В этом разделе описывается, как массово импортировать элементы IAP через CSV.

Требования к реализации

Чтобы добавить новые продукты IAP

Вы должны использовать функцию массового импорта IAP для добавления новых продуктов IAP, только если вы реализовали UDP:

• С пакетом UDP
• С помощью Unity IAP (реализация кода)

Unity рекомендует по-прежнему добавлять элемент IAP в редактор Unity в целях тестирования, чтобы убедиться, что вы можете приобрести элемент IAP в тестовой среде.

Чтобы добавить локализованные описания и цены

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

С пакетом UDP

Вы можете использовать массовый импорт IAP, чтобы полностью переопределить каталог IAP вашей игры, не перестраивая игру.

Вам нужно только иметь реализацию UDP в хорошем рабочем состоянии.

С помощью Unity IAP (реализация кода)

С помощью Unity IAP вы можете синхронизировать свой IAP-каталог только из редактора в UDP-консоль.

Если вы будете загружать каталог IAP вашей игры в консоль UDP с помощью массовой загрузки IAP, вы должны подготовить свою игру для получения информации о продукте IAP из консоли UDP, а не из каталога IAP по умолчанию игрового клиента.

Чтобы ваша игра могла получать каталог IAP из консоли UDP, не вызывайте в коде никаких методов получения продуктов IAP.

Для получения дополнительной информации см. Запрос ресурсов IAP.

Загрузить шаблон CSV

UDP предоставляет шаблон CSV, который можно использовать для массового импорта продуктов IAP. Шаблон находится в обычном формате UDP для файлов CSV.

1. Выберите ИЗМЕНИТЬ ИНФОРМАЦИЮ на странице Информация об игре.
2. Перейдите на панель Покупки в приложении.
3. Выберите ИМПОРТ КАТАЛОГ.
4. Выберите Загрузить шаблон.

Заполните CSV-файл

В файлах CSV для разделения значений данных используются запятые (,) и точки с запятой (;). Запятые разделяют первичные значения данных, а точки с запятой — подзначения.

Каждый элемент IAP должен полностью отображаться в одной строке CSV-файла.

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

Загрузите файл CSV

1. Выберите ИЗМЕНИТЬ ИНФОРМАЦИЮ на странице Информация об игре.
2. Перейдите в раздел Покупки в приложении.
3. Выберите ИМПОРТ КАТАЛОГ.
4. Выберите Загрузить CSV или перетащите CSV-файл в соответствующее поле.
5. Выберите ИМПОРТ, чтобы загрузить каталог IAP в консоль UDP.

Примечание. Загрузка файла CSV полностью перезаписывает каталог IAP этой версии. Консоль UDP использует только информацию, содержащуюся в вашем CSV-файле; любая другая информация IAP, которую вы ранее вводили через консоль UDP, теряется.

Экспорт файла CSV

Чтобы повторно использовать или изменить существующий каталог IAP:

1. Выберите ИЗМЕНИТЬ ИНФОРМАЦИЮ на странице информации об игре.
2. Перейдите в раздел "Покупки в приложении".
3. Выберите ЭКСПОРТ КАТАЛОГ.
   Это экспортирует существующий каталог IAP в виде файла CSV в обычном формате UDP.
4. Измените CSV-файл.
5. Загрузите файл CSV.

Кнопка ЭКСПОРТИРОВАТЬ КАТАЛОГ отображается, только если в вашем каталоге IAP есть продукты IAP, и видна только в режиме редактирования. На изображении ниже эта кнопка показана в разделе «Покупки в приложении».

Импорт продуктов IAP из формата Google Play

UDP также поддерживает файлы CSV в формате Google Play.

Чтобы импортировать продукты IAP с помощью CSV-файла Google Play:

1. Выберите ИЗМЕНИТЬ ИНФОРМАЦИЮ на странице Информация об игре.
2. Перейдите в раздел Покупки в приложении.
3. Нажмите ИМПОРТИТЬ КАТАЛОГ.
4. Установите флажок Файл CSV в формате Google Play.
5. Выберите «Загрузить CSV» или перетащите CSV-файл в соответствующее поле.
   1. В поле Валюта Google Play по умолчанию выберите валюту по умолчанию для вашей игры.
6. Выберите Импорт, чтобы загрузить каталог IAP в консоль UDP.

Цены

Google Play устанавливает цены по странам, UDP устанавливает цены по валютам. Поэтому импорт сопоставляет страны с валютами. Если для продукта IAP вы установили разные цены в разных странах, используя одну и ту же валюту (например, евро в европейских странах), UDP использует первую страну в списке для валюты. Если в списке указано несколько стран с долларом США, используется регион США.

UDP не поддерживает шаблоны цен Google Play. Этот параметр игнорируется. UDP использует только местные цены, указанные в CSV-файле.

Валюта по умолчанию

UDP использует доллары США в качестве валюты по умолчанию. Если у вас нет цен в долларах США в Google Play, UDP преобразует ваши цены и валюту Google Play по умолчанию в доллары США и использует их в качестве цен по умолчанию для UDP.

Местные цены, указанные в файле CSV, сохраняются в соответствующих валютах.

Для стран, которые не указаны явным образом в CSV-файле, UDP преобразует ваши цены и валюту Google Play по умолчанию в соответствующие валюты.

Продукты для покупок в приложениях

Тип продуктов IAP (расходуемые/нерасходуемые) нельзя определить из вашего CSV-файла; вам нужно сообщить UDP тип каждого продукта IAP.

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