طلب الموافقة (اختياري)

افتراضيًا datacub يتتبّع من أول مشاهدة صفحة. ما فيه نافذة تربطها ولا استدعاء تسويه. وإذا تبي تنتظر موافقة زوارك أول، تقدر تفعّل هالخيار.

هل تحتاج الموافقة أو لا يعتمد على موقعك وعلى مستخدميك. فعّله إذا كنت تجمع الموافقة.

كيف تفعّله

  1. في مشروعك افتح الإعدادات وفعّل اطلب الموافقة قبل التتبع.
  2. أضف requireConsent: true في datacub.init. وفي وسم السكربت أضف الخاصية data-require-consent بدالها.
  3. استدعِ datacub.consent.grant() لما يوافق الزائر، و datacub.consent.revoke() لما يسحب موافقته.
datacub.init('pk_live_YOUR_PROJECT_KEY', { requireConsent: true })

// the visitor accepted analytics
datacub.consent.grant({ method: 'banner', policyVersion: '2026-10' })

// the visitor withdrew it later
datacub.consent.revoke()

مع وسم السكربت:

<script src="https://ingest.datacub.example/v1/sdk/datacub-0.4.0.min.js" data-key="pk_live_YOUR_PROJECT_KEY" data-require-consent defer></script>

كود التركيب في إعدادات مشروعك يضيف هالأسطر عنك لما يكون الخيار مفعّل.

قبل ما يوافق الزائر

الاستدعاءوش يصير
قبل grant()لا كوكيز، ولا تخزين، ولا طلبات شبكة. والأحداث اللي تتتبّعها في هالوقت ما تنحفظ. وسيرفر datacub يرفض كذلك أي حدث ما معه موافقة
datacub.consent.grant(options?)الـ SDK يكتب الكوكي حقه، ويسجّل حدث $consent ومشاهدة الصفحة الحالية، ويبدأ يرسل
datacub.consent.revoke()يوقف الإرسال، ويمسح كوكيز الـ SDK والطابور. واللي انتتبّع قبل السحب ما ينرسل بعدين

خيارات grant، وكلها اختيارية:

الخيارالقيم
methodوين وافق الزائر: banner أو settings أو api أو cmp (منصة إدارة موافقة)
policyVersionإصدار سياسة الخصوصية اللي وافق عليها، لين 64 حرف
overrideGPCشوف Global Privacy Control

SDK الويب ما يتذكر الموافقة بين تحميل صفحة والثانية. نافذة الموافقة أو منصتها عندك تحفظ جواب الزائر أصلًا: استدعِ grant() في كل تحميل صفحة طول ما الجواب نعم. و SDK الجوال يحفظ الموافقة في تخزينه، بس استدعِ grant() مع كل فتحة للتطبيق بعد ما يوافق المستخدم على أي حال، عشان يمشي الـ SDK على السجل اللي في تطبيقك.

identify قبل grant() ينحفظ في الذاكرة وينفّذ عند الموافقة.

مع منصة موافقة

استدعِ grant و revoke من الـ callbacks حق المنصة. وإذا المنصة تنزل قبل ملف الـ SDK، استخدم كود الطابور؛ الاستدعاءات تنتظر بالترتيب. وأضف له consent عشان الاستدعاءات المبكرة ما تضيع:

<script>
  window.datacub = window.datacub || []
  datacub.consent = datacub.consent || {
    grant: function () { datacub.push(['consent.grant'].concat([].slice.call(arguments))) },
    revoke: function () { datacub.push(['consent.revoke']) },
  }
</script>
datacub.init('pk_live_YOUR_PROJECT_KEY', { requireConsent: true })
onAnalyticsConsent(() => datacub.consent.grant({ method: 'cmp' }))
onAnalyticsConsentWithdrawn(() => datacub.consent.revoke())

وفي React Native مرّر نفس الخيار:

import AsyncStorage from '@react-native-async-storage/async-storage'
import datacub from '@datacub/react-native'

datacub.init('pk_live_YOUR_PROJECT_KEY', { storage: AsyncStorage, requireConsent: true })
// once the user has agreed: your app keeps their answer; call it at every launch
if (await hasAnalyticsConsent()) datacub.consent.grant()

الرفض، في كل المشاريع

هذا الجزء ينطبق سواء طلبت الموافقة أولًا أو لا.

  • datacub.consent.revoke() يشتغل دايم، و datacub يتذكره على نفس الجهاز. في الويب يكتب كوكي من نفس موقعك، datacub_optout=1، لمدة 400 يوم، وما فيه أي معرّف. وفي الجوال هو علامة داخل القيمة المحفوظة في تخزين الـ SDK.
  • لما يشتغل الـ SDK، الرفض المحفوظ معناه ما ينرسل شيء.
  • و datacub.consent.grant() الصريح يلغي الرفض.

مثلًا زر "وقّف تتبّعي" في إعدادات الخصوصية عندك:

datacub.init('pk_live_YOUR_PROJECT_KEY')
function onStopTrackingClick() {
  datacub.consent.revoke()
}

Global Privacy Control

إذا المتصفح يرسل Global Privacy Control (GPC)، datacub يعتبره رفض للتتبع: لما يشتغل الـ SDK ما ينرسل شيء، و grant() ما يسوي شيء. وبس إذا الزائر اختار بنفسه وبشكل صريح يفعّل التحليلات في موقعك، مثلًا من إعدادات الخصوصية، مرّر overrideGPC: true:

// only from the visitor's own click on an opt-in control
function onAnalyticsToggleOn() {
  datacub.consent.grant({ method: 'settings', overrideGPC: true })
}

وش ما يجمعه datacub أبد

هذا ينطبق في كل المشاريع، سواء طلبت الموافقة أولًا أو لا.

  • قيم الحقول وأجزاء الهاش في الرابط (نص الأزرار والروابط وعناوين الصفحات وقيم الرابط تنجمع بعد تنظيفها، وتقدر تطفي كل واحد في الإعدادات، جمع البيانات)
  • كلمات المرور، ورموز التحقق، وبيانات البطاقات، والآيبان، والهوية الوطنية والإقامة، والتوكنات: تنشال أو تنحجب على الجهاز ومرة ثانية على السيرفر
  • عناوين IP كما هي: تنستخدم في الذاكرة لمعرفة الدولة والمدينة ولحدود الطلبات، وبعدها تنشال وما تنحفظ أبد
  • بصمات الأجهزة ومعرّفات الإعلانات

وين تنحفظ البيانات وكم تبقى مكتوب في سياسة الخصوصية حق datacub.

دورك أنت

أنت تختار تطلب الموافقة أو لا، ووش الأساس اللي ينطبق على مستخدمينك. datacub يعطيك المفتاح، وما يقرر عنك. خلّ الخصائص خالية من البيانات الشخصية، واستخدم معرّفك الداخلي في identify، واستدعِ reset() عند تسجيل الخروج. وإذا طلب أحد حذف بياناته، شوف حذف بيانات شخص.