Chọn mẫu quảng cáo theo tần suất

Chạy một worklet Bộ nhớ dùng chung để chọn một URL và hiển thị URL đó trong khung được bảo vệ.

API Bộ nhớ dùng chung là một đề xuất của Hộp cát về quyền riêng tư cho mục đích chung, lưu trữ trên nhiều trang web, hỗ trợ nhiều trường hợp sử dụng có thể xảy ra. Một ví dụ là tính năng điều khiển tần suất, có sẵn để kiểm thử trong Chrome Beta 104.0.5086.0 trở lên.

Chạy một tập lệnh worklet để chọn một URL từ danh sách được cung cấp, dựa trên dữ liệu đã lưu trữ, rồi kết xuất URL đó trong một khung bảo vệ. Bạn có thể dùng thuộc tính này để chọn quảng cáo mới hoặc nội dung khác khi đã đạt đến giới hạn tần suất.

Thử nghiệm lựa chọn mẫu quảng cáo theo tần suất

Để kiểm tra lựa chọn mẫu quảng cáo theo tần suất với Bộ nhớ dùng chung và Khung bảo vệ, hãy xác nhận rằng bạn đang sử dụng Chrome 104.0.5086.0 trở lên. Sau đó, hãy bật cờ thử nghiệm API Quảng cáo hộp cát về quyền riêng tư tại chrome://flags/#privacy-sandbox-ads-apis.

Đặt thử nghiệm API Quảng cáo trên Hộp cát về quyền riêng tư thành bật để sử dụng các API này

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 với mã mẫu

Để chọn và tạo một URL mờ, hãy đăng ký một mô-đun worklet để đọc dữ liệu bộ nhớ dùng chung. Lớp worklet sẽ nhận được danh sách gồm tối đa 8 URL, sau đó trả về chỉ mục của URL đã chọn.

Khi ứng dụng gọi sharedStorage.selectURL(), công việc sẽ thực thi và trả về một URL mờ để kết xuất vào một khung được bảo vệ.

Giả sử bạn muốn chọn một quảng cáo hoặc nội dung khác để hiển thị dựa trên tần suất mà người dùng đã nhìn thấy quảng cáo hoặc nội dung đó trước đây. Bạn có thể đếm số lần một người dùng đã xem một nội dung và lưu trữ giá trị đó vào bộ nhớ dùng chung. Sau khi được lưu trữ, bạn sẽ có thể sử dụng giá trị trong bộ nhớ dùng chung trên nhiều nguồn gốc.

Sau đó, công việc của bộ nhớ dùng chung sẽ đọc các giá trị trong bộ nhớ dùng chung và tăng bộ đếm theo từng chế độ xem bổ sung. Nếu số lượng không đạt đến giới hạn định sẵn, nội dung bạn muốn hiển thị sẽ được trả về (chỉ mục 1). Nếu không, URL mặc định sẽ được trả về (chỉ mục 0).

Trong ví dụ này:

  • creative-selection-by-frequencyjs được tải qua iframe của nhà sản xuất nội dung hoặc nhà quảng cáo, đồng thời chịu trách nhiệm tải công việc bộ nhớ dùng chung, đồng thời hiển thị nguồn mờ được trả về trong một khung được bảo vệ.
  • creative-selection-by-frequency-worklet.js là công việc về bộ nhớ dùng chung có chức năng đọc số tần suất để xác định URL nào được trả về cho một nội dung hoặc một mẫu quảng cáo.

creative-selection-by-frequency.js

// The first URL is the default content or ad to be rendered when the frequency limits reached.
const CONTENT_URLS = [
  { url: `https://${contentProducerUrl}/default-content.html` },
  { url: `https://${contentProducerUrl}/example-content.html` },
];

async function injectAd() {
  // Load the worklet module.
  await window.sharedStorage.worklet.addModule('creative-selection-by-frequency-worklet.js');

  // Set the initial frequency count
  window.sharedStorage.set('frequency-count', 0, {
    ignoreIfPresent: true,
  });

  // Run the URL selection operation to choose an ad based on the frequency count in shared storage.
  const fencedFrameConfig = await window.sharedStorage.selectURL('creative-selection-by-frequency', CONTENT_URLS, {
    resolveToConfig: true
  });

  // Render the opaque URL into a fenced frame
  document.getElementById('content-slot').config = fencedFrameConfig;
}

injectAd();

creative-selection-by-frequency-worklet.js

const FREQUENCY_LIMIT = 5;

class CreativeSelectionByFrequencyOperation {
  async run(urls, data) {
    // Read the current frequency limit in shared storage
    const count = parseInt(await this.sharedStorage.get('frequency-count'));

    // Check if the frequency limit has been reached.
    if (count === FREQUENCY_LIMIT) {
      console.log('Frequency limit has been reached, and the default content will be rendered.');
      return 0;
    }

    // Set the new frequency count in shared storage
    await this.sharedStorage.set('frequency-count', count + 1);
    return 1;
  }
}

// Register the operation as 'creative-selection-by-frequency'.
register('creative-selection-by-frequency', CreativeSelectionByFrequencyOperation);

Trường hợp sử dụng

Đây chỉ là một số trường hợp sử dụng Bộ nhớ dùng chung. Chúng tôi sẽ tiếp tục thêm các ví dụ khi nhận được ý kiến phản hồi và khám phá các trường hợp sử dụng mới.

Lựa chọn nội dung

Chọn và hiển thị nhiều nội dung trên các trang web khác nhau trong khung bảo vệ dựa trên thông tin được thu thập trong Bộ nhớ dùng chung. Cổng đầu ra cho các trường hợp sử dụng này là lựa chọn URL.

  • Xoay vòng mẫu quảng cáo: Lưu trữ dữ liệu, chẳng hạn như mã mẫu quảng cáo, số lượt xem và lượt tương tác của người dùng, để xác định xem người dùng mẫu quảng cáo nào sẽ nhìn thấy mẫu quảng cáo nào trên các trang web khác nhau.
  • Thử nghiệm A/B: Bạn có thể chỉ định người dùng cho một nhóm thử nghiệm, sau đó lưu trữ nhóm đó trong Bộ nhớ dùng chung để truy cập trên nhiều trang web.
  • Trải nghiệm người dùng tuỳ chỉnh: Chia sẻ nội dung tuỳ chỉnh và lời kêu gọi hành động dựa trên trạng thái đăng ký của người dùng hoặc các trạng thái khác của người dùng

Tạo báo cáo tóm tắt

Thu thập thông tin bằng Bộ nhớ dùng chung và tạo một báo cáo tóm tắt tổng hợp, nhiễu. Cổng đầu ra cho các trường hợp sử dụng này là API tổng hợp riêng tư.

  • Đo lường phạm vi tiếp cận người dùng riêng biệt: Nhiều nhà sản xuất và nhà quảng cáo nội dung muốn biết có bao nhiêu người riêng biệt đã xem nội dung của họ. Hãy sử dụng Bộ nhớ dùng chung để ghi lại lần đầu tiên người dùng xem quảng cáo, video nhúng hoặc ấn bản của bạn, đồng thời tránh tính trùng lặp một người dùng đó trên các trang web khác nhau. Sau đó, bạn có thể sử dụng API tổng hợp riêng tư để tạo báo cáo tóm tắt cho phạm vi tiếp cận của mình.
  • Đo lường thông tin nhân khẩu học: Các nhà sản xuất nội dung thường muốn hiểu thông tin nhân khẩu học của khán giả của họ. Bạn có thể sử dụng Bộ nhớ dùng chung để ghi lại dữ liệu nhân khẩu học của người dùng trong ngữ cảnh mà bạn có dữ liệu đó, chẳng hạn như trang web của bên thứ nhất, đồng thời sử dụng báo cáo tổng hợp để báo cáo về dữ liệu đó trên nhiều trang web khác, chẳng hạn như nội dung được nhúng.
  • Đo lường tần suất K trở lên: Đô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 một số nội dung nhất định (thường trong ngữ cảnh 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.

Thu hút và chia sẻ ý kiến phản hồi

Đề xuất về Bộ nhớ dùng chung đang được thảo luận và có thể thay đổi trong tương lai. Nếu bạn dùng thử API này và có ý kiến phản hồi, chúng tôi rất sẵn sàng lắng nghe.