تتيح واجهة برمجة التطبيقات Shared Storage API لمواقع الويب تخزين البيانات والوصول إليها بدون عزلها عن الموقع الإلكتروني من المستوى الأعلى. ويسمح ذلك بحالات استخدام على مستوى المواقع الإلكترونية المختلفة ويسهّلها مع احترام خصوصية المستخدم.
على الرغم من أنّ Chrome يتضمّن مساحة تخزين مُقسَّمة وينتقل إلى تجربة جديدة تمنح المستخدمين مزيدًا من التحكم في ملفات تعريف الارتباط التابعة لجهات خارجية، فهناك عدد من حالات الاستخدام المشروعة التي تعتمد على مساحة تخزين غير مُقسَّمة ولا يمكن تنفيذها بدون مساعدة من واجهات برمجة التطبيقات الجديدة للويب. على سبيل المثال، قد يريد أحد صنّاع المحتوى قياس مدى وصول المحتوى إلى الجمهور على مواقع إلكترونية مختلفة، بدون الاعتماد على المعرّفات على مستوى المواقع الإلكترونية. تلبّي واجهة برمجة التطبيقات Shared Storage API هذه الحاجة من خلال توفير آلية أكثر خصوصية لتخزين البيانات غير المقسّمة والوصول إليها على مستوى المواقع الإلكترونية.
ما هي واجهة برمجة التطبيقات Shared Storage API؟
Shared Storage API هي أداة تخزين مخصّصة للأغراض العامة تم تصميمها ل تفعيل حالات الاستخدام التي تحافظ على الخصوصية على مستوى المواقع الإلكترونية. من خلال ميزات مشابهة لكلٍّ من واجهتَي برمجة التطبيقات localStorage وsessionStorage، فإنّ "التخزين المشترَك" هو عبارة عن متجر للمفاتيح والقيم يمكن فيه تسجيل البيانات في أي وقت. على عكس واجهات برمجة التطبيقات الأخرى لمساحة التخزين على الويب، يمكن مشاركة data مساحة التخزين المشتركة على مستوى مواقع إلكترونية مختلفة، ولكن لا يمكن قراءة data مساحة التخزين المشتركة إلا من بيئة آمنة وإخراجها باستخدام واجهات برمجة التطبيقات المخصّصة للإخراج.
في المخطّط البياني السابق، يمكن تضمين موقع shoes.example الإلكتروني في
مواقع الناشرين الأخرى، مثل news.example، مع الاستمرار في الوصول إلى البيانات نفسها.
تتيح ميزة "مساحة التخزين المشتركة" هذه إمكانات على مستوى جميع المواقع الإلكترونية مع تحسين خصوصية المستخدم من خلال منع تتبُّع زوّار الموقع الإلكتروني الفرديين وتقييد الوصول إلى البيانات. لا يمكن الوصول إلى البيانات إلا في بيئة آمنة تتضمّن إمكانات محدودة لعرض البيانات (وحدات العمل).
"مساحة التخزين المشتركة" هي البنية الأساسية لمساحة التخزين لعدد محدود من واجهات برمجة التطبيقات لإخراج البيانات. إنّ Output API هي الطريقة الوحيدة لاستخدام بيانات مساحة التخزين المشتركة. واجهات برمجة التطبيقات الخاصة بالمخرجات هي:
- اختيار عنوان URL: اختَر عنوان URL من قائمة مقدَّمة استنادًا إلى البيانات المخزّنة، ثم أعِد عرض هذا المحتوى في إطار محدود.
- التجميع الخاص: يمكنك إرسال بيانات من عدّة مواقع إلكترونية من خلال Private Aggregation API لإنشاء تقرير تلخيصي.
لماذا نحتاج إلى "مساحة التخزين المشتركة"؟
واجهة برمجة التطبيقات Shared Storage API هي آلية تخزين مرنة يمكن لمطوّري الويب استخدامها بالاشتراك مع واجهات برمجة التطبيقات لعرض البيانات من أجل معالجة العديد من حالات الاستخدام، بما في ذلك استبدال العديد من الاستخدامات الحالية لملفات تعريف الارتباط التابعة لجهات خارجية. اطّلِع على مزيد من التفاصيل حول حالات الاستخدام المحتمَلة لواجهات برمجة التطبيقات لإخراج البيانات: عنوان URL المحدّد والتجميع الخاص.
هل تبحث شركتك عن حلول تخزين على مستوى المواقع الإلكترونية لم يتم طرحها بعد؟ يمكنك مشاركة حالة الاستخدام وإنشاء مشكلة في مستودع GitHub لميزة "مساحة التخزين المشتركة" المفتوح المصدر.
واجهات برمجة التطبيقات لإخراج البيانات وحالات الاستخدام المتوافقة مع "مساحة التخزين المشتركة"
| Output API | حالة الاستخدام | الوصف |
|---|---|---|
| اختيار عنوان URL | عرض الإعلانات بالتناوب | يمكنك تخزين البيانات، مثل رقم تعريف تصميم الإعلان وعدد المشاهدات وتفاعل المستخدِم، لتحديد تصميم الإعلان الذي يراه المستخدِمون على مختلف المواقع الإلكترونية. يتيح لك ذلك موازنة المشاهدات وتجنُّب كثرة محتوى معيّن وبالتالي تجنُّب تجربة سلبية محتملة للمستخدم. |
| اختيار عنوان URL | إجراء اختبار أ/ب | يقارن اختبار أ/ب نسختَين أو أكثر من أحد الإعدادات لتحديد الإعداد الأفضل أداءً. يمكنك تعيين مستخدم إلى مجموعة تجريبية، ثم تخزين هذه المجموعة في "مساحة التخزين المشتركة" للوصول إلى جميع المواقع الإلكترونية. |
| اختيار عنوان URL | تخصيص تجربة المستخدم للعملاء المعروفين | يمكنك مشاركة محتوى مخصّص وطلبات لإجراء استنادًا إلى حالة تسجيل المستخدم أو حالات المستخدم الأخرى. |
| اختيار عنوان URL، التجميع الخاص | إجراءات الحدّ من إساءة الاستخدام | غالبًا ما تستخدم المنظمات التي تعمل في مجال مكافحة إساءة الاستخدام ومكافحة الاحتيال وأمان الويب أساليب خاصة لرصد المستخدمين الضارّين، سواء كانوا روبوتات مبرمَجة أو مستخدمين حقيقيين يحاولون إلحاق الضرر. من الممكن اختبار العديد من استراتيجية مختلفة في حالة الاستخدام هذه، سواء كان ذلك باستخدام Select URL API لمحاولة ترميز تقييم مدى ثقة المستخدم أو استخدام Private Aggregation API لإنشاء مجموعات بيانات لرصد الحالات الشاذة. |
| التجميع الخاص | قياس مدى الوصول الفريد | يريد العديد من صنّاع المحتوى والمعلنين غالبًا معرفة عدد الأشخاص المختلفين الذين شاهدوا المحتوى المعروض. يمكنك استخدام ميزة "مساحة التخزين المشتركة" لتسجيل التقارير عن المرة الأولى التي يرى فيها المستخدِم إعلانك أو الفيديو المضمّن أو النشر. يمكنك منع احتساب هذا المستخدِم نفسه بشكلٍ مكرّر على موقع إلكتروني مختلف، وإنشاء تقرير مجمّع للمحتوى المزعِج الذي يمثّل مدى الوصول التقريبي إلى المحتوى الفريد. |
| التجميع الخاص | قياس الخصائص الديمغرافية للمستخدِمين | يهتم صنّاع المحتوى بمعرفة الخصائص الديمغرافية لجمهورهم. تتيح لك ميزة "مساحة التخزين المشتركة" تسجيل البيانات الديمغرافية للمستخدمين على موقع الطرف الأول الإلكتروني والاستفادة من التقارير المجمّعة لتحليل هذه المعلومات على مختلف المنصات الأخرى، مثل المحتوى المضمّن. |
| التجميع الخاص | قياس مدى الوصول إلى الجمهور بعدد مرّات ظهور أكبر من 1,000 | يُشار إليها أحيانًا باسم "عدد مرّات الظهور الفعّال"، وغالبًا ما يكون هناك حدّ أدنى من عدد المشاهدات قبل أن يتعرّف المستخدِم على محتوى معيّن أو يتذكره (غالبًا في سياق مشاهدات الإعلانات). يمكنك استخدام "مساحة التخزين المشتركة" لإنشاء تقارير عن المستخدِمين الفرديين الذين شاهدوا محتوى معيّنًا على الأقلّ K مرّة. |
كيف تعمل ميزة "مساحة التخزين المشتركة"؟
تتيح لك ميزة "مساحة التخزين المشتركة" اتّخاذ قرارات مدروسة استنادًا إلى البيانات من جميع المواقع الإلكترونية، بدون مشاركة معلومات المستخدمين (مثل سجلّ المتصفّح أو تفاصيل شخصية أخرى) مع موقع إلكتروني مضمّن أو إخراج البيانات إلى خوادمك الخاصة.
يمكنك الكتابة في مساحة التخزين المشتركة في أي وقت، ولكن لا يمكنك قراءة قيم "مساحة التخزين المشترَكة" إلا في بيئة آمنة تُعرف باسم "وحدة العمل".
يمكنك إضافة منطق نشاطك التجاري إلى مهام Shared Storage ثم قراءة قيمة من Shared Storage ومعالجتها بدون عرض القيمة الدقيقة مباشرةً على المُطلِب الذي يشغّل المهمة. يمكنك استخدام واجهات برمجة التطبيقات الخاصة بميزة "التجميع الخاص" أو "عنوان URL محدّد" لإخراج المعلومات من أداة العمل. قد تصبح واجهات برمجة تطبيقات Output API إضافية متوفرة عند الإبلاغ عن حالات استخدام جديدة.
حالة واجهة برمجة التطبيقات
أصبحت Shared Storage API متاحة للجمهور العام. اتّبِع تعليمات التسجيل في "مبادرة حماية الخصوصية"، لاستخدام واجهة برمجة التطبيقات أو تفعيلها للتطوير على الجهاز.
| 提案 | 状态 |
|---|---|
| 允许从响应标头写入 说明 GitHub 问题 |
适用于 M124。可以在 M119-M123 中手动启用 |
| 使用开发者工具调试共享存储空间 Worklet 部分 |
在 M120 中提供 |
| 将共享存储空间数据存储空间上限更新为 5MB 说明 |
适用于 M124 |
createWorklet()，用于创建不使用 iframe 的跨源 worklet |
在 M125 中提供 |
允许在 addModule() 中使用跨源脚本，并使 createWorklet() 与该行为保持一致 |
适用于 M130 |
createWorklet() 中对自定义数据源的支持说明 |
预计 2025 年第 1 季度 |
| 允许共享存储空间 Worklet 读取兴趣群组 说明 |
预计 2025 年第 1 季度 |
| 使用 DevTools 调试共享存储空间 Worklet 说明 GitHub 问题 |
预计 2025 年第 1 季度 |
互动和分享反馈
请注意，Shared Storage API 提案正在积极讨论和开发中，因此可能会发生变化。
我们非常期待听到您对 Shared Storage API 的看法。
掌握最新动态
- 邮寄名单：订阅我们的邮寄名单，及时了解与 Shared Storage API 相关的最新动态和公告。
需要帮助？
- 开发者支持：在 Privacy Sandbox 开发者支持代码库中与其他开发者联系，并获取问题解答。