Sign inGet started

Broadcast

Broadcast mengirim satu email ke seluruh audiens: newsletter, pengumuman, atau konten apa pun yang dikirim ke banyak penerima sekaligus. Anggota audiens diubah menjadi daftar penerima saat pengiriman dimulai, sehingga broadcast menjangkau siapa pun yang menjadi anggota audiens pada saat itu.
Buat broadcast di Email > Broadcasts pada dashboard, melalui /v1/email/broadcasts, atau dengan bird email broadcasts. SDK tidak menyertakan metode broadcast. Untuk daftar penerima sekali pakai, gunakan pengiriman batch atau pengiriman tunggal.

Buat draf

Mulai dari daftar Broadcasts dengan New broadcast. Komposer berupa satu halaman: bar audiens dan pengirim di atas, konten email di bawahnya, dan kontrol pengaturan untuk kategori, pelacakan, dan tag. Tidak ada langkah simpan terpisah. Setiap perubahan tersimpan otomatis setelah broadcast memiliki audiens dan pengirim, sehingga draf sudah ada begitu keduanya diatur, dan mengirimnya nanti adalah tindakan terpisah yang eksplisit.
Gunakan kolom To untuk memilih audiens, atau pilih New untuk membuat audiens baru tanpa meninggalkan komposer.
Buka kontrol pengaturan di header komposer untuk tiga hal lagi:
  • Sakelar pelacakan buka dan klik.
  • Hingga 20 tag, masing-masing berisi nama dan nilai, untuk memfilter broadcast ini nantinya.
  • Kategori, yang secara default bernilai marketing.

Alamat From

Broadcast dikirim dari alamat pada domain pengirim terverifikasi. Pasangkan local part dengan salah satu domain terverifikasi Anda, dan tambahkan display name jika diperlukan. Tambahkan alamat Reply-To jika Anda ingin balasan diarahkan ke tempat lain. Memilih Review akan memperingatkan Anda jika domain belum terverifikasi.

Template

Broadcast merujuk ke salah satu template email di workspace Anda, dan template tersebut memiliki baris subjek serta isi yang dikirim oleh broadcast. Properti kontak setiap penerima mengisi variabel template saat pengiriman berjalan, sehingga satu broadcast mempersonalisasi kontennya per penerima. Broadcast hanya dapat mengisi properti kontak, sehingga variabel template yang merujuk hal lain akan ditolak saat Anda mengirim, dan pesan error menyebutkan nama variabel tersebut.
Tulis konten langsung di kanvas di bawah baris subjek, atau pilih Choose a template untuk memulai dari template yang sudah ada. Opsi ini hanya tersedia selama broadcast masih kosong, karena memilih template setelah Anda menulis subjek atau isi akan menimpa konten tersebut. Broadcast mengirim versi template yang sudah dipublikasikan, sehingga template yang hanya memiliki draf tidak bisa digunakan untuk pengiriman.

Kirim atau jadwalkan

Pengiriman adalah tindakan terpisah yang eksplisit, tersedia dari tombol Review di komposer atau dari halaman detail broadcast melalui Send or reschedule. Keduanya membuka dialog yang memeriksa kelengkapan broadcast, memperingatkan Anda tentang hal yang kemungkinan membuat pengiriman gagal, lalu memungkinkan Anda memilih Send now atau memilih waktu hingga satu tahun ke depan. Broadcast terjadwal tetap dapat diedit, dan Anda bisa menjadwalkan ulang hingga pengiriman benar-benar dimulai.
Pengiriman memeriksa apakah audiens masih memiliki seseorang untuk dijangkau. Audiens yang tidak ada satu pun anggotanya memiliki alamat email, atau semua alamatnya di-suppress, akan ditolak pada tahap ini alih-alih gagal belakangan.
Dua batas di tingkat organisasi diperiksa saat Anda mengirim.
Yang pertama adalah berapa banyak broadcast yang dapat Anda kirim dalam satu periode penagihan. Paket Anda menentukan jumlahnya. Draf tersimpan tidak dihitung, dan membatalkan broadcast tidak mengembalikan jatah. Setelah jatah habis, Anda harus menunggu periode penagihan berikutnya atau beralih ke paket dengan batas lebih tinggi.
Yang kedua membatasi broadcast yang berjalan bersamaan. Jika Anda memilih Send now saat batas sudah tercapai, permintaan ditolak. Broadcast terjadwal menunggu slot yang tersedia.

Temukan broadcast

Cari daftar berdasarkan tag atau nama template, atau filter berdasarkan status, audiens, atau rentang tanggal. Rentang tanggal memfilter berdasarkan kapan broadcast dibuat, bukan kapan dikirim, sehingga broadcast yang Anda jadwalkan minggu lalu untuk pengiriman bulan depan tetap muncul di bawah "Last 7 days."
Ekspor tampilan saat ini sebagai CSV dari tombol di atas tabel. Di atas 50.000 baris, ekspor ditolak alih-alih dipotong diam-diam. Persempit filter dan coba lagi.

Status broadcast

Broadcast selalu berada di salah satu dari empat tahap, dan filter Status pada daftar menggunakan keempat tahap tersebut:
TahapPosisi broadcastNilai status
DraftDisimpan tanpa berkomitmen untuk mengirimdraft
ScheduledDikomit dengan waktu kirim di masa depan, masih bisa dieditscheduled
SendingSedang dikirim, atau sedang dibatalkanaccepted, sending, canceling
CompletedSelesai, baik terkirim, dibatalkan, maupun gagalsent, canceled, failed
Badge setiap baris menunjukkan status persis dalam tahapnya. Nilai yang sama itulah yang dikembalikan oleh field status pada API.

Batalkan atau hapus

Batalkan broadcast terjadwal atau yang sedang dikirim dari halaman detailnya. Penerima yang belum dijangkau akan dilewati, dan pesan yang sudah dalam perjalanan tidak bisa ditarik kembali. Hapus hanya berfungsi pada draf, dan bersifat permanen.

Ketika broadcast gagal

Broadcast yang gagal menampilkan alasannya di halaman detail: reason, lalu kalimat yang menyebutkan penyebab pastinya. Melalui API, keduanya adalah field failure_reason dan failure_detail. failure_detail memberi tahu Anda penyebab spesifik mana dari beberapa kemungkinan penyebab suatu reason yang sebenarnya terjadi.
Konfigurasi pengiriman broadcast hanya diperiksa saat pengiriman dimulai. Jika domain pengirim sudah terverifikasi saat penjadwalan tetapi kehilangan verifikasi sebelum pengiriman, broadcast gagal pada saat itu. Verifikasi domain tersebut dan kirim ulang broadcast.
failure_reasonApa yang terjadiYang harus dilakukan
content_invalidBroadcast tidak dapat disiapkan untuk dikirim. Penyebabnya lebih sering dari konfigurasi daripada konten: domain pengirim belum terverifikasi, template tidak ada atau belum dipublikasikan, template memiliki loop, atau IP pool tidak tersediaPerbaiki apa yang disebutkan failure_detail, lalu kirim ulang
empty_audienceAudiens tidak memiliki anggota, atau supresi mengecualikan semua anggotaTambahkan anggota, atau periksa supresi Anda
audience_unavailableAudiens sudah tidak ada lagiArahkan broadcast ke audiens lain
quota_exceededPengiriman melampaui jatah email harian atau bulanan organisasi Anda, baik sebelum dimulai maupun di tengah prosesTunggu jatah direset, persempit audiens, atau upgrade
insufficient_fundsSaldo workspace tidak mencukupi untuk pengirimanIsi ulang wallet
internal_errorTerjadi kesalahan di sisi kamiCoba lagi, dan buka tiket dukungan jika terulang
Broadcast dan pengiriman tunggal menggunakan jatah email yang sama. Kartu paket di ringkasan penagihan organisasi Anda menunjukkan berapa banyak yang sudah terpakai. Paket dan harga membahas apa saja yang termasuk di setiap paket.

Pantau pengiriman

Setelah pengiriman dimulai, tab Overview broadcast menampilkan jumlah penerima dan terkirim, lalu rasio pengiriman, buka, klik, bounce, dan keluhan beserta jumlahnya. Tab Recipients mencantumkan setiap penerima beserta status pengirimannya, alasan jika tidak terkirim, waktu pengiriman, serta buka dan kliknya. Kotak pencarian memerlukan alamat email lengkap dan valid; alamat parsial atau domain saja gagal validasi, menandai kotak sebagai tidak valid, dan membiarkan tabel menampilkan apa pun yang ditampilkan sebelumnya. Tombol di atas tabel mengekspor tab sebagai CSV, dibatasi 200.000 baris dengan perilaku tolak-alih-alih-potong yang sama seperti ekspor daftar broadcast. Tab Events adalah feed event mentah broadcast, menggunakan jenis event yang dijelaskan di event dan webhook.

Uji coba broadcast

Masukkan alamat sandbox ke dalam audiens dan kontak tersebut disimulasikan alih-alih benar-benar dikirim: delivered@messagebird.dev melaporkan terkirim, bounce@messagebird.dev melaporkan bounce, dan masing-masing menghasilkan event dan webhook yang sama seperti penerima asli. Ini cara Anda menguji kampanye, dan handler yang membaca event-nya, tanpa mengirim email ke siapa pun. Audiens dapat mencampurkan kontak sandbox dan kontak asli; setiap kontak mendapatkan hasilnya sendiri. Penerima simulasi tetap dihitung terhadap jatah pengiriman Anda, sehingga uji coba menggunakan kuota yang sama seperti pengiriman sesungguhnya.

Langkah selanjutnya

Sumber daya terkait

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

Dapatkan ringkasan implementasi