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

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

Shared Storage API یک پیشنهاد Privacy Sandbox برای اهداف عمومی، فضای ذخیره‌سازی بین سایتی است که از بسیاری از موارد استفاده ممکن پشتیبانی می‌کند. Private Aggregation API خروجی موجود در ذخیره سازی مشترک است که به شما امکان می دهد داده های بین سایتی را جمع آوری کنید.

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

برای آزمایش اندازه‌گیری فرکانس K+ با فضای ذخیره‌سازی مشترک و تجمیع خصوصی، تأیید کنید که از Chrome M107 یا جدیدتر استفاده می‌کنید. سپس پرچم آزمایش Privacy Sandbox Ads APIs را در chrome://flags/#privacy-sandbox-ads-apis فعال کنید.

آزمایش APIهای Privacy Sandbox Ads را برای استفاده از این APIها فعال کنید

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

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

ممکن است بخواهید تعداد کاربرانی را که محتوای شما را K یا بیشتر از یک مشتری معین در سایت‌های مختلف دیده‌اند اندازه‌گیری کنید. در این مثال، تعداد نمایش به فضای ذخیره‌سازی مشترک اضافه می‌شود، جایی که هر زمان که محتوا بارگیری می‌شود، 1 افزایش می‌یابد. وقتی تعداد نمایش‌ها به 3 رسید، API جمع‌آوری خصوصی فراخوانی می‌شود. بعد Content ID به عنوان کلید تجمیع کدگذاری می شود و تعداد به عنوان مقدار قابل جمع آوری استفاده می شود. گزارش خلاصه اطلاعاتی مانند "تقریباً 391 کاربر حداقل 3 بار شناسه کمپین تبلیغاتی 123 را دیده اند."

در این مثال:

  • k-frequency-measurement.js از طریق یک قاب بارگیری می شود و مسئول بارگیری Worklet ذخیره سازی مشترک است.
  • k-frequency-measurement-worklet.js یک Worklet ذخیره سازی مشترک است که تعداد نمایش ها را در فضای ذخیره سازی مشترک می خواند و گزارشی را از طریق Private Aggregation 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();

k-frequency-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 simply 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 this.sharedStorage.get(hasReportedContentKey)) === 'true';
    const impressionCount = parseInt((await this.sharedStorage.get(impressionCountKey)) || 0);

    // Do not report if a report has been sent already
    if (hasReportedContent) {
      return;
    }

    // Check impression count against frequency limit
    if (impressionCount < kFreq) {
      await this.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 via the Private Aggregation API
    privateAggregation.sendHistogramReport({ bucket, value });

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

// Register the operation

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

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

پیشنهاد ذخیره‌سازی مشترک در دست بحث فعال است و ممکن است در آینده تغییر کند. اگر این API را امتحان کردید و بازخورد دارید، مایلیم آن را بشنویم.