Tautan berhenti berlangganan

Penerima email marketing Anda memiliki dua cara untuk berhenti berlangganan: tombol berhenti berlangganan yang ditampilkan oleh penyedia kotak masuk mereka, dan tautan di dalam isi pesan. Kami memasang keduanya pada setiap pengiriman marketing, melaporkan setiap opt-out sebagai event webhook, dan mencatat opt-out alamat tersebut agar kampanye Anda berikutnya melewatinya. Mengatur kategori dengan benar adalah satu-satunya bagian yang menjadi tanggung jawab Anda.

Atur kategori

Berhenti berlangganan hanya bermakna untuk email yang bisa di-opt-out oleh penerima, itulah mengapa kategori harus diatur lebih dulu. Pengiriman bersifat category: "marketing" secara default, sehingga email kampanye, newsletter, dan pengumuman ditangani dengan benar tanpa pekerjaan tambahan. Atur category: "transactional" secara eksplisit pada email operasional, dan kami tidak menyentuhnya. Email tanda terima atau reset kata sandi tidak memiliki tautan berhenti berlangganan dan tidak pernah diblokir oleh opt-out sebelumnya.

Dua kewajiban mendasari hal ini. Pengirim massal diwajibkan oleh Gmail dan Yahoo untuk menyediakan berhenti berlangganan sekali klik pada email marketing, dan tautan yang terlihat di dalam isi pesan diwajibkan secara terpisah oleh hukum di sebagian besar pasar. Pengiriman marketing memiliki keduanya.

Tombol berhenti berlangganan sekali klik

Ini adalah kontrol berhenti berlangganan yang ditampilkan oleh penyedia kotak masuk di header pesan. Kontrol ini berasal dari sepasang header, List-Unsubscribe dan List-Unsubscribe-Post, dan penyedia hanya menawarkan versi sekali ketuk jika keduanya ada dan endpoint opt-out menerima POST tanpa autentikasi serta tanpa langkah konfirmasi. Itulah kontrak yang diperiksa oleh Gmail dan Yahoo.

Email marketing dikirim dengan header tersebut sudah terpasang, apa pun cara Anda mengirimnya: broadcast dari dashboard, atau pesan marketing melalui POST /v1/email/messages. Tidak perlu membangun apa pun, tidak perlu hosting apa pun.

Karena kami mengelola pasangan header tersebut pada email marketing, mengatur List-Unsubscribe atau List-Unsubscribe-Post Anda sendiri pada pengiriman marketing akan ditolak dengan 422. Pada pengiriman transactional kami tidak menambahkan header berhenti berlangganan, dan Anda dapat mengatur milik Anda sendiri melalui field headers jika ada alasan untuk itu.

Penerima yang menggunakan tombol dari penyedia menghasilkan event email.list_unsubscribed.

Tautan di dalam isi pesan

Jalur kedua adalah tautan berhenti berlangganan yang terlihat di dalam pesan itu sendiri. Kami menambahkannya ke body HTML pada pengiriman marketing Anda, sehingga penerima selalu memiliki sesuatu untuk diklik. Anda juga dapat menambahkan tautan Anda sendiri yang mengarah ke pusat preferensi yang Anda hosting, dan tautan kami tetap ada di sampingnya sebagai standar kepatuhan minimum.

Secara default, tautan muncul sebagai footer kecil di akhir body. Untuk memilih posisinya sendiri, letakkan variabel cadangan {{ bird.unsubscribe_url }} di tempat tautan seharusnya berada:

Contoh kode

<p>
  You received this because you subscribed to our newsletter. You can {{ bird.unsubscribe_url }} at
  any time.
</p>

Kami kemudian merender tautan di posisi tersebut alih-alih menambahkan footer, sebagai anchor dengan teks "unsubscribe". Anda juga dapat menggunakannya sebagai nilai href (<a href="{{ bird.unsubscribe_url }}">Leave this list</a>) untuk mempertahankan kata-kata dan gaya Anda sendiri.

Substitusi terjadi hanya pada salinan yang dikirim, sehingga membaca pesan kembali melalui API mengembalikan konten asli Anda dengan variabel tetap utuh.

Kustomisasi halaman tujuan di Email > Unsubscribe page. Atur nama pengirim, warna latar belakang, teks, dan tombol. Nama pengirim default-nya adalah nama organisasi Anda. Gunakan tautan contoh untuk melihat pratinjau hasilnya.

Penerima yang menggunakan tautan di dalam isi pesan menghasilkan event email.unsubscribed, berbeda dari email.list_unsubscribed sehingga Anda dapat membedakan kedua jalur tersebut.

Apa yang dilakukan opt-out

Kami berhenti mengirim email ke penerima tanpa Anda perlu bertindak atas webhook. Kedua event mencatat alamat penerima sebagai berhenti berlangganan dari email non-transaksional, yang berarti:

Pengiriman marketing ke alamat tersebut ditolak dengan email.rejected dan rejection_reason: "recipient_suppressed". Alasan tersebut melaporkan semua pemblokiran tingkat penerima, baik supresi maupun preferensi yang dinyatakan, jadi itulah yang harus Anda cocokkan dalam kedua kasus.
Pengiriman transactional tetap berhasil, karena berhenti berlangganan berarti penerima tidak ingin menerima kampanye lagi. Alamat itu sendiri tetap berfungsi.

Berhenti berlangganan adalah preferensi yang dinyatakan, bukan supresi: ditampilkan di tab Preferences pada Email > Suppressions, dan di halaman detail kontak, bukan di daftar supresi. Hanya alamat tersebut yang terpengaruh, dan catatan menunjukkan siapa yang berhenti berlangganan dan kapan.

Event webhook memungkinkan Anda mencerminkan opt-out ke database Anda sendiri, mengubah flag langganan, atau mencatatnya. Keduanya menyertakan field identifikasi dari setiap event email: email_id, recipient_id, workspace_id, alamat recipient, dan recipient_role-nya. Keduanya juga menyertakan tags dan metadata dari pengiriman asli, sehingga Anda dapat mencocokkan dengan catatan Anda tanpa pencarian tambahan, serta broadcast_id yang menyebutkan broadcast tempat email dikirim, atau null jika pengiriman tidak memiliki broadcast di belakangnya. Tautan berhenti berlangganan dari email yang dikirim sebelum kami menambahkan field tersebut tidak menyebutkan broadcast, sehingga opt-out melalui tautan semacam itu melaporkan null pada kedua event terlepas dari apakah broadcast yang mengirim email tersebut. Berlangganan event ini sama seperti event email lainnya; referensi event memiliki payload lengkapnya.

Berhenti berlangganan adalah pernyataan penerima sendiri, sehingga Anda tidak dapat menghapusnya melalui API supresi seperti halnya menghapus supresi. Untuk melanjutkan pengiriman ke alamat tersebut, catat opt-in di Contacts > Preferences, atau panggil POST /v1/preferences dengan status: granted. Halaman seluruh workspace tersebut mencatat pernyataan untuk setiap channel, sementara tab di Email > Suppressions menampilkan pernyataan email. Bagaimanapun, mengesampingkan opt-out mereka memerlukan consented_at, yaitu momen penerima memberikan persetujuan, dan opt-in hanya berlaku jika momen tersebut setelah opt-out yang dibatalkannya.

Langkah selanjutnya

Kategori: mengapa marketing adalah yang membuat berhenti berlangganan berlaku
Supresi: daftar fakta keterkiriman, dan perbedaannya dengan preferensi yang dinyatakan
Event email: payload lengkap email.unsubscribed dan email.list_unsubscribed
Persyaratan Gmail dan Yahoo: di mana berhenti berlangganan sekali klik diwajibkan untuk pengirim massal
Webhook: mendaftarkan endpoint, verifikasi tanda tangan, dan percobaan ulang

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