اجازه دسترسی نامحدود و نامحدود برای نوشتن فضای بین سایتی با دسترسی خواندن حفظ حریم خصوصی.
وضعیت پیاده سازی
این سند پیشنهادی را برای ذخیرهسازی بینسایتی بدون پارتیشن ارائه میکند: ذخیرهسازی مشترک API.
- اشتراکگذاری API اکنون به در دسترس بودن عمومی منتقل شده است.
- یک نسخه ی نمایشی زنده در دسترس است ، به عنوان آزمایش:
- دروازه خروجی انتخاب URL برای آزمایش محلی از Chrome M105+ در دسترس است.
- دروازه خروجی تجمیع خصوصی برای آزمایش محلی از Chrome M107+ در دسترس است.
- اندازهگیری با Private Aggregation API اکنون در دسترس است.
- وضعیت پلتفرم کروم
建议 | 状态 |
---|---|
针对内容选择功能的事件级报告 (selectURL() ) |
至少可继续使用到 2026 年 |
针对每个网站设定预算 说明 |
在 M119 中提供 |
允许从响应标头写入 说明 GitHub 问题 |
在 M124 中提供。可在 M119-M123 中手动启用 |
不公开汇总贡献超时 说明 |
在 M119 中提供 |
使用开发者工具调试共享存储空间 Worklet 部分 |
在 M120 中提供 |
将共享存储空间的存储空间上限更新为 5MB 说明 |
在 M124 中提供 |
چرا به این API نیاز داریم؟
برای جلوگیری از ردیابی کاربران بین سایتی، مرورگرها تمام اشکال ذخیره سازی (کوکی ها، محلی ذخیره سازی، حافظه های پنهان و غیره) را پارتیشن بندی می کنند. با این حال، تعدادی از موارد استفاده قانونی وجود دارد که به فضای ذخیرهسازی پارتیشن نشده متکی هستند که بدون کمک APIهای وب جدید غیرممکن است. برای مثال، ممکن است یک تولیدکننده محتوا بخواهد دسترسی به سایتهای مختلف را بدون تکیه بر شناسههای متقابل اندازهگیری کند.
Shared Storage API به سایتها اجازه میدهد تا دادههای بینسایتی پارتیشننشده را ذخیره کرده و به آن دسترسی داشته باشند. این داده ها باید در یک محیط امن خوانده شوند تا از نشت جلوگیری شود.
میتوانید از دادههای ذخیرهسازی مشترک به دو روش استفاده کنید :
- انتخاب محتوای بین سایتی
- تجمیع پر سر و صدا داده های متقابل سایت با 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 مشترک با افزودن شنونده در سطح رویداد.](https://developers.google.cn/static/privacy-sandbox/assets/images/shared-storage-devtools-debugging.png?hl=fa)
علاوه بر این، صفحه chrome://inspect/#shared-storage-worklets
همه Worklet های ذخیره سازی اشتراکی فعال را از همه صفحات نشان می دهد.
مشارکت کنید و بازخورد را به اشتراک بگذارید
پیشنهاد ذخیرهسازی مشترک در دست بحث فعال است و ممکن است در آینده تغییر کند. اگر این API را امتحان کردید و بازخورد دارید، مایلیم آن را بشنویم.
- GitHub : پیشنهاد را بخوانید، به وایت پیپر برسید ، سوالاتی را مطرح کنید و در بحث شرکت کنید .
- اطلاعیههای API ذخیرهسازی مشترک : به اعلانهای گذشته در لیست پستی ما بپیوندید یا مشاهده کنید
- پشتیبانی برنامهنویس : سؤال بپرسید و به بحثهای مربوط به مخزن پشتیبانی توسعهدهنده Privacy Sandbox بپیوندید.