2026-11-12 · 12 min
Frequency Capping Notifikasi dan Unsubscribe Satu Klik
Kalau tim produk Anda mengecek angka uninstall atau keluhan spam pagi ini, sehari setelah 11.11, dan grafiknya naik lebih tinggi dari biasanya, kemungkinan besar bukan karena aplikasinya rusak. Kemungkinan besar karena selama seminggu terakhir, aplikasi itu mengirim notifikasi promo lebih sering daripada yang ditoleransi orang. Gejala ini punya nama, notification fatigue, dan tulisan ini soal frequency capping notifikasi: cara membatasi berapa kali satu user boleh dihubungi dalam sehari, lewat tiga kontrak backend yang bisa Anda pasang sebelum gelombang promo berikutnya, Black Friday dan 12.12, datang.
Saya tidak akan membahas tombol mana yang paling “eye-catching” atau waktu kirim yang paling optimal. Itu urusan tim growth. Yang saya bahas di sini adalah hak paling dasar yang sering dilupakan saat tim sedang mengejar target campaign: hak untuk berhenti dihubungi, dan cara menghormatinya di level kode, bukan sekadar di kebijakan privasi yang tidak pernah dibaca siapa pun.
Satu catatan kejujuran sebelum mulai: saya tidak akan menyebut angka seperti “sekian persen uninstall disebabkan notifikasi berlebihan”. Angka semacam itu banyak beredar tanpa sumber yang bisa saya telusuri sampai metodologinya. Argumen di tulisan ini berpijak pada dua konsep psikologi yang sudah mapan, lalu diterjemahkan langsung ke kontrak teknis yang bisa Anda audit sendiri kebenarannya.
Dua Alasan Orang Berhenti Memperhatikan, Lalu Melawan
Habituation: notifikasi yang terlalu sering berhenti diperhatikan
Habituation adalah salah satu bentuk pembelajaran paling dasar: ketika stimulus yang sama muncul berulang tanpa konsekuensi baru, respons terhadapnya melemah. Ini bukan konsep yang eksklusif untuk notifikasi aplikasi. Ia berlaku untuk suara AC yang lama-lama tidak terdengar, sampai notifikasi promo ketiga di hari yang sama yang akhirnya di-swipe tanpa dibaca.
Masalahnya, habituation tidak berhenti di “notifikasi diabaikan”. Begitu user terbiasa mengabaikan notifikasi dari satu sumber, perhatian terhadap notifikasi penting dari sumber yang sama ikut menurun. Notifikasi promo yang berlebihan bukan cuma sia-sia untuk campaign itu sendiri, ia menurunkan nilai setiap notifikasi berikutnya, termasuk yang benar-benar perlu dilihat user, seperti status pembayaran atau perubahan jadwal.
Reactance: dikendalikan, maka melawan
Konsep kedua, psychological reactance, dirumuskan Jack Brehm pada 1966. Intinya: ketika seseorang merasa kebebasannya untuk memilih sedang diancam atau dikendalikan, ia cenderung melakukan hal yang justru berlawanan dengan apa yang diinginkan pihak yang mengendalikan, semata untuk menegaskan kembali kebebasan itu.
Notifikasi promo yang datang terus-menerus, apalagi yang terasa seperti memaksa (“Jangan lewatkan!”, dikirim tiga kali sehari), bukan cuma melelahkan. Ia membuat sebagian user merasa kendali ada di tangan aplikasi, bukan di tangan mereka. Uninstall, mematikan izin notifikasi di level OS, atau menandai email sebagai spam adalah bentuk paling ekstrem dari melawan balik: user mengambil kembali kendali dengan cara paling drastis yang tersedia, karena cara yang lebih halus (preferensi granular, unsubscribe yang mudah) tidak disediakan atau tidak bisa ditemukan.
Dari dua konsep ini, tugas backend sebenarnya sederhana untuk dirumuskan, walau tidak sederhana untuk dibangun: batasi volumenya sebelum user terbiasa mengabaikan, dan sediakan jalan keluar yang terlihat sebelum user merasa perlu melawan dengan uninstall. Tiga kontrak di bawah ini masing-masing menjawab satu bagian dari itu.
Kontrak 1: Frequency Capping Notifikasi dengan Counter Redis
Frequency cap menjawab bagian habituation. Aturannya sederhana: setiap user punya kuota notifikasi per kanal per hari, dan begitu kuota habis, job pengirim berhenti mencoba sampai hari berikutnya. Redis cocok untuk ini karena INCR atomic, dan EXPIRE membuat counter membersihkan dirinya sendiri tanpa perlu job pembersih terpisah.
// src/frequency-cap.ts
import Redis from "ioredis";
const redis = new Redis(process.env.REDIS_URL ?? "redis://localhost:6379");
export type Channel = "push" | "email" | "sms";
// Batas kirim per kanal per hari. Ini contoh ilustratif,
// sesuaikan dengan kebijakan notifikasi produk Anda sendiri.
const DAILY_LIMIT: Record<Channel, number> = {
push: 3,
email: 2,
sms: 1,
};
function dailyKey(userId: string, channel: Channel): string {
// YYYY-MM-DD mengikuti timezone server; pastikan semua instance job
// memakai timezone yang sama supaya kuota tidak reset di jam yang berbeda-beda
const today = new Date().toISOString().slice(0, 10);
return `freq:{${userId}}:${channel}:${today}`;
}
/**
* Cek sekaligus catat satu percobaan kirim.
* Mengembalikan true kalau masih di bawah kuota hari ini, false kalau sudah penuh.
*/
export async function withinDailyCap(userId: string, channel: Channel): Promise<boolean> {
const key = dailyKey(userId, channel);
const count = await redis.incr(key);
if (count === 1) {
// baris pertama hari ini: pasang TTL 26 jam, beri jeda untuk clock drift antar server
await redis.expire(key, 26 * 60 * 60);
}
return count <= DAILY_LIMIT[channel];
}
Beberapa keputusan yang sengaja saya buat di sini:
- Kunci per kanal, bukan satu kunci gabungan. Push, email, dan SMS punya tingkat keterpaksaan yang berbeda bagi user. Push notification mudah di-dismiss, SMS terasa lebih mengganggu karena masuk ke jalur yang sama dengan pesan dari orang lain. Membatasi per kanal memungkinkan kebijakan yang berbeda untuk masing-masing.
- TTL 26 jam, bukan 24 jam. Kalau job pengirim berjalan di beberapa server dengan jam yang sedikit tidak sinkron, TTL yang pas-pasan di 24 jam bisa membuat counter mati lebih cepat dari yang diniatkan, lalu kuota diam-diam ter-reset di tengah hari. Dua jam ekstra adalah jaring pengaman murah.
- Race condition di sini bukan masalah besar. Kalau dua proses meng-
INCRdi milidetik yang sama, hasil terburuknya satu notifikasi ekstra terkirim hari itu, lalu kuota tetap berfungsi normal besok. Ini jauh berbeda dari kasus stok yang oversell, jadi saya tidak membungkusnya dalam Lua script. Kalau kanal Anda punya biaya kirim yang mahal per pesan (API SMS pihak ketiga misalnya), pertimbangkan membungkusINCRdan pengecekan batas dalam satu Lua script agar benar-benar atomic.
Satu hal yang perlu ditegaskan: frequency cap ini adalah batas volume, bukan pengganti persetujuan. Ia menjawab “berapa kali boleh dihubungi hari ini”, bukan “apakah boleh dihubungi soal topik ini sama sekali”. Jawaban untuk pertanyaan kedua ada di kontrak berikutnya.
Kontrak 2: Preferensi Notifikasi Pengguna di Preference Center
Reactance berkurang ketika user merasa kendali ada di tangan mereka. Preferensi notifikasi pengguna, yaitu pilihan kanal dan topik yang mereka tetapkan sendiri, hidup di preference center, halaman tempat user memilih kanal dan topik notifikasi yang mereka mau, adalah bentuk paling jelas dari kendali itu. Masalah yang sering saya lihat bukan di desain halamannya, tapi di belakangnya: preferensi yang dipilih user tersimpan rapi di database, tapi job pengirim campaign tidak pernah mengecek tabel itu sebelum mengirim.
Skemanya sengaja saya buat granular di dua dimensi, kanal dan topik, karena mematikan “semua notifikasi” dan mematikan “notifikasi promo saja” adalah dua kebutuhan yang berbeda:
CREATE TABLE notification_preferences (
user_id BIGINT NOT NULL,
channel TEXT NOT NULL CHECK (channel IN ('push', 'email', 'sms')),
topic TEXT NOT NULL, -- misalnya 'promo', 'transactional', 'produk_baru'
opted_in BOOLEAN NOT NULL DEFAULT TRUE,
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
PRIMARY KEY (user_id, channel, topic)
);
Lalu satu fungsi yang dipanggil setiap job pengirim, sebelum frequency cap dan sebelum request ke penyedia kanal mana pun:
// src/preference-center.ts
import { Pool } from "pg";
const pool = new Pool({ connectionString: process.env.DATABASE_URL });
export async function isOptedIn(
userId: string,
channel: string,
topic: string,
): Promise<boolean> {
const { rows } = await pool.query(
`SELECT opted_in FROM notification_preferences
WHERE user_id = $1 AND channel = $2 AND topic = $3`,
[userId, channel, topic],
);
// Belum pernah diatur user berarti belum ada baris; anggap opt-in
// sebagai default sampai user memilih mematikannya sendiri.
return rows.length === 0 ? true : rows[0].opted_in;
}
Fungsi ini sengaja ditaruh di satu modul yang bisa diimpor semua job, bukan diduplikasi di tiap worker campaign. Praktik yang saya lihat berulang kali: tim marketing punya job pengirim sendiri, tim yang mengurus notifikasi transaksional punya job sendiri, dan keduanya tidak memanggil fungsi pengecekan yang sama. Hasilnya, user yang sudah mematikan topik “promo” tetap menerima broadcast dari campaign yang jobnya ditulis terpisah dan lupa memanggil pengecekan ini.
Gabungkan dengan frequency cap di satu wrapper, supaya setiap job pengirim promo cukup memanggil satu fungsi dan tidak bisa lupa salah satu lapisannya:
// src/send-promo.ts
import { withinDailyCap, type Channel } from "./frequency-cap";
import { isOptedIn } from "./preference-center";
export async function sendPromoIfAllowed(
userId: string,
channel: Channel,
send: () => Promise<void>,
): Promise<"sent" | "opted_out" | "capped"> {
if (!(await isOptedIn(userId, channel, "promo"))) return "opted_out";
if (!(await withinDailyCap(userId, channel))) return "capped";
await send();
return "sent";
}
Notifikasi transaksional, seperti konfirmasi pembayaran, biasanya memakai topik terpisah (transactional) yang defaultnya tidak ditampilkan sebagai pilihan opt-out di preference center, karena berkaitan langsung dengan transaksi yang sedang berjalan. Keputusan topik mana yang boleh dimatikan user sepenuhnya urusan kebijakan produk, tapi pemisahannya di skema harus ada sejak awal. Menambahkan kolom topik belakangan, setelah semua job terlanjur menganggap satu user hanya punya satu saklar on/off, jauh lebih menyakitkan daripada merancangnya granular sejak baris pertama.
Kontrak 3: List-Unsubscribe One-Click Sesuai RFC 8058
Preference center menyelesaikan kendali untuk user yang mau repot membuka pengaturan aplikasi. Untuk email, ada jalan yang lebih pendek lagi: tombol unsubscribe yang disediakan langsung oleh email client, di sebelah nama pengirim, sebelum email dibuka sama sekali. Ini yang diatur RFC 8058, An HTTP-Based One-Click Unsubscribe Method.
Dua header yang dibutuhkan:
List-Unsubscribe: <https://notifikasi.contoh.id/unsubscribe?token=abc123>, <mailto:[email protected]?subject=unsubscribe>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
List-Unsubscribe sendiri sudah lama ada dan bisa berisi URL atau alamat mailto. Yang membuatnya “satu klik” adalah List-Unsubscribe-Post: header ini memberi tahu email client bahwa server siap menerima permintaan POST ke URL tersebut, dengan body List-Unsubscribe=One-Click, tanpa perlu membuka halaman apa pun. Email client yang mendukungnya (Gmail dan Yahoo Mail termasuk di antaranya) akan menampilkan tombol unsubscribe yang bekerja dalam satu klik, tanpa user meninggalkan inbox-nya.
Endpoint di sisi server untuk menerima klik itu:
// src/unsubscribe-endpoint.ts
import express from "express";
import { verifyUnsubscribeToken } from "./token"; // fungsi verifikasi token Anda sendiri
const app = express();
app.use(express.urlencoded({ extended: false })); // body POST dari RFC 8058 berupa form-urlencoded
app.post("/unsubscribe", async (req, res) => {
const token = req.query.token as string | undefined;
const payload = token ? verifyUnsubscribeToken(token) : null;
// Token tidak valid atau kedaluwarsa: tetap balas 200 agar email client
// tidak menampilkan error ke user, tapi jangan proses apa pun.
if (!payload) {
res.sendStatus(200);
return;
}
await markOptedOut(payload.userId, payload.channel, payload.topic);
res.sendStatus(200);
});
async function markOptedOut(userId: string, channel: string, topic: string) {
// Implementasi nyata: UPSERT ke notification_preferences, set opted_in = false
}
Tiga syarat dari RFC 8058 yang paling sering dilanggar kalau endpoint ini dibuat terburu-buru:
- Tidak boleh meminta login atau konfirmasi tambahan. Permintaan
POSTini datang dari email client, bukan dari browser user yang sedang login. Kalau endpoint mengembalikan halaman login atau butuh sesi, proses satu klik gagal total dan user tetap menerima email berikutnya. - Harus diproses secepatnya, bukan diantrekan tanpa batas. RFC tidak menetapkan angka pasti, tapi prinsipnya permintaan ini harus ditangani sebagai niat yang mendesak. Mengantrekannya ke job batch yang jalan sekali sehari berarti user yang sudah klik unsubscribe pagi ini tetap menerima email sore ini.
- Token di URL harus bisa diverifikasi tanpa bergantung pada sesi browser, karena yang mengirim request adalah infrastruktur email client, bukan user yang sedang memegang cookie sesi aplikasi Anda.
Aturan Pengirim Massal Gmail dan Yahoo
Sejak keduanya memperbarui persyaratan untuk pengirim email massal, Gmail dan Yahoo mewajibkan dukungan unsubscribe satu klik sesuai RFC 8058 ini sebagai salah satu syarat agar email Anda diperlakukan sebagai pengirim tepercaya, bersama autentikasi SPF, DKIM, dan DMARC, serta menjaga keluhan spam tetap rendah. Detail ambang batas dan cakupannya (misalnya berapa email per hari yang membuat sebuah domain dianggap “pengirim massal”) sebaiknya Anda cek langsung di halaman resmi masing-masing, karena ketentuan semacam ini bisa diperbarui dari waktu ke waktu: baca Email sender guidelines dari Google dan Sender Best Practices dari Yahoo. Saya sengaja tidak mengutip angka pastinya di sini agar tulisan ini tidak menjadi sumber angka yang kedaluwarsa.
Poin praktisnya untuk tim engineering: kalau email promo Anda belum punya dua header ini, perbaikannya bukan proyek besar. Ini satu baris tambahan di template header email plus satu endpoint kecil seperti di atas, dan dampaknya langsung terasa pada seberapa mudah user keluar dari daftar kirim Anda tanpa harus menandai email sebagai spam, yang justru merusak reputasi pengirim domain Anda jangka panjang.
Menyatukan Tiga Kontrak di Satu Alur Pengiriman
Urutan pengecekan penting. Preference center dicek lebih dulu karena itu keputusan eksplisit user, lalu frequency cap, baru kirim dengan header unsubscribe terpasang:
job pengirim promo
-> isOptedIn(user, channel, "promo")? tidak -> berhenti, catat sebagai "opted_out"
-> withinDailyCap(user, channel)? tidak -> berhenti, catat sebagai "capped", coba besok
-> kirim lewat provider kanal
-> email: sertakan List-Unsubscribe + List-Unsubscribe-Post
-> push: sertakan deep link ke preference center di action button
-> catat sebagai "sent"
Mencatat ketiga hasil ini (opted_out, capped, sent) per user per hari berguna di luar debugging. Kalau rasio capped naik tajam menjelang Black Friday, itu sinyal tim campaign sedang mengantre lebih banyak pesan daripada kuota yang tersedia, dan keputusan untuk menaikkan DAILY_LIMIT atau menunda sebagian campaign sebaiknya diambil sadar, bukan ditemukan belakangan lewat lonjakan uninstall.
Untuk pembatasan laju pengiriman yang lebih umum, bukan khusus per user per hari, misalnya melindungi provider SMS atau email dari lonjakan request per detik, pola token bucket atau sliding window yang saya bahas kolega saya di tulisan soal rate limiting token bucket dan sliding window tetap relevan sebagai lapisan terpisah di depan provider. Frequency cap di tulisan ini menjawab pertanyaan berbeda: bukan seberapa cepat sistem boleh mengirim, tapi seberapa sering satu orang boleh dihubungi.
Checklist Sebelum Gelombang Promo Berikutnya
- Pastikan ada satu titik frequency cap per user per kanal per hari, bukan batas yang hanya diatur sendiri-sendiri oleh tiap vendor kanal.
- Pisahkan topik di preference center, minimal
promodantransactional, dan pastikan semua job pengirim, lama maupun baru, memanggil fungsi pengecekan yang sama. - Pasang
List-UnsubscribedanList-Unsubscribe-Postdi setiap email promo, dan uji endpoint-nya menerimaPOSTtanpa login. - Cek dokumentasi resmi Gmail dan Yahoo untuk syarat pengirim massal terbaru, dan pastikan autentikasi SPF, DKIM, DMARC domain pengirim Anda sudah benar.
- Log hasil tiap percobaan kirim (
sent,capped,opted_out) supaya tim campaign punya data, bukan tebakan, saat memutuskan menaikkan volume kiriman.
Setelah lonjakan notifikasi 11.11 ini, pertanyaan yang lebih berguna untuk tim produk bukan “bagaimana supaya lebih banyak orang membuka notifikasi promo berikutnya”, tapi “apakah orang yang tidak mau lagi dihubungi punya jalan keluar yang sama mudahnya dengan jalan masuk yang kita buat untuk mereka”. Kalau jawabannya ya, uninstall jadi pilihan terakhir, bukan satu-satunya pilihan yang terlihat.
Ditulis oleh Tania Hartono