================================================================================
           PANDUAN RESMI PENGGUNAAN & UPDATE EKSTENSI CHROME
                        TTA PRICE SCRAPER v5.4
                  (KARSANA - TikTok Intelligence Pro)
================================================================================

Ekstensi ini digunakan oleh Admin Toko untuk menarik data Harga Normal dan
Harga Promo/Diskon riil secara otomatis dari halaman Kelola Produk di
TikTok Seller Center menjadi file CSV yang siap dianalisis di platform KARSANA.


================================================================================
1. CARA PASANG EKSTENSI PERTAMA KALI (INSTALASI BARU)
================================================================================
1. Ekstrak file .ZIP ini ke folder permanen di komputer Anda
   (Contoh: "D:\TTA-Price-Scraper" atau "C:\Ekstensi\TTA-Price-Scraper").
   *CATATAN: Jangan hapus atau pindahkan folder ini setelah dipasang.*

2. Buka browser Google Chrome di komputer Anda.

3. Ketik alamat berikut di address bar Chrome:
   chrome://extensions/
   lalu tekan Enter.

4. Di pojok kanan atas halaman, aktifkan sakelar "Developer mode" (Mode Pengembang).

5. Di pojok kiri atas, klik tombol "Load unpacked" (Muat yang belum dibongkar).

6. Pilih folder tempat Anda mengekstrak ekstensi tadi, lalu klik "Select Folder".

7. Ekstensi "TTA Price Scraper" sudah berhasil terpasang di Chrome!
   (Klik ikon puzzle 🧩 di toolbar atas Chrome, lalu klik ikon PIN 📌 agar
   ikon ekstensi selalu muncul di toolbar).


================================================================================
2. CARA AKTIVASI LISENSI (LICENSE KEY)
================================================================================
1. Klik ikon ekstensi TTA Price Scraper di toolbar Chrome.

2. Masukkan License Key yang diberikan oleh Owner / Admin Pusat
   (Contoh: TTA-SCRAPER-XXXX-XXXX).

3. Pastikan URL Server Platform terisi:
   https://app.karsana.my.id

4. Klik tombol "Verifikasi & Simpan".

5. Jika berhasil, status lisensi akan bertuliskan "LISENSI TERDAFTAR" dengan nama
   admin/toko Anda dan ekstensi langsung siap digunakan.


================================================================================
3. CARA MENARIK DATA HARGA PRODUK DARI TIKTOK SELLER CENTER
================================================================================
1. Buka tab baru di Chrome dan login ke TikTok / Tokopedia Seller Center:
   https://seller-id.tokopedia.com/product/manage
   (atau menu "Kelola Produk" / "Manage Products").

2. Pastikan Anda berada pada tab "Aktif" (bukan tab draf atau arsip).

3. Klik ikon ekstensi TTA Price Scraper di pojok kanan atas browser.

4. Pilih mode penarikan yang diinginkan:
   - "⚡ Tarik SEMUA Halaman" : Mengambil data seluruh produk aktif dari hal 1 s/d terakhir.
   - "📄 Tarik Halaman Ini Saja" : Hanya mengambil produk di halaman yang sedang terbuka.

5. Tunggu sistem bekerja secara otomatis (jangan tutup tab TikTok selama proses berjalan).

6. Setelah selesai, browser akan membunyikan suara Chime (🔔) dan file CSV hasil
   penarikan akan otomatis terunduh ke folder Download di komputer Anda.


================================================================================
4. CARA UPDATE EKSTENSI SAAT ADA PEMBARUAN (SUPER CEPAT)
================================================================================
Jika ada rilis versi baru di platform:

1. Unduh file .ZIP terbaru dari web dashboard KARSANA (https://app.karsana.my.id)
   atau klik tombol unduh dari banner notifikasi di popup ekstensi.

2. Ekstrak isi file .ZIP tersebut, lalu TIMPA (REPLACE ALL) file-file lama yang
   ada di folder ekstensi komputer Anda.

3. Buka tab baru di Chrome dan masuk ke:
   chrome://extensions/

4. Cari kartu "TTA Price Scraper", lalu klik ikon RELOAD / MUAT ULANG (🔄).

5. SELESAI! Ekstensi langsung terupdate ke versi terbaru.
   *CATATAN: License Key Anda TIDAK AKAN HILANG dan tidak perlu diinput ulang.*


================================================================================
5. TANYA JAWAB & BANTUAN (FAQ)
================================================================================
Q: Kenapa ada produk yang Harga Promo-nya tertulis "Rp0"?
A: Di TikTok Seller Center, jika suatu produk/SKU memang TIDAK sedang diberi diskon
   atau promo flash sale, TikTok hanya menampilkan harga normalnya saja.
   Kolom "Status Promo" di CSV akan tertulis "Tidak Ada Diskon (Harga Normal)".

Q: Ekstensi tiba-tiba tidak merespons atau tombol tidak jalan?
A: Buka chrome://extensions/, klik tombol Reload (🔄) pada ekstensi TTA Price Scraper,
   lalu refresh halaman TikTok Seller Center (tekan F5).

Q: Apakah aman jika folder ekstensi ter-replace?
A: Sangat aman. Seluruh lisensi dan riwayat tarikan tersimpan aman di penyimpanan
   internal Chrome.

================================================================================
                       TTA Platform — Tim Pengembang
================================================================================
