מדידת היקף החשיפה למשתמשים ייחודיים

יצרני תוכן ומפרסמים רבים רוצים לדעת כמה אנשים ייחודיים ראו את התוכן שלהם. אתם יכולים להשתמש בנפח אחסון משותף כדי לתעד את הפעם הראשונה שבה משתמש ראה את המודעה, הסרטון המוטמע או אתר החדשות שלכם, ולמנוע ספירה כפולה של אותו משתמש באתרים שונים. אחר כך תוכלו להשתמש ב-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.

reach-measurement.js

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();

reach-measurement-worklet.js

// 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 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 sharedStorage.set(key, true);
  }
}

// Register the operation
register('reach-measurement', ReachMeasurementOperation);

Engage and share feedback

The Shared Storage proposal is under active discussion and subject to change in the future. If you try this API and have feedback, we'd love to hear it.