نظرة عامة على مساحة التخزين المشتركة

السماح بالوصول غير المحدود إلى مساحة التخزين على المواقع الإلكترونية مع إمكانية الوصول للقراءة مع الحفاظ على الخصوصية

حالة التنفيذ

يوضح هذا المستند اقتراحًا بشأن مساحة تخزين غير مقسَّمة على مواقع متعددة: واجهة برمجة تطبيقات التخزين المشترك.

  • Shared Storage API 现已正式发布。
  • 提供现场演示，测试也是如此：
    • 网址选择输出门控可在 Chrome M105 及更高版本中用于本地测试。
    • 从 Chrome M107 及更高版本中，私有汇总输出关口可用于本地测试。
    • 使用 Private Aggregation API 进行衡量的功能现已正式发布。
  • Chrome 平台状态
建议 状态
针对内容选择功能的事件级报告 (selectURL()) 至少可继续使用到 2026 年
针对每个网站设定预算
说明		 在 M119 中提供
允许从响应标头写入
说明
GitHub 问题		 在 M124 中提供。可在 M119-M123 中手动启用
不公开汇总贡献超时
说明		 在 M119 中提供
使用开发者工具调试共享存储空间 Worklet
部分		 在 M120 中提供
将共享存储空间的存储空间上限更新为 5MB
说明		 在 M124 中提供

لماذا نحتاج إلى واجهة برمجة التطبيقات هذه؟

لمنع تتبُّع المستخدمين على مواقع إلكترونية متعددة، تعمل المتصفّحات على تقسيم جميع أشكال التخزين (ملفات تعريف الارتباط وLocalStorage وذاكرة التخزين المؤقت وغير ذلك). ومع ذلك، هناك عدد من حالات الاستخدام المشروعة التي تعتمد على مساحة التخزين غير المقسَّمة والتي قد تكون مستحيلة بدون مساعدة من واجهات برمجة تطبيقات الويب الجديدة. على سبيل المثال، قد يرغب منتج المحتوى في قياس مدى الوصول عبر مواقع إلكترونية مختلفة، بدون الاعتماد على معرّفات عدة مواقع.

تسمح واجهة برمجة التطبيقات Shared Storage API للمواقع الإلكترونية بتخزين البيانات غير المقسَّمة على عدة مواقع إلكترونية والوصول إليها. يجب قراءة هذه البيانات في بيئة آمنة لمنع تسرّبها.

يمكنك استخدام بيانات مساحة التخزين المشتركة بطريقتَين:

مَنِ الشَّخْصُ الْمَطْلُوبْ إِرْسَالُ التَّذْكِيرْ إِلَيْهِ؟

هناك العديد من أنواع الشركات المختلفة التي قد تستفيد من استخدام واجهة برمجة التطبيقات Shared Storage API. مثال:

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

هل تبحث شركتك عن حلول تخزين عبر المواقع الإلكترونية لم يتم التعامل معها بعد؟ مشاركة حالة الاستخدام

حالات الاستخدام

تهدف واجهة برمجة التطبيقات Shared Storage API إلى إتاحة العديد من حالات الاستخدام، واستبدال عدة استخدامات حالية لملفات تعريف الارتباط التابعة لجهات خارجية. يشمل ذلك ما يلي:

حالة الاستخدام الوصف بوابة إخراج
عرض تصميمات الإعلانات بالتناوب يمكنك تخزين بيانات، مثل رقم تعريف تصميم الإعلان، وعدد المشاهدات، وتفاعل المستخدم، لتحديد أيّ من تصميمات الإعلانات التي تظهر لمستخدمي تصميمات الإعلانات في المواقع الإلكترونية المختلفة. يتيح لك ذلك تحقيق التوازن بين المشاهدات وتجنُّب الإفراط في عرض محتوى معيّن، ما يساعدك في تجنُّب ترك انطباع سلبي لدى المستخدم. اختيار عنوان URL
إجراء اختبار A/B يمكنك تعيين مستخدم إلى مجموعة تجربة، ثم تخزين تلك المجموعة في مساحة تخزين مشتركة للوصول إليها من خلال مواقع إلكترونية متعددة. اختيار عنوان URL
تخصيص تجربة المستخدم للعملاء المعروفين يمكنك مشاركة محتوى مخصّص وعبارات تحث المستخدم على اتخاذ إجراء استنادًا إلى حالة تسجيل المستخدم أو حالات المستخدم الأخرى. اختيار عنوان URL
إجراءات الحدّ من إساءة الاستخدام غالبًا ما تستخدم مؤسسات مكافحة إساءة الاستخدام ومكافحة الاحتيال ومؤسسات أمان الويب أساليب خاصة لاكتشاف المستخدمين الضارين، سواء كانت برامج آلية أو أشخاص حقيقيين يحاولون إلحاق الضرر بالآخرين. من الممكن اختبار العديد من الاستراتيجيات المختلفة هنا، سواء كان ذلك استخدام بوابة إخراج "اختيار عنوان URL" لترميز تقييم جدارة المستخدم بالثقة أو استخدام بوابة إخراج "التجميع الخاص" لإنشاء مجموعات بيانات لرصد القيم الشاذة. اختيار عنوان URL، واجهة برمجة التطبيقات الخاصة للتجميع الخاص
قياس مدى الوصول الفريد غالبًا ما يرغب العديد من منتجي المحتوى والمعلنين في معرفة عدد الأشخاص الفريدين الذين شاهدوا المحتوى الخاص بهم. يمكنك استخدام مساحة التخزين المشتركة لإعداد تقارير عن المرة الأولى التي يشاهد فيها المستخدم إعلانك، والفيديو المُضمَّن، والنشر، ومنع تكرار الأعداد المتكررة للمستخدم نفسه على موقع إلكتروني مختلف، مما يمنحك تقريرًا مجمّعًا مزعجًا عن مدى وصولك الفريد التقريبي إلى المستخدمين. Private Aggregation API
قياس الخصائص الديمغرافية للمستخدم غالبًا ما يرغب منتجو المحتوى في فهم الخصائص الديمغرافية لجمهورهم. ويمكنك استخدام مساحة التخزين المشتركة لتسجيل البيانات الديمغرافية للمستخدمين في سياق تتوفّر فيها هذه البيانات، مثل موقعك الإلكتروني التابع للطرف الأول، واستخدام التقارير المجمّعة لإعداد تقارير عنها في العديد من المواقع الإلكترونية الأخرى، مثل المحتوى المضمَّن. Private Aggregation API
قياس مدى وصول عدد مرّات الظهور بمعدل K+ يمكن وصف هذا النوع من المحتوى أحيانًا بأنّه "عدد مرات الظهور الفعّال"، وغالبًا ما يكون هناك حدّ أدنى لعدد المشاهدات قبل أن يتمكّن المستخدم من التعرّف على محتوى معيّن أو تذكّره (غالبًا في سياق مشاهدات الإعلان). يمكنك استخدام "مساحة التخزين المشتركة" لإنشاء تقارير عن المستخدمين الفريدين الذين شاهدوا جزءًا من المحتوى ألف مرة على الأقل. Private Aggregation API

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

كيف تعمل مساحة التخزين المشتركة؟

تتيح لك "مساحة التخزين المشتركة" اتخاذ قرارات مدروسة بناءً على بيانات عدّة مواقع إلكترونية، بدون مشاركة معلومات المستخدم (مثل سجلّ المتصفّح أو غيرها من التفاصيل الشخصية) مع موقع إلكتروني مضمَّن أو استخراج البيانات إلى خوادمك الخاصة.

يمكنك الكتابة في مساحة التخزين المشتركة في أي وقت، مثل واجهات برمجة التطبيقات الأخرى لمساحة تخزين JavaScript، مثل localStorage أو indexDB. وعلى عكس واجهات برمجة تطبيقات مساحة التخزين الأخرى، يمكنك فقط قراءة قيم مساحة التخزين المشتركة في بيئة آمنة، تُعرف باسم العمل الصغير لمساحة التخزين المشتركة.

Worklets هي المكان الذي تضيف فيه منطق عملك. داخل العمل الصغير، يُسمح لك بقراءة قيمة من مساحة التخزين المشتركة ومعالجتها، ولكن لا يمكنك إعادة القيمة الدقيقة مباشرةً إلى متطلب الوظيفة المصغَّرة. لاستخراج معلومات مفيدة من العمل الصغير، تتوفر مجموعة من "البوابات". هناك بوّابتان متاحتان، لكن يمكن إضافة المزيد في المستقبل.

بوابات إخراج واجهة برمجة التطبيقات Shared Storage API المتاحة هي:

تجربة واجهة برمجة تطبيقات مساحة التخزين المشتركة

تتوفّر واجهة برمجة تطبيقات التخزين المشترك لبوابة إخراج اختيار عناوين URL وبوابة ناتج التجميع الخاص للاختبار. يمكن اختبار اختيار المحتوى في Chrome. الإصدار التجريبي M105 من إصدار Canary أو مطوّري البرامج أو الإصدار التجريبي من الإصدار M105 أو الإصدارات الأحدث، وتتوفّر واجهة برمجة التطبيقات Private Aggregation API للاختبار في إصدار Canary M107 والإصدارات الأحدث من إصدار Canary وإصدار Chrome. يمكن اختبار واجهة برمجة التطبيقات من خلال تفعيل العلامة تجربة واجهات برمجة التطبيقات لإعلانات "مبادرة حماية الخصوصية" في chrome://flags/#privacy-sandbox-ads-apis.

يجب تفعيل تجربة واجهات برمجة التطبيقات للإعلانات في "مبادرة حماية الخصوصية" لاستخدام واجهات برمجة التطبيقات هذه.

استخدام العرض التوضيحي

يتوفّر عرض توضيحي، ويمكنك مراجعة الرمز على GitHub.

تم إنشاء هذا العرض التوضيحي من منظور المعلِن أو تكنولوجيا الإعلان أو موزع المحتوى أو خدمة أخرى تابعة لجهة خارجية والتي تريد تخزين المعلومات على المواقع الإلكترونية الخاصة بالناشرين المختلفين. في الإصدار التجريبي، سيتم تشغيل رمز الجهة الخارجية نفسه على الموقعَين الإلكترونيَّين الناشر (أ) والناشر (ب) لكل حالة استخدام. انتقِل إلى صفحات الناشر لمعرفة كيفية مشاركة البيانات في سياق مواقع إلكترونية متعددة.

يحتوي العرض التوضيحي على حالات استخدام لاختيار المحتوى والتجميع الخاص.

بالنسبة إلى العرض التوضيحي لاختيار المحتوى، تتوفّر حالات الاستخدام التالية: عرض تصميمات الإعلانات بالتناوب، وتخصيص تجربة الاستخدام للعملاء المعروفين، وتشغيل اختبار A/B.

بالنسبة إلى العرض التوضيحي للتجميع الخاص، يمكنك معاينة الميزات الفريدة قياس مدى الوصول الفريد وقياس مدى الوصول إلى عدد مرّات الظهور على +K. قياس الخصائص الديمغرافية للمستخدم

تصحيح الأخطاء المرتبطة بوظائف مساحة التخزين المشتركة باستخدام "أدوات مطوري البرامج"

لفحص وظائف مساحة التخزين المشتركة التي بدأت من الصفحة التي تتصفّحها، يمكنك الانتقال إلى علامة التبويب "المصادر" في لوحة "أدوات مطوري البرامج" وإضافة نقطة إيقاف أداة معالجة حدث "الإذن العملي لمساحة التخزين المشتركة / البيان الأول للنص البرمجي". ستعمل نقطة الإيقاف هذه مؤقتًا على إيقاف تنفيذ النص البرمجي الأولي للوحدة أو المهام القصيرة الأجل عند بدء التشغيل.

تصحيح أخطاء العمل الصغير في مساحة التخزين المشتركة من خلال إضافة أداة معالجة على مستوى الحدث
يمكن إضافة نقطة إيقاف إلى مهمة "مساحة التخزين المشتركة".

بالإضافة إلى ذلك، تعرض صفحة chrome://inspect/#shared-storage-worklets جميع تطبيقات "مساحة التخزين المشتركة" النشطة من جميع الصفحات.

互动和分享反馈

共享存储空间提案正在积极讨论中，将来可能会发生变化。如果您在试用此 API 时有反馈意见，我们非常期待收到您的宝贵意见。