Misurazione della copertura unica

Molti autori di contenuti e inserzionisti vogliono sapere quante persone uniche hanno visto i loro contenuti. Utilizza Shared Storage per registrare la prima volta che un utente ha visto il tuo annuncio, video incorporato o pubblicazione e impedire il conteggio duplicato dello stesso utente su siti diversi. Puoi quindi utilizzare l'API Private Aggregation per generare un report di riepilogo della copertura.

L'API Shared Storage è una proposta di Privacy Sandbox per l'archiviazione cross-site per uso generico, che supporta molti possibili casi d'uso. L'API Private Aggregation è un output disponibile in Shared Storage che consente di aggregare i dati tra siti. Per scoprire di più sui metodi per implementare queste misurazioni, consulta il nostro white paper sulla copertura.

Prova la misurazione della unique reach

Per sperimentare la misurazione della copertura unica con Shared Storage e Private Aggregation, verifica di utilizzare Chrome M107 o versioni successive. Abilita tutte le API per la privacy degli annunci in chrome://settings/adPrivacy.

Puoi anche attivare Shared Storage con il flag --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames nella riga di comando.

Sperimenta con esempi di codice

Potresti voler monitorare il numero di utenti unici che hanno visualizzato i tuoi contenuti su diversi siti. In questo esempio, la dimensione ID contenuto è codificata nella chiave di aggregazione (bucket) e il conteggio viene utilizzato come valore aggregabile. Il report riepilogativo conterrà informazioni come "Circa 391 utenti hanno visualizzato l'ID contenuto 123".

In questo esempio:

  • unique-reach-measurement.js viene caricato utilizzando un frame ed è responsabile del caricamento del worklet di Shared Storage.
  • unique-reach-measurement-worklet.js è il worklet di Shared Storage che controlla il flag in Shared Storage e invia un report utilizzando 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';

    // Don't 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 using 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);

Partecipare e condividere feedback

Tieni presente che la proposta dell'API Shared Storage è in fase di discussione e sviluppo, pertanto è soggetta a modifiche.

Non vediamo l'ora di conoscere la tua opinione sull'API Shared Storage.