تتيح واجهة برمجة التطبيقات Shared Storage API للمواقع الإلكترونية تخزين البيانات والوصول إليها بدون أن يعزلها الموقع الإلكتروني ذو المستوى الأعلى. يتيح ذلك ويسهّل حالات الاستخدام على مواقع إلكترونية متعددة مع احترام خصوصية المستخدم.
على الرغم من أنّ Chrome يوفّر مساحة تخزين مقسّمة ويتّجه نحو تجربة جديدة تعزّز خيار المستخدم بشأن ملفات تعريف الارتباط التابعة لجهات خارجية، هناك عدد من حالات الاستخدام المشروعة التي تعتمد على مساحة تخزين غير مقسّمة، ولن يكون ذلك ممكنًا بدون مساعدة من واجهات برمجة تطبيقات الويب الجديدة. على سبيل المثال، قد يريد منتج محتوى قياس مدى وصول المحتوى إلى المستخدمين على مواقع إلكترونية مختلفة، بدون الاعتماد على معرّفات المواقع الإلكترونية المختلفة. تلبّي واجهة برمجة التطبيقات Shared Storage API هذه الحاجة من خلال توفير آلية أكثر خصوصية لتخزين البيانات غير المقسّمة والوصول إليها على مستوى المواقع الإلكترونية.
ما هي واجهة برمجة التطبيقات Shared Storage API؟
Shared Storage API هي أداة تخزين للأغراض العامة مصمَّمة لإتاحة حالات استخدام متعدّدة المواقع الإلكترونية تحافظ على الخصوصية. تتضمّن Shared Storage ميزات مشابهة لكلّ من واجهتَي برمجة التطبيقات localStorage وsessionStorage، وهي عبارة عن مخزن قيم مفتاحية يمكن الكتابة فيه في أي وقت. على عكس واجهات برمجة التطبيقات الأخرى لتخزين البيانات على الويب، يمكن مشاركة بيانات Shared Storage على مستوى مواقع إلكترونية مختلفة ذات مستوى أعلى، ولكن لا يمكن قراءة بيانات Shared Storage إلا من بيئة آمنة وإخراجها باستخدام واجهات برمجة تطبيقات Output API مقيّدة.
في الرسم البياني السابق، يمكن تضمين الموقع الإلكتروني shoes.example في مواقع إلكترونية أخرى خاصة بالناشرين، مثل news.example، وسيظل بإمكانه الوصول إلى البيانات نفسها.
تتيح إمكانية Shared Storage استخدام وظائف على مستوى المواقع الإلكترونية مع تعزيز خصوصية المستخدمين من خلال منع تتبُّع زوّار المواقع الإلكترونية الفردية وتقييد الوصول إلى البيانات. لا يمكن الوصول إلى البيانات إلا في بيئة آمنة ذات إمكانات إخراج محدودة (وحدات عمل صغيرة).
Shared Storage هي البنية الأساسية لمساحة التخزين لعدد محدود من واجهات برمجة التطبيقات Output API. Output API هي الطريقة الوحيدة لاستخدام بيانات Shared Storage API. واجهات برمجة التطبيقات الخاصة بالنتائج هي:
- اختيار عنوان URL: اختَر عنوان URL من قائمة متوفّرة استنادًا إلى البيانات المخزّنة، ثم اعرض هذا المحتوى في إطار محمي.
- Private Aggregation: يمكنك إرسال بيانات على مستوى المواقع الإلكترونية من خلال Private Aggregation API لإنشاء تقرير تلخيصي.
لماذا نحتاج إلى Shared Storage API؟
Shared Storage API هي آلية تخزين مرنة يمكن لمطوّري الويب استخدامها مع واجهات برمجة التطبيقات الخاصة بالإخراج لتلبية العديد من حالات الاستخدام، بما في ذلك استبدال العديد من الاستخدامات الحالية لملفات تعريف الارتباط التابعة لجهات خارجية. يمكنك الاطّلاع على مزيد من التفاصيل حول حالات الاستخدام المحتملة لواجهات برمجة التطبيقات الخاصة بالنتائج: اختيار عنوان URL والتجميع الخاص.
هل تبحث شركتك عن حلول للتخزين على مستوى المواقع الإلكترونية لم يتم تناولها بعد؟ يمكنك مشاركة حالة الاستخدام وإنشاء مشكلة في مستودع GitHub المفتوح المصدر لواجهة برمجة التطبيقات Shared Storage API.
واجهات برمجة التطبيقات وحالات الاستخدام المتوافقة مع Shared Storage
| Output API | حالة الاستخدام | الوصف |
|---|---|---|
| اختيار عنوان URL | عرض تصاميم الإعلانات بالتناوب | يمكنك تخزين بيانات، مثل رقم تعريف تصميم الإعلان وعدد المشاهدات وتفاعل المستخدمين، لتحديد تصميم الإعلان الذي يراه المستخدمون على المواقع الإلكترونية المختلفة. يتيح لك ذلك تحقيق التوازن بين عدد المشاهدات وتجنُّب الإفراط في عرض محتوى معيّن، وبالتالي تجنُّب تجربة سلبية محتملة للمستخدم. |
| اختيار عنوان URL | إجراء اختبار A/B | يقارن اختبار A/B صيغتَين أو أكثر من الإعداد لتحديد الصيغة الأفضل أداءً. يمكنك تعيين مستخدم لمجموعة تجريبية، ثم تخزين هذه المجموعة في "مساحة التخزين المشتركة" للوصول إليها على مستوى المواقع الإلكترونية. |
| اختيار عنوان URL | تخصيص تجربة المستخدم للعملاء المعروفين | يمكنك مشاركة محتوى مخصّص وعبارات تحث المستخدم على اتّخاذ إجراء استنادًا إلى حالة تسجيل المستخدم أو حالات أخرى. |
| اختيار عنوان URL، التجميع الخاص | إجراءات الحدّ من إساءة الاستخدام | تستخدم المؤسسات المعنية بمكافحة إساءة الاستخدام والاحتيال وأمن الويب غالبًا أساليب خاصة لرصد المستخدمين الضارين، سواء كانوا روبوتات مبرمَجة أو مستخدمين حقيقيين يحاولون إلحاق الضرر. من الممكن اختبار العديد من الاستراتيجيات المختلفة في حالة الاستخدام هذه، سواء كان ذلك باستخدام Select URL API لترميز تقييم موثوقية المستخدم أو باستخدام Private Aggregation API لإنشاء مجموعات بيانات لرصد الحالات الشاذة. |
| التجميع الخاص | قياس مدى الوصول الفريد | يريد العديد من صنّاع المحتوى والمعلنين معرفة عدد المستخدمين الفريدين الذين شاهدوا المحتوى المعروض. يمكنك استخدام Shared Storage لتسجيل المرة الأولى التي يرى فيها المستخدم إعلانك أو فيديو مضمّنًا أو منشورك. يمكنك منع احتساب المستخدم نفسه بشكل مكرّر على موقع إلكتروني مختلف، وإنشاء تقرير مجمّع يتضمّن بعض التشويش بشأن مدى وصول المحتوى الفريد التقريبي. |
| التجميع الخاص | قياس الخصائص الديمغرافية للمستخدمين | يهتم صنّاع المحتوى بمعرفة الخصائص الديمغرافية لجمهورهم. تتيح لك Shared Storage API تسجيل البيانات الديمغرافية للمستخدمين على موقعك الإلكتروني التابع للطرف الأول والاستفادة من التقارير المجمّعة لتحليل هذه المعلومات على مختلف المنصات الأخرى، مثل المحتوى المضمّن. |
| التجميع الخاص | قياس مدى الوصول إلى الجمهور بعدد مرّات ظهور أكبر من حدّ معين | يُشار إلى ذلك أحيانًا باسم "معدّل التكرار الفعّال"، وغالبًا ما يكون هناك حد أدنى لعدد المشاهدات قبل أن يتعرّف المستخدم على محتوى معيّن أو يتذكّره (غالبًا ما يكون ذلك في سياق مشاهدات الإعلانات). يمكنك استخدام Shared Storage لإنشاء تقارير عن المستخدمين الفريدين الذين شاهدوا جزءًا من المحتوى K مرّة على الأقل. |
كيف تعمل واجهة برمجة التطبيقات Shared Storage؟
تتيح لك Shared Storage اتّخاذ قرارات مدروسة استنادًا إلى البيانات على مستوى المواقع الإلكترونية، بدون مشاركة معلومات المستخدم (مثل سجلّ التصفّح أو التفاصيل الشخصية الأخرى) مع موقع إلكتروني مضمّن أو نقل البيانات إلى خوادمك الخاصة.
يمكنك الكتابة إلى مساحة التخزين المشتركة في أي وقت، ولكن يمكنك قراءة قيم Shared Storage في بيئة آمنة فقط، تُعرف باسم "برنامج صغير".
تُستخدَم Shared Storage worklets لإضافة منطق نشاطك التجاري، ثم قراءة قيمة من Shared Storage ومعالجتها بدون عرض القيمة الدقيقة مباشرةً لبرنامج استدعاء worklet. يمكنك استخدام واجهة Private Aggregation API أو Select URL Output API لاستخراج المعلومات من التطبيق الصغير. قد تتوفّر واجهات برمجة تطبيقات إضافية للإخراج عند الإبلاغ عن حالات استخدام جديدة.
حالة واجهة برمجة التطبيقات
تتوفّر Shared Storage API للجمهور العام. اتّبِع التعليمات للتسجيل في "مبادرة حماية الخصوصية" من أجل استخدام واجهة برمجة التطبيقات أو تفعيلها للتطوير على الجهاز.
| الاقتراح | الحالة |
|---|---|
| السماح بالكتابة من رؤوس الاستجابة شرح مشكلة GitHub |
متوفّر في M124. يمكن تفعيلها يدويًا في الإصدارات M119-M123 |
| تصحيح أخطاء وحدات "مساحة التخزين المشتركة" باستخدام "أدوات المطوّرين" القسم |
متوفّر في M120 |
| تعديل الحد الأقصى لمساحة تخزين البيانات في "مساحة التخزين المشتركة" ليصبح 5 ميغابايت شرح |
متوفّر في M124 |
createWorklet() لإنشاء وحدات عمل متعددة المصادر بدون إطار iframe |
متوفّر في M125 |
السماح بنصوص برمجية مشتركة المنشأ في addModule()، ومواءمة createWorklet() لمطابقة السلوك |
متوفّر في M130 |
| السماح لوحدة عمل "مساحة التخزين المشتركة" بقراءة مجموعات الاهتمامات شرح |
متوفّر في M134 |
توفُّر مصدر بيانات مخصّص في createWorklet()شرح |
متوفّر في M135 |
| تصحيح أخطاء وحدات عمل Shared Storage باستخدام DevTools شرح مشكلة GitHub |
من المتوقّع حدوثها في الربع الثاني من عام 2025 |
التفاعل مع الملاحظات ومشاركتها
يُرجى العِلم أنّ اقتراح واجهة برمجة التطبيقات Shared Storage API يخضع حاليًا لمناقشة وتطوير نشطَين، وبالتالي قد يتغيّر.
نتطلّع إلى معرفة رأيك في واجهة برمجة التطبيقات Shared Storage API.
- العرض: راجِع العرض التفصيلي.
- المناقشة: انضم إلى المناقشة الجارية لطرح الأسئلة ومشاركة آرائك.