KENZOO Affiliate PRO

Menampilkan semua data

📈 Grafik Tren Komisi vs Ad Spend (Harian)

Komisi Shopee Ad Spend Boncos

🏆 Top 5 Produkby profit bersih

Produk	Akun	Periode	Profit	Skor

⚠️ Perlu Di-pauseprofit negatif

Produk	Akun	Periode	Kerugian	ROI%

⚡ SINKRON OTOMATIS DARI META ADS API Tarik data langsung, tanpa download CSV manual

📘 Endpoint ini juga bisa dipanggil dari n8n/automasi lain (lihat halaman 🔑 API & Integrasi untuk dokumentasinya) supaya berjalan terjadwal tanpa kamu buka aplikasi sama sekali.

Nama Akun KENZOO

Meta Ad Account ID

Tanggal

API Key KENZOO (scope Write)

Disimpan di browser ini saja (localStorage), tidak dikirim ke mana pun selain endpoint KENZOO sendiri. Belum punya key? Buat di menu 🔑 API & Integrasi.

Import Data Baru (Manual)

Nama Akun *

📅

PERIODE TERDETEKSI

Upload ke 3 file untuk deteksi otomatis

📊

Meta Ads CSV *Wajib

Level Iklan dari Ads Manager
Kolom: Nama iklan, Spend, Klik Tautan

🛒

Shopee Commission Report *Wajib

AffiliateCommissionReport.csv
Kolom: Tag_link1, Status, Komisi

🖱️

Shopee Click Report Opsional

Pilih semua potongan CSV sekaligus (maks. 7 hari/file)
File digabung dan baris duplikat dibuang otomatis

Isi nama akun & upload ke 3 file untuk memulai

🔗 Sinkron Otomatis Komisi dari Shopee Affiliate API Beta

Tarik data komisi langsung tanpa upload CSV — hasilnya otomatis masuk sebagai file "Shopee Commission" di atas. Butuh akses Open API aktif (AppID & Secret sudah di-set di server). Rentang maksimal 3 bulan terakhir. Laporan Klik terpisah opsional; Waktu Klik dari conversion report dipakai untuk Creative Intelligence.

Dari
Sampai

ℹ️ Panduan Cara Download & Upload File (Untuk Pemula)

📊

1. File Meta Ads

Cara Download dari Facebook:

Buka halaman Ads Manager Facebook Anda.
Pilih rentang tanggal iklan di pojok kanan atas.
Klik tombol Breakdown → Pilih By Time → Klik Day.
Ini wajib agar data akurat per hari!
Pastikan kolom berikut tampil di tabel:
Nama Iklan · Jumlah yang Dibelanjakan · Klik Tautan · Penayangan Iklan
Klik ikon Export → Pilih Export table data → Format .CSV / .XLSX.

💡 Tanpa kolom "Nama Iklan" & "Jumlah yang Dibelanjakan", file tidak akan terbaca oleh aplikasi.

🖱️

2. File Shopee Clicks

Cara Download dari Shopee:

Buka Dashboard Shopee Affiliate.
Pergi ke menu Laporan → Laporan Klik.
Pilih rentang tanggal yang sama dengan file Meta Ads.
Klik Export. File bernama WebsiteClickReport.

💡 File ini opsional tapi diperlukan untuk menampilkan data Click Rate (Meta → Shopee). Kolom wajib: Tag_link & Waktu Klik.

💰

3. Laporan Pesanan Affiliate

Cara Download dari Shopee:

Buka Dashboard Shopee Affiliate.
Pergi ke menu Laporan → Laporan Pesanan Affiliate.
Filter berdasarkan Waktu Pemesanan — bukan Waktu Pembayaran!
Untuk P&L kalender, rentang boleh sama dengan Meta. Untuk mature cohort, sebaiknya akhir Commission Report dibuat +7 hari setelah tanggal akhir Meta agar order terlambat dari klik akhir periode ikut tertangkap.
Pastikan bahasa Shopee → Bahasa Indonesia sebelum export. Kolom harus berbahasa Indonesia agar terbaca.
Klik Export. File bernama AffiliateCommissionReport.

⚠️ Wajib filter Waktu Pemesanan! Jika pakai Waktu Pembayaran, P&L kalender bisa bergeser. Untuk Creative Intelligence aplikasi akan mengelompokkan ulang komisi menggunakan kolom Waktu Klik. Kolom inti: Tag_link1, Waktu Klik, Status Pesanan, Komisi Bersih Affiliate.

Semua Produk

Nama Iklan↕	Tag↕	Akun↕	Periode↕	Spend↕	CPC↕	Status↕	Klik Meta↕	Klik Shopee↕	Click Rate↕	Order↕	CR%↕	Komisi↕	Profit↓	ROI%↕	ROAS↕

📤 CEK REFUND DARI FILE COMMISSION REPORT

Refund Shopee biasanya baru muncul statusnya H+3 atau lebih setelah pesanan dibuat (gagal transfer, gagal COD, gagal pengiriman) — jadi data dari Import Data harian (yang selalu pakai tanggal terbaru) tidak akan pernah berisi refund. Upload di sini khusus untuk file Commission Report tanggal lama (sudah lewat beberapa hari), supaya status refund-nya sudah final. Upload ini tidak mempengaruhi data Spend/Komisi/Order yang sudah tersimpan di Dashboard.

Akun 📁 Pilih File Belum ada file dipilih

💸

TOTAL REFUND

Rp 0

0% dari komisi periode ini

🧾

JUMLAH TRANSAKSI

0

pesanan ter-refund

💵

KOMISI ASLI (SEBELUM REFUND)

Rp 0

dari pesanan yang di-refund

📈

KOMISI BERSIH (SETELAH REFUND)

Rp 0

komisi pesanan ini − refund

DAFTAR PESANAN TER-REFUND

Tanggal	Akun	Nama Iklan	Tag	ID Pemesanan	Jumlah Refund	Komisi Asli

Click Rate: Meta Ads → Shopee

Click Rate = % klik Meta yang berhasil masuk Shopee. ≥80% = bagus. 60-80% = perhatian. <60% = banyak hilang. ≥100% = ada organic/retargeting.

Nama Iklan↕	Tag↕	Akun↕	Periode↕	Klik Meta↕	Klik Shopee↕	Click Rate↓	Visualisasi	Order↕	CR%↕	Profit↕	Spend↕	CPC↕	Diagnosa

Trend Performa Harian

Periode

Akun

Metrik

Produk (opsional)

Untuk melihat trend harian, upload data per hari secara terpisah (misal: "ALD - 1 Apr", "ALD - 2 Apr"). Setiap periode akan menjadi satu titik di grafik.

Product Scoring Legacy / Diagnostic

Skor 0–100 berdasarkan ROI, ROAS, Click Rate, dan CR%

Rumus legacy: ROI (35%) + ROAS (30%) + Click Rate (20%) + CR% (15%) — normalized 0–100. Jangan gunakan skor ini sendirian untuk scale/kill. Untuk keputusan budget gunakan Creative Intelligence (Mature EPC/CPC + maturity + trend).

Skor↓	Nama Iklan↕	Akun↕	ROI%↕	ROAS↕	Click Rate↕	CR%↕	Profit↕	Spend↕	Rekomendasi

Creative Lifecycle Command Center

Mature = cohort klik berumur ≥5 hari. Default curve dikalibrasi dari data KENZOO Juli 2026.

Periode

North Star: Mature EPC ÷ Mature CPC. 1.00x = break-even komisi vs ads spend, 1.30x+ = winner candidate, 1.50x+ = scale candidate. Recent 3D/7D memakai hari klik yang sudah mature, bukan tanggal order. Filter Periode juga berbasis tanggal klik/Meta session dan menghitung ulang lifecycle hanya dari rentang terpilih. Tampilan Ringkas dirancang untuk zoom browser 100%; klik Detail untuk seluruh metrik.

Bandingkan Dua Periode

Periode A (lebih lama)

Periode B (lebih baru)

🗃️ Data Tersimpan

Akun: Periode: 0 sesi

Akun	Periode	Produk	Spend	Profit	ROI%	ROAS	Disimpan	Aksi

🗝️ API KEY KAMU 0 key

🔑

Belum ada API Key. Klik "Buat API Key" untuk mulai integrasi.

📘 CARA PAKAI

Sertakan API Key di header setiap request:

Authorization: Bearer knz_live_xxxxxxxxxxxxxxxx

📥 Ambil Ringkasan Dashboard (GET, scope: read)

GET https://kenzoo-affiliate-pro.pages.dev/api/v1/dashboard?from=2026-06-20&to=2026-06-26&akun=KNZ-01

📥 Ambil Daftar Produk (GET, scope: read)

GET https://kenzoo-affiliate-pro.pages.dev/api/v1/products?from=2026-06-20&to=2026-06-26

🧠 Ambil Creative Intelligence Resmi (GET, scope: read)

GET https://kenzoo-affiliate-pro.pages.dev/api/v1/intelligence?from=2026-08-06&to=2026-08-12&akun=KNZ

Endpoint ini memakai engine Creative Intelligence yang sama dengan UI KENZOO: click-date cohort, maturity ≥5 hari, Mature EPC/CPC, recent mature economics, trend, dan lifecycle TESTING / PROMISING / WINNER / SCALE / WATCHLIST / AGING / KILL / ORGANIC.

👑 Admin — Daftar Akun Anggota (GET, scope: adminRead)

GET https://kenzoo-affiliate-pro.pages.dev/api/v1/admin/accounts

👑 Admin — Portfolio Fair Period (GET, scope: adminRead)

GET https://kenzoo-affiliate-pro.pages.dev/api/v1/admin/portfolio?preset=7d

🔁 Admin — Bandingkan Periode (GET, scope: adminRead)

GET https://kenzoo-affiliate-pro.pages.dev/api/v1/admin/compare?preset=7d

👑 Admin — Creative Intelligence Member (GET, scope: adminRead)

GET https://kenzoo-affiliate-pro.pages.dev/api/v1/admin/intelligence?account_id=UID_MEMBER&preset=7d

🔎 Admin — Compare Creative Member (GET, scope: adminRead)

GET https://kenzoo-affiliate-pro.pages.dev/api/v1/admin/intelligence-compare?account_id=UID_MEMBER&preset=7d

Preset tersedia: 7d, 15d, 30d, month, all, custom. Anchor default memakai tanggal sesi terbaru global agar semua akun dibandingkan pada window tanggal yang sama.

🔒 Endpoint Admin memerlukan key yang dibuat oleh Admin Master dan scope Admin Read. Key member biasa tidak bisa membaca tenant lain.

📤 Kirim Data Sesi (POST, scope: write)

POST https://kenzoo-affiliate-pro.pages.dev/api/v1/import
Content-Type: application/json

{
  "akun": "KNZ-01",
  "period": "2026-06-27",
  "products": [
    {
      "nama": "Sendal Hiu Murah",
      "tag": "sendalhiu",
      "matchKey": "sendalhiumurah",
      "spend": 50000,
      "klikMeta": 120,
      "klikShopee": 95,
      "order": 8,
      "komisi": 75000
    }
  ]
}

⚠️ Mengirim data untuk akun + tanggal yang sama akan menimpa sesi lama (sama seperti impor manual). Field selain yang dicontohkan opsional — KENZOO akan menghitung profit/ROI/ROAS/score otomatis.

🔄 Sinkron Otomatis Meta Ads (POST, scope: write)

POST https://kenzoo-affiliate-pro.pages.dev/api/v1/meta-sync
Content-Type: application/json

{
  "akun": "KNZ-01",
  "metaAdAccountId": "act_1234567890",
  "date": "2026-06-27"
}

📌 Endpoint ini menarik data langsung dari Meta Marketing API (token tersimpan rahasia di server, tidak pernah lewat sini) dan menggabungkannya ke sesi hari itu. Kalau data Shopee untuk akun+tanggal yang sama sudah ada (dari impor manual atau sinkron lain), komisi & order-nya tidak akan tertimpa — hanya sisi spend/klik Meta yang diperbarui. Cocok dijadwalkan dari n8n (mis. tiap pagi jam 7) untuk tiap akun.

📥 Import Commission Report

💰

Shopee Commission Report *Wajib

AffiliateCommissionReport.csv
Kolom: L1 Kategori Global, Platform, Status Produk Affiliate

Nama / Label Periode

📂

Upload file Commission Report

untuk melihat analisis Kategori, Platform, dan Status Pesanan

🔐 PERSETUJUAN AKUN BARU

Tidak ada akun yang menunggu persetujuan.

DATA ANGGOTA 0 anggota

⏳

Memuat data...

📊 Ringkasan Tim

🏆

Ranking Anggota

Berdasarkan Profit

Rank

Anggota

Profit ↕

ROI

ROAS

Progress

ⓘ Klik anggota untuk detail

≥ 100%

60-99%

30-59%

< 30%

📈 Grafik Perbandingan

💸 REFUND TIM Dari file refund yg sudah diupload tiap anggota

Belum ada data refund yang diupload oleh anggota tim.

📋 Data Produk Seluruh Tim

0 produk

👆

Pilih anggota untuk melihat data produk