API ذخیرهسازی مشترک، وبسایتها را قادر میسازد تا دادههایی را که توسط سایت سطح بالا ایزوله نشدهاند، ذخیره و به آنها دسترسی داشته باشند. این امر، موارد استفاده بین سایتی را در عین احترام به حریم خصوصی کاربر، امکانپذیر و تسهیل میکند.
در حالی که کروم فضای ذخیرهسازی را پارتیشنبندی کرده و در حال گذار به سمت تجربه جدیدی است که انتخاب کاربر را در مورد کوکیهای شخص ثالث افزایش میدهد ، تعدادی از موارد استفاده مشروع وجود دارد که به فضای ذخیرهسازی پارتیشنبندی نشده متکی هستند که بدون کمک APIهای وب جدید امکانپذیر نیست. به عنوان مثال، یک تولیدکننده محتوا ممکن است بخواهد میزان دسترسی به محتوا را در سایتهای مختلف، بدون تکیه بر شناسههای بین سایتی، اندازهگیری کند. API ذخیرهسازی مشترک با ارائه مکانیسمی خصوصیتر برای ذخیره و دسترسی به دادههای پارتیشنبندی نشده در سایتها، این نیاز را برطرف میکند.
رابط برنامهنویسی کاربردی (API) ذخیرهسازی مشترک چیست؟
API ذخیرهسازی مشترک (Shared Storage API) یک مرکز ذخیرهسازی عمومی است که برای فعال کردن موارد استفاده بین سایتی با حفظ حریم خصوصی طراحی شده است. با ویژگیهایی مشابه APIهای localStorage و sessionStorage، ذخیرهسازی مشترک یک مخزن کلید-مقدار است که در آن دادهها میتوانند در هر زمانی نوشته شوند. برخلاف سایر APIهای ذخیرهسازی وب، دادههای ذخیرهسازی مشترک را میتوان در سایتهای سطح بالای مختلف به اشتراک گذاشت. با این حال، دادههای ذخیرهسازی مشترک فقط میتوانند از یک محیط امن خوانده شوند و با استفاده از APIهای خروجی محدود، خروجی داده شوند.
در نمودار قبلی، سایت shoes.example میتواند در سایتهای ناشر دیگری مانند news.example جاسازی شود و همچنان به همان دادهها دسترسی داشته باشد.
این قابلیت ذخیرهسازی مشترک، قابلیتهای بین سایتی را فعال میکند و در عین حال با جلوگیری از ردیابی بازدیدکنندگان سایت و محدود کردن دسترسی به دادهها، حریم خصوصی کاربر را ارتقا میدهد. دادهها فقط در یک محیط امن با قابلیتهای خروجی محدود (worklet) قابل دسترسی هستند.
فضای ذخیرهسازی مشترک، زیرساخت ذخیرهسازی زیربنایی برای تعداد محدودی از رابطهای برنامهنویسی کاربردی خروجی (Output API) است. یک رابط برنامهنویسی کاربردی خروجی (Output API) تنها راه استفاده از دادههای فضای ذخیرهسازی مشترک است. رابطهای برنامهنویسی کاربردی خروجی عبارتند از:
- انتخاب URL : بر اساس دادههای ذخیرهشده، یک URL را از لیست ارائهشده انتخاب کنید و سپس آن محتوا را در یک قاب محصور رندر کنید.
- تجمیع خصوصی : دادههای بین سایتی را از طریق API تجمیع خصوصی ارسال کنید تا یک گزارش خلاصه ایجاد شود.
چرا به فضای ذخیرهسازی اشتراکی نیاز داریم؟
API ذخیرهسازی مشترک یک مکانیزم ذخیرهسازی انعطافپذیر است که توسعهدهندگان وب میتوانند از آن در ترکیب با APIهای خروجی برای رسیدگی به بسیاری از موارد استفاده، از جمله جایگزینی چندین کاربرد موجود برای کوکیهای شخص ثالث، استفاده کنند. جزئیات بیشتر در مورد موارد استفاده بالقوه APIهای خروجی را ببینید: URL و Private Aggregation را انتخاب کنید.
آیا شرکت شما به دنبال راهحلهای ذخیرهسازی بین سایتی است که هنوز به آنها پرداخته نشده است؟ میتوانید مورد استفاده خود را به اشتراک بگذارید و یک مشکل را در مخزن متنباز Shared Storage GitHub ایجاد کنید.
خروجی APIها و موارد استفاده سازگار با Shared Storage
| خروجی API | مورد استفاده | توضیحات |
|---|---|---|
| انتخاب آدرس اینترنتی | چرخش آگهیهای تبلیغاتی | شما میتوانید دادههایی مانند شناسهی خلاق، تعداد بازدیدها و تعامل کاربر را ذخیره کنید تا مشخص شود کدام کاربران خلاق در سایتهای مختلف محتوا را مشاهده میکنند. این به شما امکان میدهد بازدیدها را متعادل کنید و از اشباع بیش از حد محتوای خاص جلوگیری کنید و در نتیجه از یک تجربه کاربری منفی احتمالی جلوگیری کنید. |
| انتخاب آدرس اینترنتی | تست A/B را اجرا کنید | یک تست A/B دو یا چند نسخه از یک پیکربندی را مقایسه میکند تا مشخص شود کدام یک بهترین عملکرد را دارد. میتوانید یک کاربر را به یک گروه آزمایشی اختصاص دهید، سپس آن گروه را در فضای ذخیرهسازی مشترک برای دسترسی متقابل ذخیره کنید. |
| انتخاب آدرس اینترنتی | سفارشیسازی تجربه کاربری برای مشتریان شناختهشده | شما میتوانید محتوای سفارشی و فراخوانهای اقدام را بر اساس وضعیت ثبتنام کاربر یا سایر وضعیتهای کاربر به اشتراک بگذارید. |
| انتخاب URL ، تجمیع خصوصی | راهکارهای مقابله با سوءاستفاده | سازمانهای ضد سوءاستفاده، ضد کلاهبرداری و امنیت وب اغلب از تکنیکهای اختصاصی برای شناسایی کاربران مخرب، چه رباتهای خودکار و چه انسانهای واقعی که سعی در ایجاد آسیب دارند، استفاده میکنند. در این مورد استفاده، میتوان استراتژیهای مختلفی را آزمایش کرد، چه استفاده از API Select URL برای رمزگذاری رتبهبندی اعتماد کاربر باشد و چه استفاده از API Private Aggregation برای ساخت مجموعه دادهها برای تشخیص ناهنجاری. |
| تجمیع خصوصی | سنجش دسترسی منحصر به فرد | بسیاری از تولیدکنندگان محتوا و تبلیغکنندگان اغلب میخواهند بدانند که چند نفر منحصر به فرد محتوای نمایش داده شده آنها را مشاهده کردهاند. شما میتوانید از Shared Storage برای گزارش اولین باری که یک کاربر تبلیغ، ویدیوی جاسازی شده یا انتشار شما را میبیند استفاده کنید. میتوانید از شمارش تکراری همان کاربر در سایتهای مختلف جلوگیری کنید و یک گزارش نویزی تجمعی برای میزان تقریبی دسترسی به محتوای منحصر به فرد خود ایجاد کنید. |
| تجمیع خصوصی | اندازهگیری جمعیتشناسی کاربران | تولیدکنندگان محتوا مشتاقند که جمعیتشناسی مخاطبان خود را درک کنند. فضای ذخیرهسازی مشترک به شما امکان میدهد دادههای جمعیتشناسی کاربران را در سایت شخص اول خود ثبت کنید و از گزارشهای تجمیعشده برای تجزیه و تحلیل این اطلاعات در پلتفرمهای مختلف دیگر، مانند محتوای جاسازیشده، استفاده کنید. |
| تجمیع خصوصی | اندازهگیری دامنه فرکانس K+ | گاهی اوقات به عنوان «فراوانی مؤثر» توصیف میشود، اغلب حداقل تعداد بازدید وجود دارد تا کاربر محتوای خاصی را تشخیص دهد یا به خاطر بیاورد (اغلب در زمینه بازدیدهای تبلیغاتی). میتوانید از Shared Storage برای ایجاد گزارشهایی از کاربران منحصر به فردی که حداقل K بار یک محتوا را دیدهاند، استفاده کنید. |
فضای ذخیرهسازی اشتراکی چگونه کار میکند؟
فضای ذخیرهسازی مشترک به شما امکان میدهد بدون اشتراکگذاری اطلاعات کاربر (مانند تاریخچه مرورگر یا سایر اطلاعات شخصی) با یک سایت جاسازیشده یا انتقال دادهها به سرورهای خودتان، بر اساس دادههای بین سایتی، تصمیمات آگاهانهای بگیرید.
شما میتوانید در هر زمانی روی فضای ذخیرهسازی مشترک بنویسید، اما فقط میتوانید مقادیر فضای ذخیرهسازی مشترک را در یک محیط امن، که به عنوان worklet شناخته میشود، بخوانید.
کارپوشههای ذخیرهسازی اشتراکی جایی هستند که شما منطق کسبوکار خود را اضافه میکنید و سپس مقداری را از فضای ذخیرهسازی اشتراکی میخوانید و پردازش میکنید، بدون اینکه مستقیماً مقدار دقیق را به فراخوانیکنندهی کارپوشه برگردانید. میتوانید از APIهای Private Aggregation یا Select URL Output برای استخراج اطلاعات از کارپوشه استفاده کنید. APIهای خروجی اضافی ممکن است با گزارش موارد استفاده جدید در دسترس قرار گیرند.
وضعیت API
رابط برنامهنویسی کاربردی ( API) ذخیرهسازی مشترک (Shared Storage API) به طور عمومی در دسترس است. برای ثبتنام در Privacy Sandbox ، استفاده از API یا فعالسازی برای توسعه محلی، دستورالعملها را دنبال کنید.
| پیشنهاد | وضعیت |
|---|---|
| اجازه نوشتن از سرصفحه های پاسخ توضیح دهنده مشکل GitHub | موجود در M124. می توان آن را به صورت دستی در M119-M123 فعال کرد |
| اشکال زدایی Worklet های ذخیره سازی مشترک با DevTools بخش | موجود در M120 |
| محدودیت ذخیرهسازی دادههای ذخیرهسازی مشترک را به ۵ مگابایت بهروزرسانی کنید توضیح دهنده | موجود در M124 |
createWorklet() برای ایجاد Worklet های متقاطع بدون iframe | موجود در M125 |
به اسکریپت متقاطع در addModule() اجازه دهید و createWorklet() برای مطابقت با رفتار تراز کنید | موجود در M130 |
| به Worklet Storage مشترک برای خواندن گروههای علاقهمند اجازه دهید توضیح دهنده | موجود در M134 |
پشتیبانی از مبدا داده های سفارشی در createWorklet()توضیح دهنده | موجود در M135 |
| اشکال زدایی Worklet های ذخیره سازی مشترک با DevTools توضیح دهنده مشکل GitHub | در Q2 2025 مورد انتظار است |
مشارکت کنید و بازخورد خود را به اشتراک بگذارید
توجه داشته باشید که پیشنهاد API ذخیرهسازی مشترک (Shared Storage API) در دست بحث و توسعه فعال است و بنابراین ممکن است تغییر کند.
مشتاقانه منتظر شنیدن نظرات شما در مورد API ذخیرهسازی مشترک هستیم.
- پیشنهاد : بررسی جزئیات پیشنهاد .
- بحث : برای پرسیدن سوال و به اشتراک گذاشتن بینشهایتان، به بحث جاری بپیوندید.