Event webhook · Pelacakan

tracking_preferences_updated

Dikirim saat penerima mengubah pilihan pelacakan open atau klik di halaman preferensi tracking. Penerima tetap menerima email Anda: ini bukan unsubscribe.

i

Dikirim sebagai POST bertanda tangan ke URL webhook Anda. Lihat Penyiapan & event untuk cara memverifikasi tanda tangan.

Payload

// Turned open tracking off (API / SMTP email)
{
  "event": "tracking_preferences_updated",
  "timestamp": "2026-10-24T07:20:12.031Z",
  "data": {
    "recipientEmail": "jane.doe@example.com",
    "trackOpens": false,
    "trackClicks": true,
    "source": "page",
    "updatedAt": "2026-10-24T07:20:12.031Z",
    "trackId": "a41f9c0e7b2d58e6"
  }
}
!

Hanya jika ada perubahan Menyimpan pilihan yang sama lagi tidak mengirim webhook. Perubahan yang Anda buat sendiri dengan Set Preferences juga tidak dikirim, jadi sinkronisasi CRM Anda tidak pernah berputar. Penolakan langsung berlaku untuk pengiriman Anda: email yang dikirim dengan "unsubscribe": true tidak menyertakan pixel dan tautan terlacak untuk penerima tersebut.

i

API Preferensi Tracking Baca satu penerima atau 100 sekaligus, lihat riwayat lengkap seorang penerima, dan ambil setiap perubahan dengan cursor.

Preferensi tracking →

Referensi field

  • event

    Nilai tetap: "tracking_preferences_updated"

  • timestamp

    Kapan perubahan diproses (ISO 8601, UTC).

  • data.recipientEmail

    Penerima yang mengubah preferensinya.

  • data.trackOpens

    true: penerima mengizinkan pelacakan open. false: penerima menolaknya.

  • data.trackClicks

    true: penerima mengizinkan pelacakan klik. false: penerima menolaknya.

  • data.source

    Nilai tetap untuk saat ini: "page" (penerima menggunakan halaman preferensi tracking).

  • data.updatedAt

    Kapan preferensi disimpan (ISO 8601, UTC). Nilainya sama dengan updated_at di API.

  • data.campaignId

    Kampanye dari email tempat penerima berasal. Hanya untuk email kampanye.

  • data.trackId

    Kunci tracking email, untuk email yang dikirim melalui API atau SMTP. Hanya jika tracking aktif untuk pengiriman tersebut.