تتيح واجهة برمجة التطبيقات Shared Storage API لمواقع الويب تخزين البيانات والوصول إليها بدون عزلها عن الموقع الإلكتروني من المستوى الأعلى. ويسمح ذلك بحالات استخدام على مستوى المواقع الإلكترونية المختلفة ويسهّلها مع احترام خصوصية المستخدم.
على الرغم من أنّ Chrome يتضمّن مساحة تخزين مُقسَّمة وينتقل إلى تجربة جديدة تمنح المستخدمين مزيدًا من التحكم في ملفات تعريف الارتباط التابعة لجهات خارجية، فهناك عدد من حالات الاستخدام المشروعة التي تعتمد على مساحة تخزين غير مُقسَّمة ولا يمكن تنفيذها بدون مساعدة من واجهات برمجة التطبيقات الجديدة للويب. على سبيل المثال، قد يريد صانع المحتوى قياس مدى وصول المحتوى إلى الجمهور على مواقع إلكترونية مختلفة، بدون الاعتماد على المعرّفات على مستوى المواقع الإلكترونية. تلبّي واجهة برمجة التطبيقات Shared Storage API هذه الحاجة من خلال توفير آلية أكثر خصوصية لتخزين البيانات غير المقسّمة والوصول إليها على مستوى المواقع الإلكترونية.
ما هي واجهة برمجة التطبيقات Shared Storage API؟
Shared Storage API هي أداة تخزين مخصّصة للأغراض العامة تم تصميمها ل تفعيل حالات الاستخدام التي تحافظ على الخصوصية على مستوى المواقع الإلكترونية. من خلال ميزات مشابهة لكلٍّ من واجهتَي برمجة التطبيقات localStorage وsessionStorage، فإنّ "التخزين المشترَك" هو عبارة عن متجر للمفاتيح والقيم يمكن فيه تسجيل البيانات في أي وقت. على عكس واجهات برمجة التطبيقات الأخرى لمساحة تخزين الويب، يمكن مشاركة data مساحة التخزين المشتركة على مستوى مواقع إلكترونية مختلفة، ولكن لا يمكن قراءة data مساحة التخزين المشتركة إلا من بيئة آمنة وإخراجها باستخدام IDE واجهات برمجة التطبيقات المخصّصة للإخراج.
في المخطّط البياني السابق، يمكن تضمين موقع 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 متاحة للجميع. اتّبِع تعليمات التسجيل في "مبادرة حماية الخصوصية"، لاستخدام واجهة برمجة التطبيقات أو تفعيلها للتطوير على الجهاز.
| Proposal | Status |
|---|---|
| Allow writing from response headers Explainer GitHub Issue |
Available in M124. Can be manually enabled in M119-M123 |
| Debugging Shared Storage worklets with DevTools Section |
Available in M120 |
| Update Shared Storage data storage limit to 5MB Explainer |
Available in M124 |
createWorklet() to create cross-origin worklets without an iframe |
Available in M125 |
Allow cross-origin script in addModule(), and align createWorklet() to match the behavior |
Available in M130 |
التفاعل مع الملاحظات ومشاركتها
يُرجى العِلم أنّ اقتراح Shared Storage API قيد المناقشة والتطوير بشكل نشط، وبالتالي يخضع للتغيير.
يسرّنا معرفة رأيك بشأن Shared Storage API.
- العرض: راجِع العرض التفصيلي.
- المناقشة: يمكنك الانضمام إلى المناقشة الجارية لطرح الأسئلة ومشاركة الإحصاءات.
الاطّلاع على آخر الأخبار
- القائمة البريدية: يمكنك الاشتراك في قائمتنا البريدية لتلقّي آخر الأخبار والإشعارات المتعلّقة بواجهة برمجة التطبيقات Shared Storage API.
هل أنت بحاجة إلى مساعدة؟
- دعم المطوّرين: يمكنك التواصل مع مطوّرين آخرين والحصول على إجابات عن أسئلتك في مستودع دعم المطوّرين في "مبادرة حماية الخصوصية".