نمای کلی فضای ذخیره‌سازی مشترک

اجازه دسترسی نامحدود و نامحدود برای نوشتن فضای بین سایتی با دسترسی خواندن حفظ حریم خصوصی.

وضعیت پیاده سازی

این سند پیشنهادی را برای ذخیره‌سازی بین‌سایتی بدون پارتیشن ارائه می‌کند: ذخیره‌سازی مشترک API.

提案 状态
内容选择的事件级报告 (selectURL()) 至少可用到 2026 年
按网站设置预算
解说		 适用于 M119
允许从响应标头写入
说明
GitHub 问题		 适用于 M124。可以在 M119-M123 中手动启用
使用开发者工具调试共享存储空间 Worklet
部分		 在 M120 中提供
将共享存储空间数据存储空间上限更新为 5MB
说明		 适用于 M124
createWorklet()，用于创建不使用 iframe 的跨源 worklet 在 M125 中提供
允许在 addModule() 中使用跨源脚本，并使 createWorklet() 与该行为保持一致 在 M130 中提供

چرا به این API نیاز داریم؟

برای جلوگیری از ردیابی کاربران بین سایتی، مرورگرها تمام اشکال ذخیره سازی (کوکی ها، محلی ذخیره سازی، حافظه های پنهان و غیره) را پارتیشن بندی می کنند. با این حال، تعدادی از موارد استفاده قانونی وجود دارد که به فضای ذخیره‌سازی پارتیشن نشده متکی هستند که بدون کمک APIهای وب جدید غیرممکن است. برای مثال، ممکن است یک تولیدکننده محتوا بخواهد دسترسی به سایت‌های مختلف را بدون تکیه بر شناسه‌های متقابل اندازه‌گیری کند.

Shared Storage API به سایت‌ها اجازه می‌دهد تا داده‌های بین‌سایتی پارتیشن‌نشده را ذخیره کرده و به آن دسترسی داشته باشند. این داده ها باید در یک محیط امن خوانده شوند تا از نشت جلوگیری شود.

می‌توانید از داده‌های ذخیره‌سازی مشترک به دو روش استفاده کنید :

این برای کیست؟

انواع مختلفی از شرکت ها وجود دارند که ممکن است از استفاده از ذخیره سازی مشترک API سود ببرند. به عنوان مثال:

  • فن‌آوری‌های تبلیغاتی می‌توانند میزان دسترسی کمپین را اندازه‌گیری کنند، محدودیت‌های فرکانس تعیین کنند و خلاقیت‌ها را بچرخانند، که همگی در حال حاضر به کوکی‌های شخص ثالث متکی هستند.
  • ارائه‌دهندگان پرداخت‌ها می‌توانند تعیین کنند که آیا کاربر یک مشتری موجود است یا خیر و تجربه پرداخت را تنظیم کنند.
  • شرکت های امنیت وب می توانند منطق سفارشی ایجاد کنند تا رفتار مشکوک یا خطرناک را علامت گذاری کنند.

آیا شرکت شما به دنبال راه حل های ذخیره سازی بین سایتی است که هنوز به آن توجه نشده است؟ مورد استفاده خود را به اشتراک بگذارید

موارد استفاده کنید

Shared Storage API قصد دارد از بسیاری از موارد استفاده پشتیبانی کند و جایگزین چندین کاربرد موجود برای کوکی‌های شخص ثالث شود. این شامل:

مورد استفاده توضیحات دروازه خروجی
چرخش خلاقیت های تبلیغاتی می‌توانید داده‌هایی مانند شناسه خلاق، تعداد بازدیدها و تعامل کاربر را ذخیره کنید تا مشخص کنید کاربران خلاق کدام یک را در سایت‌های مختلف می‌بینند. این به شما امکان می‌دهد بین بازدیدها تعادل برقرار کنید و از اشباع بیش از حد محتوای خاص جلوگیری کنید، که می‌تواند به شما در جلوگیری از تجربه منفی کاربر کمک کند. انتخاب URL
تست A/B را اجرا کنید می‌توانید کاربر را به یک گروه آزمایشی اختصاص دهید، سپس آن گروه را در فضای ذخیره‌سازی مشترک ذخیره کنید تا از طریق سایت به آن دسترسی داشته باشید. انتخاب URL
تجربه کاربری را برای مشتریان شناخته شده سفارشی کنید می‌توانید محتوای سفارشی و فراخوان‌ها را بر اساس وضعیت ثبت نام کاربر یا سایر وضعیت‌های کاربری به اشتراک بگذارید. انتخاب URL
اقدامات ضد سوء استفاده سازمان‌های ضد سوء استفاده، ضد کلاهبرداری و امنیت وب اغلب از تکنیک‌های اختصاصی برای شناسایی کاربران مخرب استفاده می‌کنند، خواه ربات‌های خودکار یا انسان‌های واقعی که سعی در ایجاد آسیب دارند. در اینجا می‌توان بسیاری از استراتژی‌های مختلف را آزمایش کرد، چه استفاده از گیت خروجی انتخاب URL برای رمزگذاری رتبه‌بندی قابلیت اعتماد کاربر یا استفاده از دروازه خروجی Private Aggregation برای ساخت مجموعه‌های داده برای تشخیص ناهنجاری. انتخاب URL، Private Aggregation API
دسترسی منحصر به فرد را اندازه گیری کنید بسیاری از تولیدکنندگان محتوا و تبلیغ‌کنندگان اغلب می‌خواهند بدانند چه تعداد از افراد منحصربه‌فرد محتوای آنها را دیده‌اند. می‌توانید از «فضای ذخیره‌سازی مشترک» برای گزارش اولین باری که کاربر آگهی شما را دید، ویدیوی جاسازی شده، انتشارات، و جلوگیری از شمارش تکراری همان کاربر در یک سایت دیگر استفاده کنید و گزارشی پر سر و صدا از دسترسی تقریبی منحصر به فردتان به شما ارائه دهد. Private Aggregation API
اندازه گیری جمعیت شناسی کاربران تولیدکنندگان محتوا اغلب مایلند اطلاعات جمعیتی مخاطبان خود را درک کنند. می‌توانید از فضای ذخیره‌سازی مشترک برای ضبط داده‌های جمعیتی کاربر در زمینه‌ای که در اختیار دارید، مانند سایت 1P خود، استفاده کنید و از گزارش‌های انبوه برای گزارش آن در بسیاری از سایت‌های دیگر، مانند محتوای جاسازی شده، استفاده کنید. Private Aggregation API
دسترسی فرکانس K+ را اندازه گیری کنید گاهی اوقات به عنوان "تکرار موثر" توصیف می شود، اغلب حداقل تعداد بازدید وجود دارد قبل از اینکه کاربر محتوای خاصی را تشخیص دهد یا به خاطر بیاورد (اغلب در زمینه بازدیدهای تبلیغاتی). می‌توانید از ذخیره‌سازی مشترک برای ایجاد گزارش‌هایی از کاربران منحصربه‌فردی که حداقل K بار محتوایی را دیده‌اند، استفاده کنید. Private Aggregation API

این پیشنهاد قصد دارد یک API با هدف کلی ایجاد کند که از بسیاری از موارد استفاده احتمالی در آینده پشتیبانی کند. این اجازه می دهد تا آزمایش ها و تغییرات بیشتر در کنار اکوسیستم وب رشد کنند.

فضای ذخیره‌سازی مشترک چگونه کار می‌کند؟

فضای ذخیره‌سازی مشترک به شما امکان می‌دهد تا بدون به اشتراک گذاشتن اطلاعات کاربر (مانند تاریخچه مرورگر یا سایر جزئیات شخصی) با یک سایت جاسازی شده یا استخراج داده‌ها در سرورهای خود، تصمیمات آگاهانه‌ای را بر اساس داده‌های بین سایتی بگیرید.

می‌توانید در هر زمان در فضای ذخیره‌سازی مشترک بنویسید، مانند سایر APIهای ذخیره‌سازی جاوا اسکریپت مانند localStorage یا indexedDB. برخلاف سایر API های ذخیره سازی، شما فقط می توانید مقادیر ذخیره سازی مشترک را در یک محیط امن، که به عنوان Worklet ذخیره سازی اشتراکی شناخته می شود، بخوانید.

Worklet ها جایی هستند که منطق کسب و کار خود را اضافه می کنید. در داخل Worklet، شما مجاز به خواندن و پردازش یک مقدار از ذخیره سازی مشترک هستید، اما نمی توانید مستقیماً مقدار دقیق را به تماس گیرنده Worklet برگردانید. برای استخراج اطلاعات مفید از worklet، مجموعه ای از "دروازه ها" در دسترس هستند. دو دروازه در دسترس است، اما ممکن است در آینده بیشتر اضافه شود.

گیت‌های خروجی اشتراک‌گذاری API موجود عبارتند از:

  • انتخاب URL بین سایتی : می توانید یک اسکریپت Worklet را اجرا کنید تا یک URL از لیست ارائه شده، بر اساس داده های ذخیره شده انتخاب کنید، و سپس آن محتوا را در یک قاب محصور ارائه دهید.
  • تجمیع پر سر و صدا با Private Aggregation API : می توانید یک Worklet را برای ارسال داده های متقابل سایت از طریق Private Aggregation API اجرا کنید و یک گزارش خلاصه را برگردانید.

اشتراک‌گذاری API را امتحان کنید

API اشتراک‌گذاری شده برای گیت خروجی انتخاب URL و دروازه خروجی تجمیع خصوصی برای آزمایش در دسترس هستند. انتخاب محتوا در Chrome Canary/Dev/Beta M105+ قابل آزمایش است و Private Aggregation API برای آزمایش در Chrome M107+ Canary و Dev در دسترس است. API را می توان با فعال کردن همه APIهای حریم خصوصی آگهی در chrome://settings/adPrivacy آزمایش کرد.

از دمو استفاده کنید

یک نسخه نمایشی در دسترس است و می توانید کد را در GitHub مرور کنید.

این نسخه نمایشی از دیدگاه یک تبلیغ‌کننده، فناوری تبلیغات، توزیع‌کننده محتوا یا سایر خدمات شخص ثالث ساخته شده است که می‌خواهد اطلاعات را در سایت‌های ناشران مختلف ذخیره کند. در نسخه نمایشی، کد شخص ثالث مشابه برای هر مورد استفاده در هر دو سایت ناشر A و ناشر B اجرا می شود. برای مشاهده نحوه اشتراک گذاری داده ها در یک زمینه بین سایتی، از صفحات ناشر بازدید کنید.

نسخه نمایشی شامل موارد استفاده برای انتخاب محتوا و تجمیع خصوصی است.

برای نسخه نمایشی انتخاب محتوا، چرخش خلاقیت‌های تبلیغاتی ، سفارشی‌سازی تجربه استفاده برای مشتریان شناخته‌شده ، و موارد استفاده از آزمایش A/B در دسترس هستند.

برای نسخه نمایشی Private Aggregation، می‌توانید پیش‌نمایش منحصربه‌فرد اندازه‌گیری دسترسی منحصربه‌فرد ، اندازه‌گیری دسترسی فرکانس K+ و اندازه‌گیری جمعیت‌شناسی کاربر را مشاهده کنید.

اشکال‌زدایی ورکلت‌های ذخیره‌سازی مشترک با DevTools

برای بررسی ورکلت‌های ذخیره‌سازی مشترک که از صفحه‌ای که در آن هستید شروع شده‌اند، می‌توانید از برگه «منابع» در پانل DevTools بازدید کنید و نقطه شکست شنونده رویداد «Shared Storage Worklet / Script First Statement» را اضافه کنید. این نقطه شکست اجرای اسکریپت ماژول اولیه یا Worklet های کوتاه مدت را هنگام راه اندازی متوقف می کند.

اشکال زدایی یک Worklet Storage مشترک با افزودن شنونده در سطح رویداد.
یک نقطه انفصال را می توان به Worklet ذخیره سازی مشترک اضافه کرد.

علاوه بر این، صفحه chrome://inspect/#shared-storage-worklets همه Worklet های ذخیره سازی اشتراکی فعال را از همه صفحات نشان می دهد.

مشارکت کنید و بازخورد را به اشتراک بگذارید

پیشنهاد ذخیره‌سازی مشترک در دست بحث فعال است و ممکن است در آینده تغییر کند. اگر این API را امتحان کردید و بازخورد دارید، مایلیم آن را بشنویم.