Đo lường phạm vi tiếp cận tần suất K+

Đôi khi được mô tả là "tần suất hiệu quả", thường có số lượt xem tối thiểu trước khi người dùng nhận ra hoặc nhớ lại nội dung nhất định (thường là trong ngữ cảnh của lượt xem quảng cáo). Bạn có thể sử dụng Bộ nhớ dùng chung để tạo báo cáo về những người dùng riêng biệt đã xem một nội dung ít nhất K lần.

API Bộ nhớ dùng chung là một Quyền riêng tư Đề xuất hộp cát cho mục đích chung, lưu trữ trên nhiều trang web, hỗ trợ nhiều các trường hợp sử dụng có thể xảy ra. API tổng hợp riêng tư là một dữ liệu đầu ra có trong Bộ nhớ dùng chung, cho phép bạn tổng hợp dữ liệu trên nhiều trang web.

Thử đo tần suất K+

Để thử nghiệm tính năng đo tần suất K+ bằng Bộ nhớ dùng chung và tính năng Tổng hợp riêng tư, hãy xác nhận rằng bạn đang sử dụng Chrome M107 trở lên. Bật mọi API quyền riêng tư trong quảng cáo trong chrome://settings/adPrivacy.

Bạn cũng có thể bật Bộ nhớ dùng chung bằng cờ --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames trong dòng lệnh.

Thử nghiệm mã mẫu

Bạn có thể muốn đo lường số người dùng đã xem nội dung của bạn từ K lần trở lên với một khách hàng nhất định trên các trang web khác nhau. Trong ví dụ này, số lượt hiển thị được thêm vào bộ nhớ dùng chung và tăng thêm 1 bất cứ khi nào nội dung được tải. Khi số lượt hiển thị đạt đến 3, API Tổng hợp riêng tư sẽ được gọi. Phương diện mã nội dung được mã hoá dưới dạng khoá tổng hợp và số lượng được dùng làm giá trị tổng hợp. Báo cáo tóm tắt sẽ cung cấp những thông tin như "Khoảng 391 người dùng đã xem mã chiến dịch quảng cáo 123 ít nhất 3 lần".

Trong ví dụ này:

  • k-frequency-measurement.js được tải thông qua một khung và chịu trách nhiệm tải worklet bộ nhớ dùng chung.
  • k-frequency-measurement-worklet.js là worklet bộ nhớ dùng chung đọc số lượt hiển thị trong bộ nhớ dùng chung và gửi báo cáo qua API tổng hợp riêng tư.

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 sharedStorage.get(hasReportedContentKey)) === 'true';
    const impressionCount = parseInt((await 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 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.contributeToHistogram({ bucket, value });

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

// Register the operation

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

Tương tác và chia sẻ ý kiến phản hồi

Xin lưu ý rằng đề xuất về API Bộ nhớ dùng chung đang được thảo luận và phát triển tích cực, do đó có thể thay đổi.

Chúng tôi rất mong được nghe ý kiến của bạn về Shared Storage API.

Luôn nắm thông tin mới nhất

Bạn cần được trợ giúp?