Sektor Listing Analytics — Ringkasan & Dokumentasi Implementasi

1) Ikhtisar Perubahan Besar

• Public Insight View: endpoint baru sektor-analytics-view untuk 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: dwell ditampilkan 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

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