يمكنك تشغيل أداة عمل مساحة التخزين المشتركة لاختيار عنوان URL وعرضه في إطار محاط بحدود.
Shared Storage API هي واجهة برمجة تطبيقات للخصوصية وضع الحماية للغرض العام، والتخزين على مواقع إلكترونية متعددة، ويدعم العديد من حالات الاستخدام المحتملة. أحد الأمثلة على ذلك هو التحكم في التكرار، وهو متاح في الإصدار التجريبي 104.0.5086.0 من Chrome والإصدارات الأحدث.
شغِّل نصًا برمجيًا لـ Worklet لتحديد عنوان URL من قائمة متوفرة، بناءً على ملف ثم عرض عنوان URL هذا في إطار محاط بحدود. يمكن استخدام هذا لتحديد إعلانات جديدة أو محتوى آخر عند بلوغ الحدّ الأقصى لعدد مرات الظهور
اختبار اختيار تصميم الإعلان حسب فترة التكرار
لاختبار اختيار تصاميم الإعلانات حسب معدّل التكرار من خلال "مساحة التخزين المشتركة" و"الإطارات المحدودة"، يجب تأكيد
يستخدمون Chrome 104.0.5086.0 أو إصدار أحدث. تفعيل جميع واجهات برمجة تطبيقات الخصوصية في عرض الإعلانات ضمن "chrome://settings/adPrivacy
"
يمكنك أيضًا تفعيل "مساحة التخزين المشتركة" باستخدام العلامة --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
في سطر الأوامر.
اختبار نماذج الرموز
لتحديد عنوان URL مبهم وإنشائه، سجّل وحدة بيئة العمل لقراءة بيانات التخزين. تتلقى فئة Worklet قائمة تضم ما يصل إلى ثمانية عناوين URL، ثم يؤدي إلى إرجاع فهرس عنوان URL المحدد.
عندما يستدعي العميل الدالة sharedStorage.selectURL()
،
ينفذ ويعرض عنوان URL مبهمًا لعرضه في إطار محاط بحدود.
لنفترض أنّك تريد اختيار إعلان أو محتوى مختلف لعرضه استنادًا إلى معدّل تكرار مشاهدة المستخدم له من قبل. يمكنك احتساب عدد المرات التي شاهد فيها المستخدم المحتوى، وتخزين هذه القيمة في مساحة تخزين مشتركة. بعد التخزين، تصبح القيمة في مساحة التخزين المشتركة متاحة لك عبر مصادر مختلفة.
بعد ذلك، تقرأ الوظيفة المصغّرة لمساحة التخزين المشتركة القيم في مساحة التخزين المشتركة، وتزيد من العدّاد مع كل طريقة عرض إضافية. وإذا لم يصل العدد إلى الحد الأقصى مسبق التحديد، يتم عرض المحتوى الذي تريد عرضه (الفهرس 1
). وإذا لم يكن الأمر كذلك، سيتم عرض عنوان URL التلقائي (الفهرس 0
).
في هذا المثال:
- يتم تحميل
creative-selection-by-frequencyjs
عبر إطار iframe الخاص بصانع المحتوى أو المعلن، وهو مسؤول لتحميل وظيفة التخزين المشتركة وعرض القيمة المعروضة المصدر في إطار مسيّج. creative-selection-by-frequency-worklet.js
هو وظيفة التخزين المشتركة التي تقرأ عدد مرّات الظهور لتحديد عنوان URL الذي يتم عرضه لمحتوى أو تصميم إعلان.
creative-selection-by-frequency.js
// The first URL is the default content or ad to be rendered when the frequency limits reached.
const CONTENT_URLS = [
{ url: `https://${contentProducerUrl}/default-content.html` },
{ url: `https://${contentProducerUrl}/example-content.html` },
];
async function injectAd() {
// Load the worklet module.
await window.sharedStorage.worklet.addModule('creative-selection-by-frequency-worklet.js');
// Set the initial frequency count
window.sharedStorage.set('frequency-count', 0, {
ignoreIfPresent: true,
});
// Run the URL selection operation to choose an ad based on the frequency count in shared storage.
const fencedFrameConfig = await window.sharedStorage.selectURL('creative-selection-by-frequency', CONTENT_URLS, {
resolveToConfig: true
});
// Render the opaque URL into a fenced frame
document.getElementById('content-slot').config = fencedFrameConfig;
}
injectAd();
creative-selection-by-frequency-worklet.js
const FREQUENCY_LIMIT = 5;
class CreativeSelectionByFrequencyOperation {
async run(urls, data) {
// Read the current frequency limit in shared storage
const count = parseInt(await sharedStorage.get('frequency-count'));
// Check if the frequency limit has been reached.
if (count === FREQUENCY_LIMIT) {
console.log('Frequency limit has been reached, and the default content will be rendered.');
return 0;
}
// Set the new frequency count in shared storage
await sharedStorage.set('frequency-count', count + 1);
return 1;
}
}
// Register the operation as 'creative-selection-by-frequency'.
register('creative-selection-by-frequency', CreativeSelectionByFrequencyOperation);
حالات الاستخدام
هذه ليست سوى بعض حالات الاستخدام المحتملة لمساحة التخزين المشتركة. سنضيف وأستمر في إضافة أمثلة أثناء تلقّي الملاحظات واكتشاف حالات الاستخدام الجديدة.
اختيار المحتوى
اختيار محتوى مختلف وعرضه على مواقع إلكترونية مختلفة في الإطارات المسوّرة استنادًا إلى المعلومات التي تم جمعها في مساحة التخزين المشتركة وبوابة المخرجات لحالات الاستخدام هذه هي اختيار عنوان URL.
- عرض تصميمات الإعلانات بالتناوب: بيانات المتجر، مثل رقم تعريف تصميم الإعلان وعدد المشاهدات وتفاعل المستخدمين، لتحديد مستخدمي تصميم الإعلان رؤيتها عبر المواقع المختلفة.
- اختبار A/B: يمكنك تعيين مستخدم إلى مجموعة تجربة، ثم تخزين هذه المجموعة في مساحة التخزين المشتركة للوصول إلى هذه المجموعة من مواقع إلكترونية متعددة.
- تجارب المستخدمين المخصّصة: مشاركة محتوى مخصّص وعبارات تحث المستخدم على اتخاذ إجراء استنادًا إلى حالة تسجيل المستخدم أو حالات المستخدم الأخرى
إنشاء تقارير ملخّصة
جمع المعلومات باستخدام "مساحة التخزين المشتركة" وإنشاء تقرير ملخص مجمّع صاخب تتمثل بوابة المخرجات لحالات الاستخدام هذه في واجهة برمجة تطبيقات التجميع الخاص:
- قياس مدى الوصول الفريد: يرغب العديد من منتجي المحتوى والمعلنين في معرفة عدد المستخدمين من المستخدمين شاهدوا المحتوى الخاص بهم. استخدام "مساحة التخزين المشتركة" لتسجيل أول مرة يُجري فيها المستخدم الأشخاص الذين شاهدوا إعلانك أو الفيديو المضمّن أو جهة النشر، ومنع الإعلانات المكررة الذي يظهر فيه المستخدم نفسه في مواقع إلكترونية مختلفة. ويمكنك بعد ذلك استخدام Private Aggregation API للحصول على تقرير ملخّص لمدى وصولك.
- قياس الخصائص الديمغرافية: غالبًا ما يرغب منتجو المحتوى في فهم الخصائص الديمغرافية جمهورك. يمكنك استخدام مساحة التخزين المشتركة لتسجيل البيانات الديموغرافية للمستخدمين في والسياق الذي تظهر فيه، مثل موقع الطرف الأول، واستخدام البيانات لإعداد تقارير عنها في العديد من المواقع الإلكترونية الأخرى، مثل المحتوى المضمَّن.
- قياس مرات الظهور بالآلاف: يتم وصفها أحيانًا باسم "التكرار الفعال"، غالبًا ما يكون هناك حد أدنى قبل أن يتعرف المستخدم على محتوى معين أو يتذكره (غالبًا في سياق مشاهدات الإعلان). يمكنك استخدام مساحة التخزين المشتركة لإنشاء التقارير من المستخدمين الفريدين الذين شاهدوا جزءًا من المحتوى ألف مرة على الأقل.
التفاعل مع الملاحظات ومشاركتها
إنّ اقتراح مساحة التخزين المشتركة قيد المناقشة الحالية ويخضع للتغيير. في المستقبل. ويسعدنا معرفة رأيك في حال تجربة واجهة برمجة التطبيقات هذه وتلقّي أي ملاحظات.
- GitHub: اطّلِع على اقتراح والوصول إلى التقرير الموجز وطرح الأسئلة والمشاركة في المناقشة
- إشعارات واجهة برمجة التطبيقات لمساحة التخزين المشتركة: يمكنك الانضمام إلى الإشعارات السابقة أو الاطّلاع عليها في القائمة البريدية.
- فريق دعم المطوّرين: يمكنك طرح الأسئلة والانضمام إلى المناقشات على مستودع دعم المطوّرين ضمن "مبادرة حماية الخصوصية"