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

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

حالة التنفيذ

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

Proposal Status
Event-level reporting for Content Selection (selectURL()) Available until at least 2026
Per-site budgeting
Explainer
Available in M119
Allow writing from response headers
Explainer
GitHub Issue
Available in M124. Can be manually enabled in M119-M123
Private Aggregation contribution timeout
Explainer
Available in M119
Debugging Shared Storage worklets with DevTools
Section
Available in M120
Update Shared Storage data storage limit to 5MB
Explainer
Available in 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 جميع تطبيقات "مساحة التخزين المشتركة" النشطة من جميع الصفحات.

التفاعل مع الملاحظات ومشاركتها

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