Mengimpor produk dengan file CSV

Mengimpor produk ke Toko Shopify Anda menggunakan file nilai yang dipisahkan koma (CSV) berguna saat Anda beralih ke Shopify dari platform lain atau saat Anda ingin membuat banyak perubahan pada produk atau inventaris Anda.

Saat Anda mengimpor produk, data dikonversi dari file CSV menjadi produk dan Anda dapat memilih apakah ingin menerbitkan produk baru ke semua saluran penjualan atau hanya ke toko online Anda.

Di halaman ini

Sebelum memulai

Sebelum mengimpor produk menggunakan file CSV, pastikan Anda telah membaca topik berikut:

Impor produk yang dimulai dengan file CSV tidak dapat dibatalkan setelah dimulai, dan Anda tidak dapat melihat riwayat impor sebelumnya. Untuk meninjau perubahan terbaru yang dibuat oleh impor, periksa log aktivitas toko Anda.

Menguji impor menggunakan toko pengembang

Jika Anda adalah Mitra Shopify dan sedang melakukan impor skala besar untuk penjual, pastikan Anda menguji sebagian kecil perubahan terlebih dahulu menggunakan toko pengembang sebelum melakukan pekerjaan impor yang sebenarnya.

Pertimbangan untuk menimpa detail produk Anda menggunakan file impor CSV

Saat mengimpor file CSV, Anda dapat memilih opsi Timpa produk dengan nama pengguna yang cocok. Jika Anda memilih opsi ini, saat nama pengguna di file CSV impor cocok dengan nama pengguna yang ada di daftar produk Anda, nilai di file CSV akan menimpa nilai di kolom yang cocok di daftar produk yang ada. Jika opsi timpa tidak dipilih, produk yang cocok dengan nama pengguna yang ada akan diabaikan selama impor CSV.

Jika kolom yang tidak wajib diisi dalam file CSV impor kosong, nilai yang cocok di daftar produk akan ditimpa menjadi kosong.
- Misalnya, Vendor nilai di daftar produk Anda yang ada adalah John's Apparel, tetapi Vendor kolomnya kosong di file CSV yang Anda impor, maka John's Apparel ditimpa menjadi kosong.
Jika kolom yang tidak wajib diisi tidak disertakan dalam file CSV impor, tetapi disertakan dalam daftar produk yang ada, nilai dalam daftar produk akan tetap sama.
- Misalnya, jika Variant image URL kolom disertakan dalam daftar produk yang ada, tetapi kolom tersebut tidak disertakan dalam file CSV impor, maka nilai dalam daftar produk tetap sama.
Jika kolom yang tidak wajib diisi disertakan dalam file CSV impor yang bergantung pada data kolom lain yang tidak disertakan dalam file, data yang ada akan dihapus.
- Misalnya, jika kolom SKU disertakan dalam file CSV impor, tetapi kolom Nilai Opsi1 dan Nama Opsi1 tidak, maka opsi varian produk akan dihapus.
File CSV tidak dapat digunakan untuk menghapus produk secara massal. Jika Anda ingin menghapus produk secara massal, Anda dapat menggunakan tindakan massal di bagian Produk pada admin Anda.
File CSV tidak dapat digunakan untuk memperbarui ketersediaan produk secara massal di saluran penjualan lain. Pelajari selengkapnya tentang mengatur ketersediaan produk di saluran penjualan lain.

Impor produk dari toko lain

Jika Anda memiliki file CSV yang diekspor dari toko lain atau berasal dari sumber lain, verifikasi bahwa file tersebut cocok dengan format file CSV. Jika format tidak cocok, atau jika ada header yang hilang, impor akan gagal.

CSV produk Anda tidak boleh melebihi 15 MB. Jika Anda mendapatkan error setelah mencoba mengunggah file CSV baru, atau jika waktu unggah habis, bagi file CSV tersebut menjadi beberapa file yang lebih kecil, lalu unggah setiap file.

Langkah-langkah:

Dari admin Shopify Anda, buka Produk.
Klik Impor.
Klik Tambahkan file, lalu pilih file CSV yang ingin Anda impor.
Opsional: Jika Anda ingin menerbitkan produk baru hanya ke toko online, bukan ke semua saluran penjualan, batalkan pilihan Terbitkan produk baru ke semua saluran penjualan.
Opsional: Untuk mengubah URL dengan menimpa nilai untuk nama pengguna yang ada, pilih Timpa produk dengan nama pengguna yang cocok. Nilai yang ada akan diganti untuk semua kolom yang disertakan dalam CSV.
Klik Unggah dan lanjutkan.
Tinjau detail tentang impor, lalu klik Impor produk.

Setelah file CSV diunggah, Anda akan menerima email konfirmasi dari Shopify di akun email yang Anda gunakan untuk menyiapkan Toko Shopify Anda. Baca beberapa solusi untuk masalah umum.

Impor produk menggunakan file CSV

Jika ingin membuat perubahan pada produk Anda menggunakan file CSV, Anda harus mengekspor produk terlebih dahulu. Anda dapat membuat perubahan pada file CSV di program spreadsheet, seperti Google Sheets, lalu mengimpor CSV yang diperbarui ke admin Shopify.

Langkah-langkah

Dari admin Shopify Anda, buka Produk.
Klik Impor.
Klik Tambahkan file, lalu pilih file CSV yang ingin Anda impor.
Opsional: Jika Anda ingin menerbitkan produk baru hanya ke toko online, bukan ke semua saluran penjualan, batalkan pilihan Terbitkan produk baru ke semua saluran penjualan.
Opsional: Untuk mengubah URL dengan menimpa nilai untuk nama pengguna yang ada, pilih Timpa produk dengan nama pengguna yang cocok. Nilai yang ada akan diganti untuk semua kolom yang disertakan dalam CSV.
Klik Unggah dan lanjutkan.
Tinjau detail tentang impor, lalu klik Impor produk.

Setelah file CSV diunggah, Anda akan menerima email konfirmasi dari Shopify di akun email yang digunakan untuk menyiapkan Toko Shopify Anda. Baca beberapa solusi untuk masalah umum.

Penyelesaian masalah impor CSV

Jika Anda mengalami masalah saat mengimpor file CSV, tinjau informasi penyelesaian masalah berikut.

Karakter atau simbol tak terduga muncul di konten yang diimpor

Jika Anda melihat karakter atau simbol tak terduga di deskripsi produk, judul, atau konten lainnya setelah mengimpor file CSV, kemungkinan file tersebut tidak disimpan dengan encoding UTF-8 (Unicode Transformation Format - 8-bit).

Encoding UTF-8 diperlukan untuk mencegah munculnya karakter tak terduga di konten Anda. Secara default, Google Sheets menyimpan file dengan encoding UTF-8 secara otomatis. Perangkat lunak spreadsheet lain mungkin memerlukan langkah tambahan untuk menyimpan dengan encoding UTF-8.

Perbaiki item yang terpengaruh secara manual

Periksa setiap produk yang terpengaruh dan ubah atau hapus karakter tersebut secara manual. Cara ini paling efektif jika hanya beberapa item yang terpengaruh.

Impor versi yang lebih lama

Jika Anda memiliki versi file CSV sebelumnya yang disimpan dengan encoding yang benar, impor versi tersebut.

Simpan ulang dengan encoding yang benar

Buka file CSV yang di-encode dengan tidak benar dan simpan lagi dengan encoding UTF-8. Prosesnya bervariasi tergantung pada sistem operasi dan program spreadsheet Anda. Untuk mendapatkan petunjuk, lihat File CSV.

Kesalahan jaringan: Token tak terduga di JSON pada posisi 0

Jika Anda menerima pesan kesalahan Network error: Unexpected token < in JSON at position 0, berarti judul kolom CSV tidak sama persis dengan header templat CSV yang diperlukan. Nama header kolom peka terhadap huruf besar/kecil.

Tinjau dan perbaiki header kolom

Tinjau panduan format CSV untuk format CSV yang benar.
Bandingkan judul kolom CSV Anda dengan file sampel.
Pastikan header file CSV Anda sama persis dengan file sampel, termasuk sensitivitas huruf besar/kecil. Misalnya, gunakan Handle, bukan handle.
Perbaiki header file CSV Anda agar sesuai dengan header file sampel. Anda dapat mengunduh salinan file sampel dari panduan format CSV.

Kesalahan kutipan ilegal

Kesalahan kutipan ilegal terjadi jika ada koma dan tanda kutip yang tidak di-encode dengan UTF-8 di file CSV Anda.

Agar CSV produk dapat diimpor dengan benar, semua tanda kutip dan apostrof harus di-encode dengan UTF-8 dan berada di posisi yang benar. Misalnya, tanda kutip non-UTF-8 ditampilkan melengkung: “ ”, dan tanda kutip UTF-8 lurus: " ".

Simpan file Anda dengan encoding UTF-8

Simpan file asli Anda dengan encoding UTF-8 sebelum mengimpor.

Impor gagal dengan kesalahan "Line is invalid (No details)"

Jika Anda menerima kesalahan yang menunjukkan bahwa baris tertentu tidak valid tanpa detail tambahan, masalahnya mungkin disebabkan oleh konflik dengan opsi varian produk yang ada. Hal ini terjadi saat Anda mencoba mengubah nilai opsi dari satu posisi opsi ke posisi lainnya.

Penyebab masalah ini

Impor CSV gagal jika file mencoba menetapkan nilai opsi yang ada ke posisi opsi baru, sehingga menimbulkan konflik karena opsi varian harus unik. Misalnya, jika Anda mencoba memindahkan Size dari Opsi 1 ke Opsi 2, dan menambahkan Type sebagai Opsi 1 yang baru, database akan memvalidasi nama duplikat sebelum mengimpor nilai baru, dan prosesnya akan gagal.

Selesaikan konflik

Gunakan nama pilihan sementara selama impor, lalu perbarui setelahnya:

Di file CSV Anda, gunakan nama sementara alternatif untuk opsi yang menyebabkan konflik. Misalnya, gunakan Size. (dengan titik), bukan Size.
Impor file CSV dengan nama pilihan sementara.
Setelah impor berhasil diselesaikan, buat file CSV baru yang mengubah nama pilihan sementara menjadi nama yang Anda inginkan.
Impor file CSV yang telah diperbarui untuk menerapkan nama pilihan akhir.