Impor Masal CSV

Perintah product:import-csv adalah solusi tercepat untuk mengisi etalase website afiliasi Anda dengan puluhan produk sekaligus. Cukup siapkan spreadsheet di Excel atau Google Sheets, simpan sebagai CSV, lalu impor dalam hitungan detik. Sistem otomatis mendeteksi pemisah kolom, merapikan format harga lokal, dan menyusun halaman ulasan produk siap tayang.

📥 Unduh Sampel Berkas CSV Siap Pakai

Ingin langsung mencoba tanpa membuat berkas dari nol? Unduh berkas template resmi yang sudah terisi 5 produk nyata (koper & tas travel):

👉 📥 Unduh Sampel contoh-produk.csv (Klik untuk mengunduh template)

📋 Cuplikan Data Riil Template CSV

Berikut adalah cuplikan data nyata dari berkas contoh-produk.csv yang dapat Anda gunakan sebagai acuan:

Nama Produk	Brand	Kategori	Harga	Link Afiliasi (Deeplink)	Gambar URL	Rating
`Lojel Cubo Small Carry-on 21"`	Lojel	`koper-kabin`	`Rp 3.850.000`	`https://atid.me/002bc7001bpn?url=...`	`https://images.shopee.co.id/...`	`4.9`
`American Tourister Curio Spinner 55`	American Tourister	`koper-kabin`	`Rp 2.190.000`	`https://invl.me/clo2x25?url=...`	`https://images.shopee.co.id/...`	`4.8`
`Baller Polycarbonate Front Pocket 20`	Baller	`koper-kabin`	`Rp 3.499.000`	`https://gettracker.net/dpl/...`	`https://images.shopee.co.id/...`	`4.9`
`Thule Subterra Carry-on 36L`	Thule	`koper-kabin`	`Rp 4.750.000`	`https://atid.me/002bc7001bpn?url=...`	`https://images.shopee.co.id/...`	`4.9`
`Tas Travel Duffle Canvas Oxford`	Tanpa Merek	`weekender-bag`	`Rp 150rb`	`https://invl.me/clo2x1x?url=...`	`https://images.shopee.co.id/...`	`4.7`

Catatan: Sistem secara cerdas memahami format harga angka penuh (Rp 3.850.000), singkatan Indonesia (Rp 150rb, 1.5 jt), hingga produk tanpa merek (otomatis diset sebagai draf aman).

⚡ Fungsi Cepat

Ekspansi Katalog Skala Besar: Mengimpor 10 hingga 500 produk sekaligus dalam hitungan detik.
Toleransi Delimiter Regional Otomatis: Mendukung tanda koma (,) standar internasional dan titik-koma (;) bawaan Microsoft Excel Indonesia tanpa perlu setelan manual.
Sanitasi Harga Cerdas (Smart Price Sanitization): Mengenali format Rp 3.850.000, 3.850.000,00, 150rb, 150k, hingga 1.5 jt menjadi angka murni.
Jalur Langsung Tayang (Direct Publish): Tambahkan opsi --publish untuk langsung merakit dan menerbitkan website ke Cloudflare Pages ($0/bulan).

🛠️ Jalur A: Perintah CLI (1-Baris Langsung Coba)

Jalankan perintah impor CSV langsung di terminal komputer Anda:

bash

# 1. Coba langsung impor template contoh-produk.csv ke situs tas
php cuanaff product:import-csv tas contoh-produk.csv

# 2. Impor borongan dan langsung tayangkan ke Cloudflare Pages
php cuanaff product:import-csv tas contoh-produk.csv --publish

# 3. Simulasi uji coba aman (dry run) tanpa menulis ke penyimpanan disk
php cuanaff product:import-csv tas contoh-produk.csv --dry-run

Pratinjau Output Terminal:

txt

[CSV] Membaca berkas: contoh-produk.csv
[DETEKSI] Format delimiter terdeteksi: Koma (,) | Kolom cocok: 7 kolom baku
[PROSES] Mengimpor 5 produk...
  - [OK] lojel-cubo-small-carry-on-21 (Rp 3.850.000) -> published
  - [OK] american-tourister-curio-spinner-55 (Rp 2.190.000) -> published
  - [OK] baller-polycarbonate-front-pocket-20 (Rp 3.499.000) -> published
  - [OK] thule-subterra-carry-on-36l (Rp 4.750.000) -> published
  - [OK] tas-travel-duffle-canvas-oxford (Rp 150.000) -> draft
[SELESAI] 5 produk berhasil diimpor ke data/tas/products/ (0 gagal)
[STATUS] Katalog siap dirakit dengan php cuanaff site:build

🤖 Jalur B: Prompt AI Siap Salin

Gunakan asisten coding AI (Antigravity, CommandCode, Cursor) atau web AI (ChatGPT, Claude) untuk meriset produk dan mengeksekusi impor CSV secara instan.

Template Prompt AI: Riset Toko & Eksekusi Impor CSV

Salin dan kirim instruksi berikut ke asisten AI Anda:

text

Tolong bantu saya mengisi katalog produk untuk website niche CuanAff (situs aktif saat ini).

Instruksi:
1. Buat berkas CSV baru atau gunakan template contoh-produk.csv dengan skema 7 kolom baku:
   nama_produk,brand,kategori,harga,aff_link,gambar_url,rating

2. Masukkan 5-10 produk rekomendasi populer untuk niche [CONTOH: tas travel / smart security / sepeda listrik] dengan harga pasaran wajar di Indonesia dan kategori yang relevan.

3. Simpan berkas sebagai `produk-batch.csv` di folder proyek.

4. Jalankan perintah impor CuanAff di terminal:
   php cuanaff product:import-csv [slug-situs] produk-batch.csv

5. Tampilkan ringkasan status produk yang berhasil diimpor.

Eksekusi Otomatis di Coding Agent

Pada Antigravity, CommandCode, atau Cursor, agen AI dapat langsung menulis berkas produk-batch.csv, menjalankan php cuanaff product:import-csv, dan memastikan berkas produk di data/<slug>/products/ terbentuk sempurna dalam satu putaran kerja.

⚙️ Parameter & Opsi Kunci

Berikut adalah opsi dan parameter utama pada perintah product:import-csv:

Parameter / Opsi	Wajib?	Keterangan & Fungsi	Contoh Nilai
`<site>`	Wajib	Slug website target tempat produk disimpan.	`tas`, `aman`, `pilihlistrik`
`<file>`	Wajib	Jalur (path) ke berkas CSV di komputer Anda.	`contoh-produk.csv`
`--publish`	Opsional	Langsung merakit dan menerbitkan website ke Cloudflare Pages setelah impor selesai.	`--publish`
`--dry-run`	Opsional	Memvalidasi susunan baris CSV tanpa membuat berkas produk di disk.	`--dry-run`
`--json`	Opsional	Mengeluarkan laporan hasil impor dalam format JSON terstruktur untuk otomasi script.	`--json`

📐 Spesifikasi Kolom & Aturan Format

CuanAff mendukung dua varian format header kolom:

1. Skema Kolom Baku CSV (Rekomendasi)

csv

nama_produk,brand,kategori,harga,aff_link,gambar_url,rating

nama_produk (Wajib): Nama lengkap model produk.
brand (Wajib): Merek produsen. Jika kosong, sistem otomatis menetapkan Tanpa Merek dan menjadikannya draf aman.
kategori (Wajib): Kategori dalam format huruf kecil bertanda hubung (kebab-case, misal koper-kabin).
harga (Wajib): Angka harga (contoh: Rp 3.850.000 atau 150rb).
aff_link (Opsional): Tautan afiliasi universal multi-network (AccessTrade atid.me, Involve Asia invl.me, Indoleads gettracker.net, atau link marketplace langsung). Alias kolom legacy seperti link_shopee, link_afiliasi, atau url tetap didukung otomatis.
gambar_url (Opsional): URL foto produk resmi.
rating (Opsional): Skor ulasan (1.0–5.0, default: 4.8).

2. Skema Alternatif Ringkas

csv

name,brand,category,price,aff_link,pros,cons

Poin keunggulan (pros) dan catatan kekurangan (cons) dapat dipisahkan dengan tanda pipa (|).

📱 Hasil Nyata di Website

Setelah perintah product:import-csv selesai:

Berkas Produk Terbentuk Rapi: Berkas markdown individu tercipta di data/<slug>/products/ dengan metadata harga, foto hero, dan tombol afiliasi.
Katalog Langsung Terisi Padat: Halaman kategori dan beranda langsung memiliki variasi produk yang menarik calon pembeli.
Siap Menghasilkan Komisi: Tambahkan opsi --publish agar etalase produk Anda langsung tayang global ke internet dalam satu langkah mudah.

Impor Masal CSV ​

📋 Cuplikan Data Riil Template CSV ​

⚡ Fungsi Cepat ​

🛠️ Jalur A: Perintah CLI (1-Baris Langsung Coba) ​

Pratinjau Output Terminal: ​

🤖 Jalur B: Prompt AI Siap Salin ​

⚙️ Parameter & Opsi Kunci ​

📐 Spesifikasi Kolom & Aturan Format ​

1. Skema Kolom Baku CSV (Rekomendasi) ​

2. Skema Alternatif Ringkas ​

📱 Hasil Nyata di Website ​