دسترسی فرکانس K+ را اندازه گیری کنید

گاهی اوقات به عنوان «فراوانی مؤثر» توصیف می‌شود، اغلب حداقل تعداد بازدید وجود دارد تا کاربر محتوای خاصی را تشخیص دهد یا به خاطر بیاورد (اغلب در زمینه بازدیدهای تبلیغاتی). می‌توانید از Shared Storage برای ایجاد گزارش‌هایی از کاربران منحصر به فردی که یک محتوا را حداقل K بار دیده‌اند، استفاده کنید.

API ذخیره‌سازی مشترک (Shared Storage API ) یک پیشنهاد Privacy Sandbox برای ذخیره‌سازی چندمنظوره و بین سایتی است که از بسیاری از موارد استفاده ممکن پشتیبانی می‌کند. API تجمیع خصوصی (Private Aggregation API) یک خروجی موجود در ذخیره‌سازی مشترک است که به شما امکان می‌دهد داده‌های بین سایتی را تجمیع کنید.

اندازه‌گیری فرکانس K+ را امتحان کنید

برای آزمایش اندازه‌گیری فرکانس K+ با Shared Storage و Private Aggregation، تأیید کنید که از Chrome M107 یا بالاتر استفاده می‌کنید. تمام APIهای حریم خصوصی تبلیغات را در chrome://settings/adPrivacy فعال کنید.

همچنین می‌توانید Shared Storage را با استفاده از پرچم --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames در خط فرمان فعال کنید.

با نمونه کدها آزمایش کنید

ممکن است بخواهید تعداد کاربرانی را که محتوای شما را K بار یا بیشتر برای یک کلاینت مشخص در سایت‌های مختلف دیده‌اند، اندازه‌گیری کنید. در این مثال، تعداد نمایش به فضای ذخیره‌سازی مشترک اضافه می‌شود و هر زمان که محتوا بارگذاری شود، ۱ واحد افزایش می‌یابد. وقتی تعداد نمایش به ۳ رسید، API تجمیع خصوصی فراخوانی می‌شود. بُعد شناسه محتوا به عنوان کلید تجمیع کدگذاری می‌شود و تعداد به عنوان مقدار قابل تجمیع استفاده می‌شود. گزارش خلاصه اطلاعاتی مانند "تقریباً ۳۹۱ کاربر، شناسه کمپین تبلیغاتی ۱۲۳ را حداقل ۳ بار دیده‌اند" ارائه می‌دهد.

در این مثال:

  • k-frequency-measurement.js با استفاده از یک فریم بارگذاری می‌شود و مسئول بارگذاری worklet ذخیره‌سازی مشترک است.
  • k-frequency-measurement-worklet.js یک worklet ذخیره‌سازی مشترک است که تعداد نمایش‌ها را در فضای ذخیره‌سازی مشترک می‌خواند و با استفاده از API تجمیع خصوصی، گزارشی ارسال می‌کند.

k-frequency-measurement.js

async function injectContent() {
  // Load the Shared Storage worklet
  await window.sharedStorage.worklet.addModule('k-freq-measurement-worklet.js');

  // Run the K-frequency measurement operation
  await window.sharedStorage.run('k-freq-measurement', { data: { kFreq: 3, contentId: 123 });
}

injectContent();

kuency-measurement-worklet.js

// Learn more about noise and scaling from the Private Aggregation fundamentals
// documentation on Chrome blog
const SCALE_FACTOR = 65536;

/**
 * The bucket key must be a number, and in this case, it is just the content
 * ID itself. For more complex bucket key construction, see other use cases in
 * this demo.
 */
function convertContentIdToBucket(contentId) {
  return BigInt(contentId);
}

class KFreqMeasurementOperation {
  async run(data) {
    const { kFreq, contentId } = data;

    // Read from Shared Storage
    const hasReportedContentKey = 'has-reported-content';
    const impressionCountKey = 'impression-count';
    const hasReportedContent = (await sharedStorage.get(hasReportedContentKey)) === 'true';
    const impressionCount = parseInt((await sharedStorage.get(impressionCountKey)) || 0);

    // Don't report if a report has been sent already
    if (hasReportedContent) {
      return;
    }

    // Check impression count against frequency limit
    if (impressionCount < kFreq) {
      await sharedStorage.set(impressionCountKey, impressionCount + 1);
      return;
    }

    // Generate the aggregation key and the aggregatable value
    const bucket = convertContentIdToBucket(contentId);
    const value = 1 * SCALE_FACTOR;

    // Send an aggregatable report using the Private Aggregation API
    privateAggregation.contributeToHistogram({ bucket, value });

    // Set the report submission status flag
    await sharedStorage.set(hasReportedContentKey, 'true');
  }
}

// Register the operation

register('k-freq-measurement', KFreqMeasurementOperation); \

مشارکت کنید و بازخورد خود را به اشتراک بگذارید

توجه داشته باشید که پیشنهاد API ذخیره‌سازی مشترک (Shared Storage API) در دست بحث و توسعه فعال است و بنابراین ممکن است تغییر کند.

مشتاقانه منتظر شنیدن نظرات شما در مورد API ذخیره‌سازی مشترک هستیم.