Gunakan kampanye Seumur Hidup

Apa yang halaman ini bantu lakukan

Buat kampanye Seumur Hidup yang tetap siap untuk peristiwa dari sistem Anda. Setiap pemicu yang valid membuat paling banyak satu eksekusi dan mengirimkan satu dorongan ke kontak dalam payloadnya.

Mengapa hal ini penting

Anda dapat mengirim email yang relevan dan tepat waktu tanpa membuat dan meluncurkan kampanye berulang kali. Backend Anda mengontrol kapan suatu peristiwa terjadi, sementara Nudgen menyimpan konten email, pengiriman, pelacakan, dan preferensi kontak di satu tempat.

Kapan menggunakan kampanye Seumur Hidup

Gunakan kampanye Seumur Hidup untuk email berdasarkan peristiwa, seperti:

Konfirmasi pesanan
Pengingat pembayaran
Orientasi berbasis peristiwa
Pembaruan akun atau langganan

Tidak seperti kampanye sekali pakai dan tetes, kampanye Seumur Hidup tidak kirim ke audiens yang disimpan segera. Audiensnya selalu Pemicu.

Buat dan aktifkan kampanye

Create a Lifetime campaign

Buka Kampanye, klik Kampanye baru, lalu pilih Seumur Hidup. Tambahkan nama kampanye, sasaran, konfigurasi merek, dan tautan CTA opsional.

Define runtime parameters

Tambahkan setiap nilai yang akan diberikan sistem Anda pada waktu pengiriman. Parameter membuat variabel data.*: misalnya, order_id menjadi {{data.order_id}} di email.

Create the email

Buat atau tulis subjek dan HTML, lalu tambahkan variabel runtime di tempatnya. Pratinjau email dan kirim tes sebelum mengaktifkannya.

Activate the campaign

Simpan sebagai draf, lalu klik Aktifkan. Nudgen memeriksa apakah parameter yang diperlukan terwakili dalam email dan kontrak parameter tidak berubah sejak pembuatan.

Create a trigger key

Buka Pengaturan → Kunci API dan buat Kunci API pemicu tim. Simpan rahasia ndg_team_* di backend atau manajer rahasia Anda; jangan pernah menempatkannya di browser atau kode aplikasi seluler.

Parameter runtime dan variabel template

variableManifest Anda adalah kontrak antara template email dan objek data masing-masing pemicu. Sebuah kampanye dapat menentukan hingga 100 variabel.

Bidang	Ketik	Diperlukan	Deskripsi
`path`	`data.<name>`	Ya	Jalur variabel. Jalur bersarang seperti `data.order.total` didukung.
`type`	`string`, `number`, `boolean`, `date`, atau `url`	Ya	Ketik yang harus disediakan oleh pemicu. `date` harus berupa string tanggal yang valid dan `url` harus berupa HTTP(S).
`required`	boolean	Ya	Nilai yang hilang akan mengembalikan `422` kecuali nilai default disetel.
`defaultValue`	string, angka, atau boolean	Tidak	Nilai cadangan yang harus sesuai dengan jenis variabel.
`description`	tali	Tidak	Jelaskan nilainya agar Anda dan Nudgen AI dapat menggunakannya dengan benar.

Misalnya, gunakan {{data.order_id}}, {{data.total}}, dan {{data.order_url}} dalam sebuah template. Anda juga dapat menggunakan contact.*, event.*, brand.*, dan variabel lama seperti {{firstName}} dan {{brandName}}. Nudgen lolos dari nilai variabel yang dimasukkan ke dalam HTML. Templat tidak mendukung JavaScript, ekspresi, atau loop. Variabel apa pun yang digunakan dalam href harus berupa variabel data.* yang dideklarasikan dengan tipe url.

Kelola siklus hidup

Status	Apa artinya
Draf	Konfigurasikan kampanye dan uji emailnya.
Aktif	Nudgen menerima pemicu yang diautentikasi.
Dijeda	Nudgen tidak menerima pemicu baru. Anda dapat melanjutkannya.
Diarsipkan	Kampanye ditutup secara permanen dan tidak dapat diaktifkan kembali.

Transisi yang valid adalah draft → active → paused → active dan active|paused → archived.

Menjeda atau mengarsipkan akan membatalkan eksekusi yang masih tertunda atau dalam antrean. Eksekusi yang sudah diproses mungkin masih terkirim.

Setiap eksekusi mengambil cuplikan konten kampanye dan setelan pengiriman saat Nudgen menerima pemicu. Mengedit kampanye aktif hanya memengaruhi pemicu berikutnya, bukan eksekusi yang sudah ada.

Pemicu dari backend Anda

Panggil titik akhir pemicu dari server tepercaya setelah Anda memvalidasi peristiwa sumber. Gunakan kunci API pemicu tim, bukan Token Akses Pribadi (PAT).

curl -X POST "$NUDGEN_APP_URL/api/v1/campaigns/$CAMPAIGN_ID/triggers" \
  -H "Authorization: Bearer $NUDGEN_TEAM_API_KEY" \
  -H "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "eventId": "order_123",
  "eventName": "order.created",
  "occurredAt": "2026-08-23T10:00:00Z",
  "contact": {
    "email": "an@example.com",
    "externalId": "customer_456",
    "name": "An Nguyen",
    "metadata": { "company": "Nudgen" }
  },
  "data": {
    "order_id": "order_123",
    "total": 490000,
    "order_url": "https://example.com/orders/order_123"
  }
}
JSON

Pertahankan eventId yang sama saat Anda mencoba kembali suatu acara. Nudgen mengembalikan eksekusi yang ada dengan 200 dan duplicate: true alih-alih mengirimkan dorongan lainnya. Eksekusi baru mengembalikan 201.

Integrasikan dengan aman

Pemicu dari konsumen webhook atau backend, dan verifikasi webhook yang masuk sebelum memanggil Nudgen.
Coba lagi kesalahan jaringan, 429, dan 503 dengan backoff eksponensial dan hal yang sama eventId.
Jangan mencatat header atau payload Authorization yang berisi data kontak sensitif.
Putar kunci pemicu secara teratur dan segera cabut kunci jika Anda curiga kunci tersebut terekspos.
Buat satu kampanye per jenis acara dan kontrak variabel sehingga template dan audit eksekusi tetap jelas.

Pantau eksekusi

Buka kampanye di dasbor untuk melihat eksekusi terkini dan statusnya. Eksekusi dapat berupa pending, queued, processing, sent, skipped, cancelled, failed, atau delivery_unknown. skipped berarti kontak berhenti berlangganan atau terpental, sehingga Nudgen mencatat peristiwa tersebut tetapi tidak mengirim atau menggunakan kuota. delivery_unknown berarti penyedia mungkin telah menerima email tetapi hasil akhir pengiriman tidak pasti; Nudgen tidak mencobanya lagi secara otomatis untuk menghindari pengiriman duplikat. Untuk penyiapan terprogram, pemicuan, dan kueri eksekusi, lihat API Pengembang.

Mulai

Kontak

Kampanye

Merek

Dasbor

Pengaturan

Penagihan

Afiliasi

Agents

Pencari Email Prospek (Ekstensi)

Pembuat Tanda Tangan

Pemeriksa Spam

Audit Pengiriman Email

Konsep

Troubleshooting

Keamanan & Privasi

Gunakan kampanye Seumur Hidup

Apa yang halaman ini bantu lakukan

Mengapa hal ini penting

Kapan menggunakan kampanye Seumur Hidup

Buat dan aktifkan kampanye

Parameter runtime dan variabel template

Kelola siklus hidup

Pemicu dari backend Anda

Integrasikan dengan aman

Pantau eksekusi

Dokumen terkait

Campaigns overview

Developer API

​Apa yang halaman ini bantu lakukan

​Mengapa hal ini penting

​Kapan menggunakan kampanye Seumur Hidup

​Buat dan aktifkan kampanye

​Parameter runtime dan variabel template

​Kelola siklus hidup

​Pemicu dari backend Anda

​Integrasikan dengan aman

​Pantau eksekusi

​Dokumen terkait

Campaigns overview

Developer API

Apa yang halaman ini bantu lakukan

Mengapa hal ini penting

Kapan menggunakan kampanye Seumur Hidup

Buat dan aktifkan kampanye

Parameter runtime dan variabel template

Kelola siklus hidup

Pemicu dari backend Anda

Integrasikan dengan aman

Pantau eksekusi

Dokumen terkait