حذف بيانات شخص
إذا طلب منك أحد تحذف بياناته أو يشوفها، سوّها في datacub بعد: من ملفه في لوحة التحكم، أو من الباك اند حقك.
أنت تقرر إذا الطلب صحيح، و datacub يتولى الشغل. ومن لوحة التحكم بس الملّاك والمدراء يقدرون، وهم مسجّلين دخول بحساباتهم.
من لوحة التحكم
افتح الشخص من صفحة المستخدمون واضغط حذف بيانات هذا الشخص، وبعدها احذف نهائيًا. يشتغل للمستخدم المسجّل وللزائر.
من الباك اند
استدعِ datacub من السيرفر حقك لما يشتغل حذف الحساب عندك، عشان يصير الاثنين مع بعض. استخدم مفتاح قراءة (rk_) حق مساحة العمل سمح له المالك يتعامل مع طلبات الأشخاص، ومعرّف المشروع تلقاه في الإعدادات، عام. تسوّي واحد من مفتاح قراءة جديد تحت مفاتيح القراءة في الإعدادات، الربط، ويظهر لك مرة وحدة بس.
مفتاح القراءة يقرأ التقارير بس في الأساس. وعشان يحذف ويصدّر بيانات الأشخاص، المالك يفعّل له يقدر يحذف ويصدّر بيانات شخص تحت مفاتيح القراءة في الإعدادات، الربط. وبدونها كل الاستدعاءات اللي تحت ترجّع 403 capability_required.
// on your server only: a read key opens your dashboard, never ship it to a browser or app
export async function deleteFromX(userId: string) {
const url = `https://YOUR_DATACUB_HOST/api/backend/projects/${process.env.DATACUB_PROJECT_ID}/persons/user/${encodeURIComponent(userId)}`
const res = await fetch(url, {
method: 'DELETE',
headers: { Authorization: `Bearer ${process.env.DATACUB_READ_KEY}` },
})
if (res.status !== 202) throw new Error(`datacub deletion failed: ${res.status}`)
return (await res.json()) as { id: string; status: 'deleted' | 'held' }
}curl -X DELETE "https://YOUR_DATACUB_HOST/api/backend/projects/$DATACUB_PROJECT_ID/persons/user/user_8f3a2c" \
-H "Authorization: Bearer $DATACUB_READ_KEY"| المسار | وش يحذف |
|---|---|
DELETE /api/backend/projects/:id/persons/user/:userId | مستخدم مسجّل، بالمعرّف اللي تمرّره لـ identify، وكل متصفح وجوال مربوط فيه |
DELETE /api/backend/projects/:id/persons/browser/:anonId | زائر، بالمعرّف اللي في كوكي datacub_id_<key> |
الرد 202 ومعه { "id": "...", "status": "deleted" }، أو "held" وقت الحجز القانوني.
| الخطأ | معناه |
|---|---|
401 unauthenticated | المفتاح غلط أو ملغي، أو مو من مساحة عمل هذا المشروع |
403 capability_required | المالك ما سمح لهذا المفتاح يتعامل مع طلبات الأشخاص |
400 invalid_person | المعرّف مو من النوع اللي يحفظه datacub |
429 rate_limited | أكثر من 60 طلب في الدقيقة لهذا المفتاح؛ انتظر دقيقة |
تصدير بيانات شخص
إذا سألك أحد وش تحفظ عنه، خذ كل اللي يحفظه datacub عنه في ملف JSON واحد:
export async function exportFromX(userId: string) {
const url = `https://YOUR_DATACUB_HOST/api/backend/projects/${process.env.DATACUB_PROJECT_ID}/persons/user/${encodeURIComponent(userId)}/export`
const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.DATACUB_READ_KEY}` } })
if (!res.ok) throw new Error(`datacub export failed: ${res.status}`)
return (await res.json()) as { format: 'datacub.person_export.v1'; traits: Record<string, unknown>; events: unknown[] }
}الملف فيه معرّف المستخدم والمتصفحات المربوطة فيه، وآخر صفاته (الاسم والإيميل والجوال وغيرها)، وأحداث الموافقة، وكل حدث مع خصائصه، وإجاباته على الاستبيانات، وكم ملاحظة يحفظ فريقك عنه (بدون نص الملاحظات). وكل تصدير ينسجّل في سجل التدقيق حق مساحة عملك، بدون معرّف الشخص. ونفس الشيء للزائر: persons/browser/:anonId/export.
لما أحد يسحب موافقته
إذا سحب المستخدم موافقته في مكان يشوفه الباك اند حقك (إعدادات الحساب، أو طلب للدعم)، بلّغ datacub. و datacub يحذف اللي جمعه بنفس الطريقة:
// anon_id is the Guest ID from the datacub_id_<key> cookie (<key>: 8 characters of your pk_ key after pk_live_) your own server receives; or send user_id
export async function revokeInX(who: { user_id: string } | { anon_id: string }) {
const url = `https://YOUR_DATACUB_HOST/api/backend/projects/${process.env.DATACUB_PROJECT_ID}/consent/revoke`
const res = await fetch(url, {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.DATACUB_READ_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify(who),
})
if (res.status !== 202) throw new Error(`datacub revoke failed: ${res.status}`)
}وفي المتصفح استدعِ بعد datacub.consent.revoke() عشان الـ SDK يوقف ويمسح الكوكيز حقته (الموافقة).
وش ينحذف، ومتى
فورًا: أحداث الشخص وصفاته، والربط بين متصفحاته وجوالاته ومعرّف المستخدم، وملاحظاتك عنه، وإجاباته على الاستبيانات، وسجل مين فتح ملفه. ويختفي من كل تقرير ومسار تحويل وملف شخصي على طول.
بعد 48 ساعة: datacub يحذف مرة ثانية، عشان يلقط الأحداث اللي كانت للحين في الطريق، ويشيل الصفوف من التخزين نهائيًا. والنسخ الاحتياطية اللي كانت فيها تنتهي خلال 35 يوم. وبعدها datacub يحتفظ بس بهاش باتجاه واحد للمعرّف، عشان يثبت إن الطلب انتفّذ، ويعيده إذا انسترجعت نسخة احتياطية.
والحدود اللي يلتزم فيها datacub لكل طلب: فك الربط خلال ساعة، والخروج من كل الإجابات خلال 7 أيام، والحذف من التخزين خلال 30 يوم.
الحجز القانوني
إذا كان datacub ملزم نظاميًا يحتفظ ببيانات مشروع، مثلًا بأمر من المحكمة، يصير المشروع تحت حجز قانوني. والطلبات تنقبل وتنسجّل، وترجع بـ held، وتنفّذ أول ما ينرفع الحجز.
الأحداث الجديدة بعد الحذف
datacub يوقف استقبال الأحداث لمعرّف المستخدم المحذوف، فصفحة باقية مفتوحة ما ترجّع الشخص. ومعرّف الزائر المحذوف ينرفض لمدة 30 يوم.
إذا نفس الشخص سجّل من جديد وتبي تتتبّعه، اسمح لمعرّفه مرة ثانية:
curl -X DELETE "https://YOUR_DATACUB_HOST/api/backend/projects/$DATACUB_PROJECT_ID/tombstones/user/user_8f3a2c" \
-H "Authorization: Bearer $DATACUB_READ_KEY"بس اللي يسويه من هذيك اللحظة ينجمع؛ وما يرجع أي شيء انحذف.