Sektor Listing Analytics — Ringkasan & Dokumentasi Implementasi
1) Ikhtisar Perubahan Besar
- Public Insight View: endpoint baru
sektor-analytics-viewuntuk tampilan read-only insight per listing (+ CSV & PNG watermark). - Share Center: shortcode baru UI seragam, pagination, akses terbatas Admin & Contributor.
- Tracker: deteksi event diperluas (
click_email,click_site, partner & social), anti-duplikasi, dwell stabil. - Label tampilan:
dwellditampilkan sebagai “engaged view” tanpa ubah nama DB. - UI/UX: palet hijau sektor, mobile-friendly, tabel stretch, logo & footer konsisten.
2) Komponen & File
public-view-endpoint.php
Endpoint read-only: /sektor-analytics-view/?listing_id=ID&token=... — summary, top social, partner, WhatsApp, latest 20, CSV, PNG watermark.
shortcodes-share-center.php
Shortcode utama [dashboard_analytics_share_center], alias [sektor_share_center], dengan pencarian, pagination 25/50, token/link 7 & 30 hari, role Admin+Contributor.
tracker.js
Event: view, scroll, dwell, click_wa, click_tel, click_email, click_maps, click_social, click_partner, click_site, click_out dengan anti-dobel & deteksi website resmi.
3) Shortcodes & Halaman
Share Center
[dashboard_analytics_share_center]
Tampil semua listing, pencarian opsional, pagination via ?pg=2&pp=50, tombol copy token/link (7/30 hari). Alias: [sektor_share_center]
Public Insight View
/sektor-analytics-view/?listing_id={ID}&token={TOKEN}
+CSV (&csv=1), Export PNG (watermark), noindex. Token base64url JSON ({"id":..., "exp":...}).
4) Taksonomi Event
| Event | Label | Detail |
|---|---|---|
| view | view | — |
| scroll | scroll | — |
| dwell | engaged view | — |
| click_wa | nomor WA | |
| click_tel | telephone | nomor telp |
| click_email | alamat email | |
| click_maps | maps | — |
| click_site | website | host resmi |
| click_social | social | platform IG/Tiktok/FB/... |
| click_partner | partner | GoFood, GrabFood, Shopee, Agoda, dll. |
| click_out | outbound link | link eksternal umum |
5) Integrasi Tracker (client-side)
<script>
window.SEKTOR = window.SEKTOR || {};
SEKTOR.restUrl = "https://domainmu.tld/wp-json/sektor/v1/track";
SEKTOR.siteDomains = [location.host];
SEKTOR.dwellMs = 12000;
SEKTOR.websiteUrl = "https://namabisnis.com";
</script>
<a href="https://namabisnis.com" data-sektor-website="1" target="_blank">Kunjungi Website</a>
6) UI/UX & Styling
- Palet hijau sektor #16a34a, teal aksen
- Grid 3→2→1, tabel scroll mobile, stretch desktop
- Logo kanan atas, footer “labs by webside.id”
7) Akses & Keamanan
- Share Center: hanya Admin & Contributor
- Public view: token sementara (7/30 hari)
- No-cache & noindex
8) Database & Skema
{$wpdb->prefix}sektor_listing_events- Kolom: id, listing_id, event_type, event_value, referrer, ua, session_id, ts
9) Migrasi
- Shortcode lama
[sektor_public_dashboard]tidak dipakai - Gunakan endpoint
sektor-analytics-view - Flush Permalinks setelah update
10) Troubleshooting
- Insufficient permission: token invalid/expired
- Double klik: naikkan
DEDUPE_MS - Dwell tidak muncul: tab tidak aktif
11) Snippet Tambahan
// per halaman 25/50/100
$pp = in_array($pp,[25,50,100],true)?$pp:25;
// tambah partner Zalora
'zalora.co.id'
else if(H.indexOf('zalora.co.id')!==-1)p='Zalora';
$LABELS = [
'dwell' => 'engaged view',
'click_tel' => 'telepon',
'click_wa' => 'WhatsApp',
'click_email' => 'email',
'click_site' => 'website',
'click_out' => 'outbound link',
];
12) Catatan Akhir
- Dokumentasi menyatukan perubahan UI/UX, endpoint, shortcode, tracker.
- Dukungan meta JSON penuh bisa ditambah nanti.
Kontak Dev: labs by webside.id