Mengimpor dan mengekspor 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 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 berlaku untuk bahasa tertentu. Namun, Anda tidak dapat menggunakan metode ini untuk membuat atau memperbarui daftar Toko 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, prosesnya berfungsi sama kecuali bahwa hanya bidang yang relevan dengan add-on yang disertakan. Perlu diingat bahwa Anda selalu dapat membuat atau memperbarui daftar 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 pengiriman untuk aplikasi, klik Ekspor daftar (di bagian Daftar toko) untuk membuat 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 Excel versi Microsoft 365 akan memungkinkan Anda menyimpan file .csv sebagai CSV UTF-8 (Dibatasi koma) (*.csv), tetapi versi lain mungkin tidak mendukung ini. Anda dapat menemukan detail tentang versi Excel mana yang mendukung fitur ini di buletin Excel 2016 Fitur baru, dan info 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 telah Anda berikan sebelumnya.

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 bisa 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 Feature1, Feature2, dll., hingga Feature20 (karena Anda dapat menyediakan hingga 20 fitur aplikasi).
• Kolom ID berisi angka yang terkait dengan Pusat Mitra dengan setiap bidang.
• Kolom Jenis menyediakan panduan umum tentang jenis info apa yang akan disediakan untuk bidang tersebut, seperti Teks atau jalur 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 dari daftar Toko. Anda bisa mengedit bidang dalam kolom ini untuk membuat pembaruan pada daftar Toko Anda.

Penting

Jangan ubah info apa pun di kolom Bidang, ID, atau Jenis . Info di kolom ini harus tetap tidak berubah agar file yang Diimpor 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 yang telah Anda buat 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 mengganti bidang tersebut untuk bahasa tertentu dengan memasukkan info yang berbeda untuk bahasa tersebut.

Sebagian besar bidang daftar Toko bersifat opsional. Deskripsi dan satu cuplikan layar diperlukan untuk setiap daftar; untuk bahasa yang tidak memiliki paket terkait, Anda juga harus memberikan Judul untuk menunjukkan nama aplikasi yang dipesan mana yang harus digunakan untuk daftar tersebut. Untuk semua bidang lainnya, Anda bisa membiarkan bidang kosong jika Anda tidak ingin menyertakannya dalam daftar Anda. Ingat bahwa jika Anda membiarkan bidang untuk bahasa tertentu kosong, kami 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 dalam 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 mengedit bidang tertentu, Anda dapat menghapus seluruh baris dari spreadsheet, dengan pengecualian baris untuk trailer serta gambar mini dan judul terkait. 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 bisa 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 Jenisnya 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 mengedit 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 ReleaseNotes. 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. Alih-alih 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 Anda agar URL ini berfungsi. Jika Anda ingin menggunakan aset baru yang sebelumnya belum ditambahkan ke Pusat Mitra, Anda bisa melakukannya dengan mengimpor daftar Anda sebagai folder, bukan sebagai satu file .csv. Anda harus membuat folder yang berisi file .csv Anda. Kemudian, tambahkan gambar Anda dengan 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/images/screenshot1.png. Perhatikan bahwa setelah Anda mengimpor daftar menggunakan folder, jalur ke gambar Anda akan dikonversi ke URL ke file di Pusat Mitra saat berikutnya Anda mengekspor daftar Anda. 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 sepenuhnya menghapus file yang dihapus dari Pusat Mitra, dan Anda tidak akan dapat lagi mengaksesnya di sana (kecuali jika 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 yang berbeda 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 pengiriman Anda. Jika Anda hanya mengimpor file .csv, pilih Impor .csv, telusuri file Anda, dan klik Buka. Jika Anda mengimpor folder dengan file gambar, pilih Impor folder, telusuri ke 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 alasannya. 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 satu pun info dari file .csv Anda 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 jalur Teks atau Relatif.

Nama bidang di daftar Toko di Pusat Mitra	Nama bidang terkait 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 (seni kotak 1:1)	StoreLogos1
Logo toko (seni poster 2:3)	StoreLogos2
Deskripsi singkat	ShortDescription
Perangkat keras minimum	RequirementsMinimum1 ke RequirementsMinimum11
Perangkat keras yang direkomendasikan	PersyaratanRecommended1 untuk 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 Toko 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 yang ada 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 cuplikan 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 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 Toko. Jangan ubah bidang apa pun dalam file .csv.
"Kode bahasa tidak valid atau daftar tidak tersedia untuk bahasa. 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 Toko. 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.