Tracking Preferences: Menulis
Atur preferensi
Catat pilihan tracking penerima, misalnya persetujuan yang Anda kumpulkan di formulir atau CRM Anda sendiri.
https://g.sendcorex.com/v1/privacycommand: set_preferencesMembutuhkan scope privacy:write pada API key Anda.
Kirim hanya yang berubah: field yang tidak Anda kirim mempertahankan nilainya saat ini. Mengirim nilai yang sama lagi tidak mengubah apa pun dan changed kembali sebagai false.
Perubahan yang dibuat di sini dicatat dengan source: "api" di riwayat. Perubahan ini tidak memicu webhook tracking_preferences_updated, jadi sinkronisasi CRM tidak pernah berputar-putar.
Argumen
emailstringwajibAlamat penerima.
mis.
"jane.doe@example.com"track_opensbooleanopsionaltruemengizinkan pelacakan open,falsemenolaknya.mis.
truetrack_clicksbooleanopsionaltruemengizinkan pelacakan klik,falsemenolaknya.mis.
true
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/privacy',
{
commands: [
{
command: "set_preferences",
args: {
email: "jane.doe@example.com",
track_opens: true,
track_clicks: true
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Respons
{
"type": "SUCCESS",
"results": [
{
"command": "set_preferences",
"id": "0",
"type": "SUCCESS",
"took_ms": 6,
"data": {
"changed": true,
"preference": {
"email": "jane.doe@example.com",
"track_opens": true,
"track_clicks": true,
"source": "api",
"updated_at": "2026-10-24T08:02:19.744Z"
}
}
}
]
}Field respons
changedfalsejika penerima sudah memiliki nilai-nilai ini (tidak ada yang ditulis).preferenceStatus setelah panggilan.
preference.emailAlamat penerima, dalam huruf kecil.
preference.track_openstruepenerima mengizinkan pelacakan open,falsemenolaknya,nullbelum pernah memilih.preference.track_clickstruepenerima mengizinkan pelacakan klik,falsemenolaknya,nullbelum pernah memilih.preference.sourceSiapa yang melakukan perubahan:
page(penerima, di halaman preferensi tracking),api(Anda, dengan Set Preferences), ataudashboard.preference.updated_atKapan perubahan dilakukan. ISO 8601, UTC.
Pengaruhnya pada pengiriman Anda
Penolakan selalu menangJika
track_opensatautrack_clicksbernilaifalse, tracking tersebut tidak disertakan di email meskipun pengiriman Anda memintanya dengan"track_opens": true.Belum pernah memilihJika nilainya
null(atau penerima tidak punya preferensi sama sekali), pengiriman Anda yang menentukan, persis seperti sebelumnya.Membutuhkan mesin unsubscribe kamiPreferensi diterapkan pada pengiriman dengan
"unsubscribe": true. Itu juga yang menaruh link preferensi di email.Default AndaUntuk aturan opt-in (misalnya Prancis), kirim
"track_opens": falsedan"track_clicks": falsesampai penerima mengizinkannya, dan baca preferensinya dengan Get Many sebelum mengirim.
Error
Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.
- 401
INVALID_API_KEYAPI key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.
- 429
RATE_LIMITEDLebih dari 15 request/dtk atau 15 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.
- CMD
MISSING_SCOPEAPI key tidak memiliki scope perintah ini (`privacy:read` untuk membaca, `privacy:write` untuk mengubah).
- CMD
INVALID_ARGSAda argumen yang tidak valid: `email` tidak ada atau salah format, lebih dari 100 `emails`, `track_opens` yang bukan `true`/`false`, limit di luar rentang…
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.