Tracking Preferences: Schreiben
Einstellungen festlegen
Speichern Sie die Tracking-Wahl eines Empfängers, zum Beispiel die Einwilligung, die Sie in Ihren eigenen Formularen oder Ihrem CRM eingeholt haben.
https://g.sendcorex.com/v1/privacycommand: set_preferencesErfordert den Scope privacy:write für Ihren API key.
Senden Sie nur, was sich geändert hat: Ein weggelassenes Feld behält seinen aktuellen Wert. Dieselben Werte erneut zu senden ändert nichts, und changed kommt als false zurück.
Hier vorgenommene Änderungen werden im Verlauf mit source: "api" gespeichert. Sie lösen den Webhook tracking_preferences_updated nicht aus, sodass eine CRM-Synchronisation nie in eine Schleife gerät.
Argumente
emailstringerforderlichDie Empfängeradresse.
z. B.
"jane.doe@example.com"track_opensbooleanoptionaltrueerlaubt das Tracking von Öffnungen,falselehnt es ab.z. B.
truetrack_clicksbooleanoptionaltrueerlaubt das Tracking von Klicks,falselehnt es ab.z. B.
true
Schnellstart
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);Antwort
{
"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"
}
}
}
]
}Antwortfelder
changedfalse, wenn der Empfänger diese Werte bereits hatte (nichts wurde geschrieben).preferenceDer Zustand nach dem Aufruf.
preference.emailDie Empfängeradresse, in Kleinbuchstaben.
preference.track_openstrueder Empfänger erlaubt das Tracking von Öffnungen,falseer hat es abgelehnt,nuller hat nie gewählt.preference.track_clickstrueder Empfänger erlaubt das Tracking von Klicks,falseer hat es abgelehnt,nuller hat nie gewählt.preference.sourceWer die Änderung vorgenommen hat:
page(der Empfänger, auf der Seite für Tracking-Präferenzen),api(Sie, mit Set Preferences) oderdashboard.preference.updated_atWann die Änderung erfolgte. ISO 8601, UTC.
Wie es sich auf Ihre Sendungen auswirkt
Ablehnung hat immer VorrangWenn
track_opensodertrack_clicksfalseist, wird dieses Tracking aus der E-Mail weggelassen, auch wenn Ihr Versand es mit"track_opens": trueanfordert.Nie gewähltWenn der Wert
nullist (oder der Empfänger gar keine Präferenz hat), entscheidet Ihr Versand, genau wie bisher.Erfordert unsere Abmelde-EnginePräferenzen gelten für Sendungen mit
"unsubscribe": true. Das fügt auch den Präferenz-Link in die E-Mail ein.Ihr StandardFür Opt-in-Regeln (zum Beispiel Frankreich) senden Sie
"track_opens": falseund"track_clicks": false, bis der Empfänger es erlaubt hat, und lesen die Präferenz vor dem Senden mit Get Many.
Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
INVALID_API_KEYDer API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 429
RATE_LIMITEDMehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API key. Warten Sie die Anzahl Sekunden aus Retry-After ab.
- CMD
MISSING_SCOPEDer API key hat nicht den Scope dieses Befehls (`privacy:read` zum Lesen, `privacy:write` zum Ändern).
- CMD
INVALID_ARGSEin Argument ist ungültig: fehlende oder fehlerhafte `email`, mehr als 100 `emails`, `track_opens`, das nicht `true`/`false` ist, limit außerhalb des Bereichs…
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.