יצרני תוכן ומפרסמים רבים רוצים לדעת כמה אנשים ייחודיים ראו את התוכן שלהם. אתם יכולים להשתמש בנפח אחסון משותף כדי לתעד את הפעם הראשונה שבה משתמש ראה את המודעה, הסרטון המוטמע או אתר החדשות שלכם, ולמנוע ספירה כפולה של אותו משתמש באתרים שונים. אחר כך תוכלו להשתמש ב-Private Aggregation API כדי להפיק דוח סיכום לגבי היקף החשיפה.
Shared Storage API מאפשר פרטיות הצעת Sandbox למטרה כללית, אחסון באתרים שונים, שתומך בהרבה ותרחישים לדוגמה אפשריים. Private Aggregation API הוא פלט שזמין באחסון משותף שמאפשר לכם לצבור נתונים מאתרים שונים. בסקירה המפורטת על היקף החשיפה תוכלו למצוא מידע נוסף על השיטות להטמעת המדידות האלה.
מדידה של היקף החשיפה למשתמשים ייחודיים
כדי לערוך ניסויים במדידת היקף החשיפה למשתמשים ייחודיים, בשילוב עם אחסון משותף וצבירת נתונים פרטית, צריך לוודא שאתם משתמשים ב-Chrome מגרסה M107 ואילך. הפעלת כל ממשקי ה-API לשמירה על פרטיות בפרסום במסגרת chrome://settings/adPrivacy
.
אפשר להפעיל אחסון משותף גם באמצעות הדגל --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
בשורת הפקודה.
התנסות עם דוגמאות קוד
כדאי לעקוב אחרי מספר המשתמשים הייחודיים שראו את התוכן שלכם באתרים שונים. בדוגמה הזו, המאפיין Content ID מקודד במפתח הצבירה (קטגוריה), והספירה משמשת כערך המצטבר. דוח הסיכום יכלול מידע כמו 'כ-391 משתמשים ראו את מזהה התוכן 123'.
בדוגמה הזו:
* unique-reach-measurement.js
נטען באמצעות מסגרת, והוא אחראי לטעון את worklet של האחסון המשותף.
* unique-reach-measurement-worklet.js
הוא ה-worklet של נפח אחסון משותף שבודק את הדגל באחסון המשותף ושולח דוח דרך Private Aggregation API.
async function measureUniqueReach() {
// Load the Shared Storage worklet
await window.sharedStorage.worklet.addModule('reach-measurement-worklet.js');
// Run the reach measurement operation
await window.sharedStorage.run('reach-measurement', { data: { contentId: '1234' } });
}
measureUniqueReach();
// Learn more about noise and scaling from the Private Aggregation fundamentals
// documentation on Chrome blog
const SCALE_FACTOR = 65536;
function convertContentIdToBucket(contentId) {
return BigInt(contentId);
}
class ReachMeasurementOperation {
async run(data) {
const { contentId } = data;
// Read from Shared Storage
const key = 'has-reported-content';
const hasReportedContent = (await this.sharedStorage.get(key)) === 'true';
// Do not report if a report has been sent already
if (hasReportedContent) {
return;
}
// Generate the aggregation key and the aggregatable value
const bucket = convertContentIdToBucket(contentId);
const value = 1 * SCALE_FACTOR;
// Send an aggregatable report via the Private Aggregation API
privateAggregation.contributeToHistogram({ bucket, value });
// Set the report submission status flag
await this.sharedStorage.set(key, true);
}
}
// Register the operation
register('reach-measurement', ReachMeasurementOperation);
מעורבות ושיתוף משוב
ההצעה לנפח אחסון משותף נמצאת בדיון פעיל וכפופה לשינויים הוא בעתיד. אם ניסיתם את ה-API הזה ויש לכם משוב, נשמח לשמוע אותו.
- GitHub: קראו את הצעה, לעיון בסקירה המפורטת, העלאת שאלות והשתתפות בדיון.
- הודעות על Shared Storage API: הצטרפות להודעות קודמות או הצגה שלהן ברשימת התפוצה שלנו
- תמיכה למפתחים: אפשר לשאול שאלות ולהצטרף לדיונים מאגר התמיכה למפתחים של ארגז החול לפרטיות