Misurazione della copertura unica

Molti produttori di contenuti e inserzionisti vogliono sapere quante persone uniche hanno visto i loro contenuti. Utilizza lo spazio di archiviazione condiviso per registrare la prima volta che un utente ha visto il tuo annuncio, il tuo video incorporato o la tua pubblicazione ed evita un conteggio duplicato dello stesso utente su siti diversi. Potrai quindi utilizzare l'API Private Aggregation per generare un report di riepilogo per la tua copertura.

L'API Shared Storage è una soluzione Proposta di sandbox per uso generico, archiviazione cross-site, che supporta molti e i possibili casi d'uso. L'API Private Aggregation è un output disponibile in Shared Storage che consente di aggregare i dati tra siti. Per ulteriori informazioni sui metodi per implementare queste misurazioni, consulta il nostro white paper sulla copertura.

Prova la misurazione della copertura unica

Per eseguire esperimenti con la misurazione della copertura unica con lo spazio di archiviazione condiviso e l'aggregazione privata, verifica di utilizzare Chrome M107 o versioni successive. Attiva tutte le API di privacy per gli annunci in chrome://settings/adPrivacy.

Puoi anche abilitare Archiviazione condivisa con il flag --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames nella riga di comando.

Sperimenta con gli esempi di codice

Potrebbe essere utile tenere traccia del numero di utenti unici che hanno visto i tuoi contenuti su diversi siti. In questo esempio, la dimensione Content ID è codificata nella chiave di aggregazione (bucket) e il conteggio viene utilizzato come valore aggregabile. Il report di riepilogo conterrà informazioni quali "Circa 391 utenti hanno visto l'ID contenuto 123".

In questo esempio: * unique-reach-measurement.js viene caricato tramite un frame e si occupa del caricamento del worklet dello spazio di archiviazione condiviso. * unique-reach-measurement-worklet.js è il worklet dello spazio di archiviazione condiviso che verifica il flag nello spazio di archiviazione condiviso e invia un report tramite l'API Private Aggregation.

reach-measurement.js

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

  // Run the reach measurement operation
  await window.sharedStorage.run('reach-measurement', { data: { contentId: '1234' } });
}

measureUniqueReach();

reach-measurement-worklet.js

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

function convertContentIdToBucket(contentId) {
  return BigInt(contentId);
}

class ReachMeasurementOperation {
  async run(data) {
    const { contentId } = data;

    // Read from Shared Storage
    const key = 'has-reported-content';
    const hasReportedContent = (await sharedStorage.get(key)) === 'true';

    // Do not report if a report has been sent already
    if (hasReportedContent) {
      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(key, true);
  }
}

// Register the operation
register('reach-measurement', ReachMeasurementOperation);

Engage and share feedback

The Shared Storage proposal is under active discussion and subject to change in the future. If you try this API and have feedback, we'd love to hear it.