Misurazione della copertura unica

Molti creator di contenuti e inserzionisti vogliono sapere quante persone uniche hanno visto i loro contenuti. Utilizza Shared Storage per registrare la prima volta in cui un utente ha visto il tuo annuncio, il video incorporato o la pubblicazione ed evitare il conteggio duplicato dello stesso utente su siti diversi. Puoi quindi utilizzare l'API Private Aggregation per generare un report di riepilogo per la tua 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.

Provare la misurazione della copertura unica

Per eseguire esperimenti sulla misurazione della copertura univoca con Shared Storage e Private Aggregation, verifica di utilizzare Chrome M107 o versioni successive. Abilita tutte le API Privacy per gli annunci in chrome://settings/adPrivacy.

Puoi anche attivare lo spazio di archiviazione condiviso con il flag --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames nella riga di comando.

Sperimenta con gli esempi di codice

Potresti voler tenere traccia del numero di utenti unici che hanno visto i tuoi contenuti su siti diversi. In questo esempio, la dimensione ID contenuto viene 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 visualizzato l'ID contenuto 123".

In questo esempio:

  • unique-reach-measurement.js viene caricato utilizzando un frame ed è responsabile del caricamento del worklet di archiviazione condiviso.
  • unique-reach-measurement-worklet.js è il worklet di archiviazione condivisa che controlla l'indicatore nello spazio di archiviazione condiviso 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);

Coinvolgere e condividere feedback

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

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

Tenersi informati

  • Mailing list: iscriviti alla nostra mailing list per ricevere gli ultimi aggiornamenti e annunci relativi all'API Shared Storage.

Hai bisogno di aiuto?