Impor dan ekspor daftar penyimpanan

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. Namun, Anda tidak dapat menggunakan metode ini untuk membuat atau memperbarui daftar Store khusus platform untuk aplikasi yang diterbitkan sebelumnya yang mendukung versi OS yang lebih lama.

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. Anda bisa menemukan detail tentang versi Excel mana yang mendukung fitur ini di buletin Fitur baru Excel 2016, dan informasi selengkapnya tentang pengodean sebagai UTF-8 di berbagai editor di sini.

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 .

Tip

Untuk hasil terbaik saat mengimpor daftar Anda sebagai folder, pastikan Anda menggunakan versi terbaru Microsoft Edge, Chrome, atau Firefox. Misalnya, jika folder akar Anda diberi nama 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.

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.

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.

Ekspor daftar

Pada halaman Daftar toko untuk aplikasi, Anda dapat menambahkan bahasa, lalu mengklik Ekspor daftar untuk menghasilkan file .csv dengan bahasa yang Anda pilih dan bidang untuk daftar. Atau, Anda dapat terlebih dahulu mengeklik daftar Ekspor lalu memilih bahasa. Setelah daftar berhasil diekspor, unduh daftar. Dalam daftar yang diekspor, Anda akan melihat Nama bidang, jenis, dan bahasa yang telah Anda pilih untuk daftar Anda.

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 produk, Anda akan melihat ProductFeatures1, ProductFeatures2, dll., hingga ProductFeatures20 (karena Anda dapat menyediakan hingga 20 fitur aplikasi). Silakan lihat tabel di bawah ini untuk menemukan pemetaan yang tepat dari bidang daftar Toko dengan bidang yang diekspor dalam file .csv.
• Kolom Jenis menyediakan panduan umum tentang jenis info apa yang akan disediakan untuk bidang tersebut, seperti teks atau jalur Relatif.

Nama bidang di Daftar toko di Pusat Mitra	Nama bidang yang sesuai dalam file .csv yang diekspor
Deskripsi	Deskripsi
Nama produk	ProductName
Apa yang baru dalam versi ini?	WhatsNew
Fitur produk	ProductFeatures1 ke ProductFeatures20
Cuplikan layar	Cuplikan layar1 ke Cuplikan Layar10
Logo toko (1:1 box art)	StoreLogos1
Logo toko (seni poster 2:3)	StoreLogos2
Deskripsi singkat	ShortDescription
Perangkat keras minimum	RequirementsMinimum1 ke RequirementsMinimum11
Perangkat keras yang direkomendasikan	PersyaratanRecommended1 ke PersyaratanRecommended11
Istilah pencarian	SearchTerms1 ke SearchTerms7
Info hak cipta dan merek dagang	Hak Cipta
Ketentuan lisensi yang berlaku	Ketentuan lisensi yang berlaku
Dikembangkan oleh	DevelopedBy

Penting

Jangan ubah nama bidang atau hapus salah satu bidang dalam file .csv yang diekspor. Nama kolom dan item di bawah bidang 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. Untuk setiap bahasa yang ditambahkan, ada kolom terpisah dengan nama bahasa sebagai judul. Jangan ubah nama bahasa yang diekspor dalam file .csv. Perubahan yang Anda buat dalam kolom akan diterapkan ke daftar bahasa tersebut.

Sebagian besar bidang Daftar penyimpanan bersifat opsional. Deskripsi, satu Cuplikan layar, logo Store (1:1 box art) dan persyaratan lisensi yang berlaku diperlukan untuk setiap daftar. Untuk semua bidang lainnya, Anda bisa membiarkan bidang kosong jika Anda tidak ingin menyertakannya dalam daftar Anda.

Banyak bidang dalam daftar yang Anda ekspor memerlukan entri teks, seperti bidang dalam contoh di atas, Deskripsi dan WhatsNew. 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, sedikit lebih rumit. Alih-alih Teks, Jenis untuk aset ini adalah Jalur relatif.

Tip

Jika aset Anda (cuplikan layar atau logo) berada di folder yang sama dengan file .csv yang diekspor, jalur relatif hanya akan menjadi nama tangkapan layar atau logo (misalnya: logo.png). Jika Anda telah membuat subfolder untuk gambar di folder utama yang memiliki file .csv, jalur relatif akan dimulai dengan nama subfolder. (Misalnya, jika nama subfolder adalah "Gambar", jalur relatifnya adalah Gambar/logo.png)

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.

Saat Anda siap untuk mengunggah file .csv yang diperbarui dan mengimpor data daftar Anda, pilih Impor daftar di halaman daftar Toko aplikasi Anda. Saat mengimpor daftar untuk pertama kalinya, Anda harus mengunggah daftar menggunakan folder yang akan memiliki file .csv yang diekspor dan semua aset. Pastikan hanya ada satu file .csv di folder Anda, bersama dengan aset apa pun yang Anda unggah.

Penting

Saat mengimpor daftar untuk pertama kalinya, Anda perlu mengunggah folder. Folder ini harus berisi file .csv yang diekspor dengan informasi daftar dan semua aset (cuplikan layar dan logo) yang Anda sebutkan dalam file .csv.

Jika kami mendeteksi masalah, Anda akan melihat catatan yang menunjukkan bahwa Impor telah gagal. Unduh laporan untuk memeriksa kesalahan. Anda harus memperbaiki masalah ini dalam file .csv Anda (atau mengganti aset yang tidak valid) lalu mengimpor daftar Anda lagi.

Lihat tabel di bawah ini untuk pesan kesalahan, maknanya, dan rekomendasi untuk mengatasinya.

Pesan kesalahan	Arti dan rekomendasi
"File .csv kosong. Pastikan bahwa file memiliki info yang diperlukan."	Anda mungkin telah mengunggah file .csv kosong. Dari halaman Daftar penyimpanan, ekspor file .csv terbaru.
"Bidang tidak ada atau tidak valid. Silakan gunakan templat yang benar dengan mengekspor daftar."	Anda mungkin telah menghapus bidang yang sudah ada atau menambahkan bidang baru dalam file .csv yang diekspor. Ekspor file .csv dari halaman Daftar penyimpanan. Jangan ubah bidang apa pun dalam file .csv.
"Kode bahasa tidak valid atau daftar tidak tersedia untuk bahasa tersebut. Silakan gunakan templat terbaru dengan mengekspor daftar."	Anda mungkin telah mengedit kode bahasa dalam file .csv yang diekspor atau Anda mungkin telah menambahkan kode bahasa baru yang tidak ada di halaman daftar Toko. Dari halaman Daftar penyimpanan, pilih bahasa yang diperlukan lalu ekspor daftar.
"Semua bahasa yang dipilih tidak ada dalam file .csv yang diimpor. Silakan gunakan templat terbaru dengan mengekspor daftar."	Anda mungkin telah menghapus kode bahasa dalam file .csv. Ekspor file .csv dari halaman Daftar penyimpanan. Jangan ubah kode bahasa apa pun dalam file .csv.

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