Mengimpor dan mengekspor daftar penyimpanan untuk aplikasi MSIX

Alih-alih memasukkan info untuk daftar Toko Anda langsung di Pusat Mitra, Anda memiliki opsi untuk menambahkan atau memperbarui info dengan mengekspor daftar Anda dalam file .csv, memasukkan info dan aset Anda, lalu mengimpor file yang diperbarui. Anda dapat menggunakan metode ini untuk membuat daftar dari awal, atau untuk memperbarui daftar yang telah Anda buat.

Opsi ini sangat berguna jika Anda ingin membuat atau memperbarui daftar Toko untuk produk Anda dalam beberapa bahasa, karena Anda dapat menyalin/menempelkan info yang sama ke beberapa bidang dan dengan mudah membuat perubahan apa pun yang harus diterapkan ke bahasa tertentu.

Tip

Anda juga dapat menggunakan fitur ini untuk mengimpor dan mengekspor detail daftar Toko untuk add-on. Untuk add-on, proses bekerja sama kecuali hanya bidang yang relevan dengan add-on yang disertakan. Perlu diingat bahwa Anda selalu dapat membuat atau memperbarui daftar secara langsung di Pusat Mitra (bahkan jika sebelumnya Anda telah menggunakan metode impor/ekspor). Memperbarui langsung di Pusat Mitra mungkin lebih mudah ketika Anda hanya membuat perubahan sederhana, tetapi Anda dapat menggunakan salah satu metode kapan saja.

Ekspor daftar

Pada halaman gambaran umum aplikasi untuk aplikasi, klik Ekspor daftar (di bagian Daftar toko) untuk menghasilkan file .csv yang dikodekan di UTF-8. Simpan file ini ke lokasi pada komputer Anda.

Anda bisa menggunakan Microsoft Excel atau editor lain untuk mengedit file ini. Perhatikan bahwa Versi Microsoft 365 Excel akan memungkinkan Anda menyimpan file .csv sebagai CSV UTF-8 (Dibatasi koma) (*.csv), tetapi versi lain mungkin tidak mendukung ini.

Jika Anda belum membuat daftar untuk produk Anda, file .csv yang Anda ekspor tidak akan berisi data kustom apa pun. Anda akan melihat kolom untuk Bidang, ID, Jenis, dan default, dan baris yang sesuai dengan setiap item yang bisa muncul di daftar Toko.

Jika Anda telah membuat daftar (atau telah mengunggah paket), Anda juga akan melihat kolom berlabel kode bahasa lokal yang sesuai dengan bahasa untuk setiap daftar yang telah Anda buat (atau yang telah kami deteksi dalam paket Anda), serta info daftar apa pun yang sebelumnya Anda berikan.

Berikut adalah gambaran umum tentang apa yang terkandung dalam setiap kolom dalam file .csv yang diekspor:

• Kolom Bidang berisi nama yang terkait dengan setiap bagian daftar Toko. Ini sesuai dengan item yang sama yang dapat Anda berikan saat membuat daftar Toko di Pusat Mitra, meskipun beberapa nama sedikit berbeda. Untuk item di mana Anda dapat memasukkan lebih dari satu jenis item yang sama, Anda akan melihat beberapa baris, hingga jumlah maksimum yang dapat Anda sediakan. Misalnya, untuk fitur Aplikasi, Anda akan melihat Fitur1, Fitur2, dll., naik ke Feature20 (karena Anda dapat menyediakan hingga 20 fitur aplikasi).
• Kolom ID berisi angka yang diasosiasikan Pusat Mitra dengan setiap bidang.
• Kolom Jenis menyediakan panduan umum tentang jenis info apa yang akan disediakan untuk bidang tersebut, seperti jalur Teks atau Relatif (atau URL ke file di Pusat Mitra).
• Kolom default (dan kolom apa pun yang diberi label dengan kode bahasa lokal) mewakili teks atau aset yang terkait dengan setiap bagian daftar Toko. Anda bisa mengedit bidang di kolom ini untuk membuat pembaruan pada daftar Toko Anda.

Penting

Jangan ubah info apa pun di kolom Bidang, ID, atau Tipe . Info dalam kolom ini harus tetap tidak berubah agar file yang Anda impor diproses.

Memperbarui info daftar

Setelah mengekspor daftar dan menyimpan file .csv, Anda dapat mengedit info daftar langsung di file .csv.

Bersama dengan kolom default , setiap bahasa tempat Anda membuat daftar memiliki kolomnya sendiri. Perubahan yang Anda buat dalam kolom akan diterapkan ke deskripsi Anda dalam bahasa tersebut. Anda dapat membuat daftar untuk bahasa baru dengan menambahkan kode bahasa lokal ke kolom kosong berikutnya di baris atas. Untuk daftar kode bahasa lokal yang valid, lihat Bahasa yang didukung.

Anda dapat menggunakan kolom default untuk memasukkan info yang ingin Anda bagikan di semua deskripsi aplikasi Anda. Jika bidang untuk bahasa tertentu dibiarkan kosong, info dari kolom default akan digunakan untuk bahasa tersebut. Anda dapat mengambil alih bidang tersebut untuk bahasa tertentu dengan memasukkan info yang berbeda untuk bahasa tersebut.

Sebagian besar bidang Daftar penyimpanan bersifat opsional. Deskripsi dan satu cuplikan layar diperlukan untuk setiap daftar; untuk bahasa yang tidak memiliki paket terkait, Anda juga perlu memberikan Judul untuk menunjukkan nama aplikasi cadangan mana yang harus digunakan untuk daftar tersebut. Untuk semua bidang lainnya, Anda bisa membiarkan bidang kosong jika Anda tidak ingin menyertakannya dalam daftar Anda. Ingatlah bahwa jika Anda membiarkan bidang untuk bahasa tertentu kosong, kita akan memeriksa untuk melihat apakah ada info di bidang tersebut di kolom default. Jika demikian, info tersebut akan digunakan.

Misalnya, pertimbangkan contoh berikut:

• Teks "Deskripsi default" akan digunakan untuk bidang Deskripsi di daftar en-us dan fr-fr. Namun, bidang Deskripsi di daftar es-es akan menggunakan teks "Deskripsi Spanyol".
• Untuk bidang ReleaseNotes, teks "Catatan rilis bahasa Inggris" akan digunakan untuk en-us, dan teks "Catatan rilis Prancis" akan digunakan untuk fr-fr. Namun, tidak ada catatan rilis yang akan muncul untuk es-es.

Jika Anda tidak ingin melakukan pengeditan apa pun ke bidang tertentu, Anda dapat menghapus seluruh baris dari spreadsheet, dengan pengecualian baris untuk trailer dan gambar mini dan judul terkaitnya. Selain untuk item ini, menghapus baris tidak akan berdampak pada data yang terkait dengan bidang tersebut di daftar Anda. Ini memungkinkan Anda menghapus baris apa pun yang tidak ingin Anda edit, sehingga Anda dapat fokus pada bidang tempat Anda membuat perubahan.

Menghapus info dalam bidang untuk satu bahasa, tanpa menghapus seluruh baris, bekerja secara berbeda, tergantung pada bidang . Untuk bidang yang Tipenya adalah Teks, menghapus info dalam bidang hanya akan menghapus entri tersebut dari daftar dalam bahasa tersebut. Namun, menghapus info di bidang untuk gambar, seperti cuplikan layar atau logo, tidak akan berpengaruh apa pun; gambar sebelumnya masih akan digunakan kecuali Anda menghapusnya dengan mengeditnya langsung di Pusat Mitra. Menghapus info untuk bidang trailer akan benar-benar menghapus trailer tersebut dari Pusat Mitra, jadi pastikan Anda memiliki salinan file yang diperlukan sebelum Melakukannya.

Banyak bidang dalam daftar yang Anda ekspor memerlukan entri teks, seperti bidang dalam contoh di atas, Deskripsi dan Catatan Rilis. Untuk jenis bidang ini, cukup masukkan teks yang sesuai ke dalam bidang untuk setiap bahasa. Pastikan untuk mengikuti panjang dan persyaratan lainnya untuk setiap bidang. Untuk informasi selengkapnya tentang persyaratan ini, lihat Membuat daftar app Store.

Memberikan info untuk bidang yang sesuai dengan aset, seperti gambar dan trailer, sedikit lebih rumit. Daripada Teks, Jenis untuk aset ini adalah Jalur relatif (atau URL ke file di Pusat Mitra).

Jika Anda telah mengunggah aset untuk listingan Store Anda, aset ini kemudian akan diwakili oleh URL. URL ini dapat digunakan kembali dalam beberapa deskripsi untuk produk, atau bahkan di berbagai produk dalam akun pengembang yang sama, sehingga Anda dapat menyalin URL ini untuk menggunakannya kembali di bidang yang berbeda jika Anda mau.

Tip

Untuk mengonfirmasi aset mana yang sesuai dengan URL, Anda dapat memasukkan URL ke browser untuk melihat gambar (atau mengunduh video trailer). Anda harus masuk ke akun Pusat Mitra agar URL ini berfungsi.

Jika Anda ingin menggunakan aset baru yang sebelumnya belum ditambahkan ke Pusat Mitra, Anda dapat melakukannya dengan mengimpor daftar Anda sebagai folder, bukan sebagai file .csv tunggal. Anda harus membuat folder yang berisi file .csv Anda. Kemudian, tambahkan gambar Anda ke folder yang sama, baik di folder akar atau di subfolder. Anda harus memasukkan jalur lengkap, termasuk nama folder akar, di bidang .

Jika folder akar Anda bernama my_folder, dan Anda ingin menggunakan gambar yang disebut screenshot1.png untuk DesktopScreenshot1, Anda dapat menambahkan screenshot1.png ke akar folder tersebut, lalu memasukkan my_folder/screenshot1.png di bidang DesktopScreenshot1 . Jika Anda membuat folder gambar dalam folder akar Anda dan kemudian ditempatkan screenshot1.jpg di sana, Anda akan memasukkan my_folder/gambar/screenshot1.png. Perhatikan bahwa setelah Anda mengimpor daftar menggunakan folder, jalur ke gambar Anda akan dikonversi ke URL ke file di Pusat Mitra saat Anda mengekspor daftar berikutnya. Anda dapat menyalin dan menempelkan URL ini untuk menggunakannya lagi (misalnya, untuk menggunakan aset yang sama dalam beberapa bahasa daftar).

Penting

Jika daftar yang Anda ekspor menyertakan trailer, ketahuilah bahwa menghapus URL ke trailer atau gambar mininya dari file .csv Anda akan menghapus file yang dihapus sepenuhnya dari Pusat Mitra, dan Anda tidak akan lagi dapat mengaksesnya di sana (kecuali juga digunakan dalam daftar lain di mana file tersebut belum dihapus).

Impor daftar

Setelah memasukkan semua perubahan ke dalam file .csv (dan menyertakan aset apa pun yang ingin Anda unggah), Anda harus menyimpan file sebelum mengunggahnya. Jika Anda menggunakan versi Microsoft Excel yang mendukung pengodean UTF-8, pastikan untuk memilih Simpan sebagai dan gunakan format CSV UTF-8 (Dibatasi koma) (*.csv). Jika Anda menggunakan editor lain untuk melihat dan mengedit file .csv Anda, pastikan file .csv dikodekan di UTF-8 sebelum Anda mengunggah.

Saat Anda siap untuk mengunggah file .csv yang diperbarui dan mengimpor data daftar Anda, pilih Impor daftar di halaman gambaran umum aplikasi Anda. Jika Anda hanya mengimpor file .csv, pilih Impor .csv, telusuri ke file Anda, dan klik Buka. Jika Anda mengimpor folder dengan file gambar, pilih Impor folder, telusuri folder Anda, dan klik Pilih folder. Pastikan hanya ada satu file .csv di folder Anda, bersama dengan aset apa pun yang Anda unggah. Untuk gambar, Anda harus memasukkan jalur lengkap, termasuk nama folder akar, di bidang .

Saat kami memproses file .csv yang diimpor, Anda akan melihat bilah kemajuan yang mencerminkan status impor dan validasi. Ini bisa memakan waktu, terutama jika Anda memiliki banyak daftar dan/atau file gambar.

Jika kami mendeteksi masalah, Anda akan melihat catatan yang menunjukkan bahwa Anda harus membuat pembaruan yang diperlukan dan mencoba lagi. Pilih tautan Tampilkan kesalahan untuk melihat bidang mana yang tidak valid dan mengapa. Anda harus memperbaiki masalah ini dalam file .csv Anda (atau mengganti aset yang tidak valid) lalu mengimpor daftar Anda lagi.

Tip

Anda dapat mengakses info ini lagi nanti melalui tautan Tampilkan kesalahan untuk impor terakhir. Tidak ada info dari file .csv Anda yang akan disimpan di Pusat Mitra hingga semua kesalahan dalam file Anda telah diselesaikan, bahkan untuk bidang tanpa kesalahan. Setelah Anda mengimpor file .csv yang tidak memiliki kesalahan, info daftar yang Anda berikan akan disimpan di Pusat Mitra, dan akan digunakan untuk pengiriman tersebut.

Anda dapat terus membuat pembaruan pada daftar Anda baik dengan mengimpor file .csv lain yang diperbarui, atau dengan membuat perubahan langsung di Pusat Mitra.

Add-on

Untuk add-on, mengimpor dan mengekspor daftar Toko menggunakan proses yang sama seperti yang dijelaskan di atas, kecuali bahwa Anda hanya akan melihat tiga bidang yang relevan dengan daftar Toko add-on: Deskripsi, Judul, dan StoreLogo300x300 (disebut sebagai Ikon di halaman daftar Toko di Pusat Mitra). Bidang Judul diperlukan, dan dua bidang lainnya bersifat opsional.

Perhatikan bahwa Anda harus mengimpor dan mengekspor daftar Toko secara terpisah untuk setiap add-on di aplikasi Anda dengan menavigasi ke halaman gambaran umum pengiriman untuk add-on.