Kategori

Setiap email yang Anda kirim memiliki kategori yang menyatakan alasan pengiriman, diatur dengan field category pada POST /v1/email/messages. Field ini menerima salah satu dari dua nilai, marketing atau transactional, dan memiliki satu efek: menentukan catatan supresi dan preferensi berhenti berlangganan mana yang boleh memblokir pesan.

Berhenti berlangganan newsletter menyatakan sesuatu tentang email marketing dan tidak menyatakan apa pun tentang reset kata sandi. Kategori adalah cara kami membedakan kedua tujuan tersebut.

Dua kategori

marketing: email yang dipilih penerima untuk diterima dan dapat dipilih untuk dihentikan. Kampanye, newsletter, pengumuman produk, penawaran promosi. Apa pun yang menjadikan "I don't want this anymore" sebagai jawaban yang harus Anda hormati.
transactional: email yang dibutuhkan oleh tindakan penerima sendiri. Reset kata sandi, verifikasi email, kode sekali pakai, tanda terima pesanan, peringatan keamanan dan akun. Email ini harus sampai apa pun preferensi marketing penerima.

Tanyakan apa yang terjadi jika pesan tidak pernah sampai. Jika alur yang dimulai penerima rusak, itu transaksional. Jika Anda yang memulai percakapan, itu marketing.

Keduanya adalah set lengkap: tidak ada API yang membuat atau mengonfigurasi kategori, dan field ini divalidasi terhadap kedua nilai tersebut. Untuk segmentasi yang lebih detail, gunakan tag bersama kategori.

Cara kategori menentukan kebijakan supresi

Aturannya satu baris: marketing diblokir oleh setiap alasan supresi dan oleh opt-out apa pun, sedangkan transactional tetap terkirim meski ada supresi karena komplain atau opt-out khusus marketing. Hard bounce, supresi manual, dan opt-out yang dicatat untuk semua pesan memblokir keduanya.

Asimetri ini mengikuti makna setiap alasan. Hard bounce berarti alamat tidak ada, sehingga pengiriman sia-sia apa pun kategorinya. Supresi manual adalah keputusan tim Anda sendiri, yang tidak pernah kami pertanyakan. Komplain dan berhenti berlangganan adalah preferensi tentang email yang tidak diinginkan: keduanya menghentikan pengiriman marketing Anda, sementara penerima yang melaporkan newsletter Anda sebagai spam tetap menerima reset kata sandi mereka. Pengecualian ini juga disengaja: opt-out dapat dicatat untuk semua pesan, bukan hanya marketing (pilihan Messages to stop pada dialog Record preference, atau coverage: all pada POST /v1/preferences), dan itu berarti penerima meminta keheningan total, sehingga email transaksional juga diblokir.

Penerima yang diblokir ditolak di tempat yang dapat Anda lihat, satu baris per penerima dengan alasan yang dilampirkan. Supresi memuat tabel per alasan dan menjelaskan bagaimana alamat masuk ke daftar.

Default, dan mengapa pengiriman transaksional harus memilih keluar

Jika category dihilangkan, pengiriman dianggap marketing. Ini gagal ke arah yang aman: email yang dikirim tanpa kategori eksplisit menghormati berhenti berlangganan dan komplain serta memiliki tautan berhenti berlangganan, sehingga kampanye sudah sesuai tanpa langkah tambahan.

Dua jalur pengiriman mengambil kategorinya dari tempat lain. Pengiriman yang menggunakan template tersimpan dan menghilangkan category mengambil klasifikasi template itu sendiri, sehingga template yang dibuat sebagai transactional dikirim sebagai transaksional. Atur category pada pengiriman untuk mengklasifikasikan satu pesan secara berbeda, dan nilai pengiriman yang menang. Email yang dikirim melalui SMTP mengambil kategorinya dari konfigurasi SMTP milik key API, yaitu transactional untuk key yang belum Anda konfigurasi.

Jadi email operasional harus memilih keluar. Reset kata sandi yang dikirim tanpa kategori diperlakukan sebagai marketing: email tersebut membawa tautan berhenti berlangganan yang seharusnya tidak ada, dan berhenti berlangganan newsletter memblokirnya meskipun penerima memintanya. Atur category: "transactional" pada tanda terima, reset, kode verifikasi, dan peringatan akun:

Contoh kode

{
  "from": "no-reply@yourdomain.com",
  "to": ["delivered@messagebird.dev"],
  "subject": "Reset your password",
  "html": "<p>Click the link below to reset your password...</p>",
  "category": "transactional"
}

Kategori sebagai dimensi analitik

Kategori tetap melekat pada pesan dan muncul kembali di mana pun pesan ditampilkan, sehingga memecah angka pengiriman, bounce, dan keterlibatan Anda menjadi trafik marketing dan operasional tanpa Anda perlu menandai setiap pengiriman. Daftar pesan memfilter berdasarkan kategori, statistik API memecah metrik berdasarkan kategori, dan log email di dashboard menawarkan filter yang sama.

Langkah selanjutnya

Mengirim email: payload POST /v1/email/messages lengkap, termasuk category
Supresi: daftar supresi, tiga alasan, dan matriks kategori lengkap
Tautan berhenti berlangganan: detail opt-out yang disertakan pengiriman marketing
Referensi API: skema request dan response lengkap

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Tonton panduannyaGetting started with email Jelajahi kemampuannyaEmail Ikuti jalur pembelajaranBuild your first integration Panduan implementasiSend your first email

Coba praktiknya dan dapatkan ringkasan implementasi