Rotasi materi iklan

Menggunakan Penyimpanan Bersama untuk menentukan materi iklan yang dilihat pengguna di seluruh situs.

Shared Storage API adalah proposal Privacy Sandbox untuk penyimpanan lintas situs tujuan umum, yang mendukung banyak kemungkinan kasus penggunaan. Salah satu contohnya adalah rotasi materi iklan, yang tersedia untuk diuji di Chrome 104.0.5086.0 dan yang lebih baru.

Dengan rotasi materi iklan, Anda dapat menyimpan data, seperti ID materi iklan, jumlah tampilan, dan interaksi pengguna, untuk menentukan materi iklan mana yang dilihat pengguna di berbagai situs.

Jalankan worklet Penyimpanan Bersama untuk memilih URL dari daftar yang disediakan, berdasarkan data tersimpan, lalu merender materi iklan tersebut dalam frame dengan fence. Ini dapat digunakan untuk memilih iklan baru atau konten lainnya.

Coba rotasi materi iklan

Untuk bereksperimen dengan rotasi materi iklan dengan Penyimpanan Bersama, pastikan Anda menggunakan Chrome 104.0.5086.0 atau yang lebih baru. Aktifkan semua API privasi iklan di chrome://settings/adPrivacy.

Anda juga dapat mengaktifkan Shared Storage dengan tanda --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames di command line.

Bereksperimen dengan contoh kode

Pengiklan atau produsen konten mungkin ingin menerapkan strategi yang berbeda untuk kampanye, dan merotasi konten atau materi iklan untuk meningkatkan efektivitas. Penyimpanan bersama dapat digunakan untuk menjalankan strategi rotasi berbeda, seperti rotasi berurutan dan rotasi yang terdistribusi secara merata di berbagai situs.

Dalam contoh ini:

  • creative-rotation.js disematkan dalam frame. Skrip ini menetapkan iklan yang paling penting ( bobot), dan panggilan ke worklet untuk menentukan konten yang harus ditampilkan.
  • creative-rotation-worklet.js adalah worklet penyimpanan bersama yang menentukan distribusi berbobot untuk konten dan pengembalian yang harus ditampilkan.

creative-rotation.js

// Ad config with the URL of the content, a probability weight for rotation, and the clickthrough rate.
const DEMO_CONTENT_CONFIG = [
  {
    url: 'https://your-server.example/contents/content-1.html',
    weight: 0.7,
  },
  {
    url: 'https://your-server.example/contents/content-2.html',
    weight: 0.2,
  },
  {
    url: 'https://your-server.example/contents/content-3.html',
    weight: 0.1,
  },
];

// Set the mode to sequential and set the starting index to 0.
async function seedStorage() {
  await window.sharedStorage.set('content-rotation-mode', 'sequential', {
    ignoreIfPresent: true,
  });

  await window.sharedStorage.set('content-rotation-index', 0, {
    ignoreIfPresent: true,
  });
}

async function injectAd() {
  // Load the worklet module
  await window.sharedStorage.worklet.addModule('content-rotation-worklet.js');

  // Initially set the storage to sequential mode for the demo
  seedStorage();

  // Run the URL selection operation to determine the next content rendered.
  const urls = DEMO_CONTENT_CONFIG.map(({ url }) => ({ url }));
  const fencedFrameConfig = await window.sharedStorage.selectURL('content-rotation', urls, { 
    data: DEMO_CONTENT_CONFIG,
    resolveToConfig: true
  });

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

injectAd();

creative-rotation-worklet.js

class SelectURLOperation {
  async run(urls, data) {
    // Read the rotation mode from Shared Storage
    const rotationMode = await this.sharedStorage.get('content-rotation-mode');

    // Generate a random number to be used for rotation
    const randomNumber = Math.random();

    let index;

    switch (rotationMode) {
      /**
       * Sequential rotation
       * - Rotates the contents in order
       * - Example: A -> B -> C -> A ...
       */
      case 'sequential':
        const currentIndex = await this.sharedStorage.get('creative-rotation-index');
        index = parseInt(currentIndex, 10);
        const nextIndex = (index + 1) % urls.length;

        await this.sharedStorage.set('content-rotation-index', nextIndex);
        break;

      /**
       * Weighted rotation
       * - Rotates the contentswith weighted probability
       * - Example: A=70% / B=20% / C=10%
       */
      case 'weighted-distribution':
        
        // Sum the weights cumulatively, and find the first URL where the
        // sum exceeds the random number. The array is sorted in
        // descending order first.
        let weightSum = 0;
        const { url } = data
          .sort((a, b) => b.weight - a.weight)
          .find(({ weight }) => {
            weightSum += weight;
            return weightSum > randomNumber;
          });

        index = urls.indexOf(url);
        break;

      default:
        index = 0;
    }
    return index;
  }
}

register('content-rotation', SelectURLOperation);

Kasus penggunaan

Ini hanyalah beberapa kemungkinan kasus penggunaan untuk Penyimpanan Bersama. Kami akan terus menambahkan contoh saat menerima masukan dan menemukan kasus penggunaan baru.

Pemilihan konten

Pilih dan tampilkan konten yang berbeda di berbagai situs dalam frame dengan fence berdasarkan informasi yang dikumpulkan di Penyimpanan Bersama. Gate output untuk kasus penggunaan ini adalah pemilihan URL.

  • Rotasi materi iklan: Simpan data, seperti ID materi iklan, jumlah penayangan, dan interaksi pengguna, untuk menentukan materi iklan mana yang dilihat pengguna di berbagai situs.
  • Pengujian A/B: Anda dapat menetapkan pengguna ke grup eksperimen, lalu menyimpan grup tersebut di Penyimpanan Bersama untuk diakses lintas situs.
  • Pengalaman pengguna kustom: Bagikan konten kustom dan pesan ajakan (CTA) berdasarkan status pendaftaran pengguna atau status pengguna lainnya

Membuat laporan ringkasan

Kumpulkan informasi dengan Penyimpanan Bersama dan buat laporan ringkasan gabungan yang berisi banyak hal. Gate output untuk kasus penggunaan ini adalah Private Aggregation API.

  • Pengukuran jangkauan unik: Banyak produser konten dan pengiklan ingin mengetahui jumlah orang unik yang melihat konten mereka. Gunakan Penyimpanan Bersama untuk mencatat saat pertama kali pengguna melihat iklan, video tersemat, atau publikasi Anda, dan mencegah penghitungan duplikat pengguna yang sama tersebut di situs yang berbeda. Anda kemudian dapat menggunakan Private Aggregation API untuk menghasilkan laporan ringkasan jangkauan.
  • Pengukuran demografi: Produser konten sering kali ingin memahami demografi audiens mereka. Anda dapat menggunakan Penyimpanan Bersama untuk mencatat data demografis pengguna dalam konteks tempat Anda memilikinya, seperti situs pihak pertama, dan menggunakan pelaporan gabungan untuk melaporkannya di banyak situs lain, seperti konten yang disematkan.
  • Pengukuran frekuensi K+: Terkadang dijelaskan sebagai "frekuensi efektif", sering kali ada jumlah penayangan minimum sebelum pengguna mengenali atau mengingat konten tertentu (sering kali dalam konteks tampilan iklan). Anda dapat menggunakan Penyimpanan Bersama untuk membuat laporan tentang pengguna unik yang telah melihat konten setidaknya K beberapa kali.

Berinteraksi dan berbagi masukan

Proposal Penyimpanan Bersama sedang dalam diskusi aktif dan dapat berubah pada masa mendatang. Jika Anda mencoba API ini dan memiliki masukan, sampaikanlah kepada kami.