Kurzanleitung zur Implementierung von freigegebenem Speicher und privater Aggregation

In diesem Dokument finden Sie eine Kurzanleitung für die Verwendung der Shared Storage API und der Private Aggregation API. Sie müssen beide APIs kennen, da die Werte in Shared Storage gespeichert und die aggregierbaren Berichte mit Private Aggregation erstellt werden.

Zielgruppe:Anbieter von Anzeigentechnologien und Analysetools

Shared Storage API

Um websiteübergreifendes Tracking zu verhindern, haben Browser begonnen, alle Speicherarten zu partitionieren, einschließlich lokalen Speichers und Cookies. Es gibt jedoch Anwendungsfälle, in denen nicht partitionierter Speicherplatz erforderlich ist. Die Shared Storage API bietet unbegrenzten Schreibzugriff auf verschiedene Websites der obersten Ebene mit datenschutzfreundlichem Lesezugriff.

Der freigegebene Speicher ist auf den Kontextursprung (den Aufrufer von sharedStorage) beschränkt.

Der gemeinsame Speicherplatz hat eine Kapazitätsbeschränkung pro Ursprung. Jeder Eintrag ist auf eine maximale Anzahl von Zeichen beschränkt. Wenn das Limit erreicht ist, werden keine weiteren Eingaben gespeichert. Die Beschränkungen für die Datenspeicherung werden im Artikel zum freigegebenen Speicher erläutert.

Shared Storage aufrufen

Anbieter von Anzeigentechnologien können mit JavaScript oder Antwort-Headern in den freigegebenen Speicher schreiben. Das Lesen aus Shared Storage erfolgt nur in einer isolierten JavaScript-Umgebung, die als Worklet bezeichnet wird.

Mit einem Worklet können Sie bestimmte JavaScript-Funktionen ausführen und Informationen an den Anforderer zurückgeben. Innerhalb eines Worklets können Sie JavaScript ausführen, aber nicht mit der externen Seite interagieren oder kommunizieren.

Worklets werden zum Speichern und Extrahieren von Daten mit der Shared Storage API verwendet.

• Mit JavaScript können Anbieter von Anzeigentechnologien bestimmte Funktionen des gemeinsamen Speichers ausführen, z. B. Werte außerhalb eines JavaScript-Worklets festlegen, anhängen und löschen. Funktionen wie das Lesen von freigegebenen Speichern und die Durchführung einer privaten Aggregation müssen jedoch über ein JavaScript-Worklet ausgeführt werden. Methoden, die außerhalb eines JavaScript-Worklets verwendet werden können, finden Sie unter Vorgeschlagene API-Oberfläche – außerhalb des Worklets.

  Methoden, die im Worklet während eines Vorgangs verwendet werden, finden Sie unter Vorgeschlagene API-Oberfläche – Im Worklet.

• Antwortheader verwenden

  Ähnlich wie bei JavaScript können mit Antwortheadern nur bestimmte Funktionen wie das Festlegen, Anhängen und Löschen von Werten im freigegebenen Speicher ausgeführt werden. Wenn Sie mit freigegebenen Speichern in einem Antwortheader arbeiten möchten, muss Shared-Storage-Writable: ?1 im Anfrageheader enthalten sein.

  Führe je nach gewählter Methode den folgenden Code aus, um eine Anfrage vom Client zu starten:

  • fetch() verwenden

    fetch("https://a.example/path/for/updates", {sharedStorageWritable: true});
    

  • iframe- oder img-Tag verwenden

    <iframe src="https://a.example/path/for/updates" sharedstoragewritable></iframe>
    

  • IDL-Attribut mit einem iframe- oder img-Tag verwenden

    let iframe = document.getElementById("my-iframe");
    iframe.sharedStorageWritable = true;
    iframe.src = "https://a.example/path/for/updates";
    

Weitere Informationen finden Sie unter Gemeinsamer Speicher: Antwortheader.

Schreiben in Shared Storage

Wenn Sie in Shared Storage schreiben möchten, rufen Sie sharedStorage.set() innerhalb oder außerhalb eines JavaScript-Worklets auf. Wenn der Aufruf von außerhalb des Worklets erfolgt, werden die Daten an den Ursprung des Browser-Kontexts geschrieben, von dem aus der Aufruf erfolgt ist. Wenn die Funktion von innerhalb des Worklets aufgerufen wird, werden die Daten an den Ursprung des Browser-Kontexts geschrieben, in dem das Worklet geladen wurde. Die festgelegten Schlüssel laufen 30 Tage nach der letzten Aktualisierung ab.

Das Feld ignoreIfPresent ist optional. Wenn der Schlüssel vorhanden und auf true gesetzt ist, wird er nicht aktualisiert, wenn er bereits vorhanden ist. Der Ablauf des Schlüssels wird auf 30 Tage ab dem set()-Aufruf verlängert, auch wenn der Schlüssel nicht aktualisiert wird.

Wenn beim Laden derselben Seite mehrmals mit demselben Schlüssel auf den freigegebenen Speicher zugegriffen wird, wird der Wert für den Schlüssel überschrieben. Verwenden Sie sharedStorage.append(), wenn der Schlüssel den vorherigen Wert beibehalten soll.

• JavaScript verwenden

  Außerhalb des Worklets:

  window.sharedStorage.set('myKey', 'myValue1', { ignoreIfPresent: true });
  // Shared Storage: {'myKey': 'myValue1'}
  window.sharedStorage.set('myKey', 'myValue2', { ignoreIfPresent: true });
  // Shared Storage: {'myKey': 'myValue1'}
  window.sharedStorage.set('myKey', 'myValue2', { ignoreIfPresent: false });
  // Shared Storage: {'myKey': 'myValue2'}
  

  Im Worklet gilt Folgendes:

  sharedStorage.set('myKey', 'myValue1', { ignoreIfPresent: true });
  

• Antwortheader verwenden

  Sie können auch über Antwortheader in den freigegebenen Speicher schreiben. Verwenden Sie dazu Shared-Storage-Write im Antwortheader zusammen mit den folgenden Befehlen:

  Shared-Storage-Write : set;key="myKey";value="myValue";ignore_if_present
  

  Shared-Storage-Write : set;key="myKey";value="myValue";ignore_if_present=?0
  

  Mehrere Elemente können durch Kommas getrennt und set, append, delete und clear kombiniert werden.

  Shared-Storage-Write :
  set;key="hello";value="world";ignore_if_present, set;key="good";value="bye"
  

Wert anhängen

Mit der append-Methode können Sie einem vorhandenen Schlüssel einen Wert anhängen. Wenn der Schlüssel nicht vorhanden ist, wird durch Aufrufen von append() der Schlüssel erstellt und der Wert festgelegt. Dies kann mit JavaScript oder Antwortheadern erfolgen.

• JavaScript verwenden

  Wenn Sie die Werte vorhandener Schlüssel aktualisieren möchten, verwenden Sie sharedStorage.append() entweder innerhalb oder außerhalb des Worklets.

  window.sharedStorage.append('myKey', 'myValue1');
  // Shared Storage: {'myKey': 'myValue1'}
  window.sharedStorage.append('myKey', 'myValue2');
  // Shared Storage: {'myKey': 'myValue1myValue2'}
  window.sharedStorage.append('anotherKey', 'hello');
  // Shared Storage: {'myKey': 'myValue1myValue2', 'anotherKey': 'hello'}
  

  So fügen Sie Inhalte in das Worklet ein:

  sharedStorage.append('myKey', 'myValue1');
  

• Antwortheader verwenden

  Ähnlich wie beim Festlegen eines Werts im freigegebenen Speicher können Sie das Schlüssel/Wert-Paar mit Shared-Storage-Write im Antwortheader übergeben.

  Shared-Storage-Write : append;key="myKey";value="myValue2"
  

Batch-Aktualisierung von Werten

Sie können sharedStorage.batchUpdate() innerhalb oder außerhalb eines JavaScript-Worklets aufrufen und ein sortiertes Array von Methoden übergeben, in denen die ausgewählten Vorgänge angegeben sind. Jeder Methodenkonstruktor akzeptiert dieselben Parameter wie die entsprechende einzelne Methode für „set“, „append“, „delete“ und „clear“.

Sie können die Sperre mit JavaScript oder dem Antwortheader festlegen:

• JavaScript verwenden

  Zu den verfügbaren JavaScript-Methoden, die mit batchUpdate() verwendet werden können, gehören:

  • SharedStorageSetMethod(): Schreibt ein Schlüssel/Wert-Paar in den freigegebenen Speicher.
  • SharedStorageAppendMethod(): Fügen Sie einem vorhandenen Schlüssel im freigegebenen Speicher einen Wert an.
  • SharedStorageDeleteMethod(): Löscht ein Schlüssel/Wert-Paar aus dem freigegebenen Speicher.
  • SharedStorageClearMethod(): Löscht alle Schlüssel im freigegebenen Speicher.

  sharedStorage.batchUpdate([
  new SharedStorageSetMethod('keyOne', 'valueOne'),
  new SharedStorageAppendMethod('keyTwo', 'valueTwo'),
  new SharedStorageDeleteMethod('keyThree'),
  new SharedStorageClearMethod()
  ]);
  

• Antwortheader verwenden

  Shared-Storage-Write : batchUpdate;methods="set;key=keyOne;value=valueOne, append;key=keyTwo;value=valueTwo,delete;key=keyThree,clear"
  

Hinweis: Die Option withLock mit batchUpdate() gilt nur für den gesamten Batch. withLock für einzelne Methodenobjekte im Batch wird ignoriert.

Lesen aus freigegebenem Speicher

Sie können nur innerhalb eines Worklets aus Shared Storage lesen.

await sharedStorage.get('mykey');

Der Ursprung des Browser-Kontexts, aus dem das Worklet-Modul geladen wurde, bestimmt, dessen Shared Storage gelesen wird.

Aus dem freigegebenen Speicher löschen

Sie können Elemente aus dem freigegebenen Speicher mit JavaScript entweder innerhalb oder außerhalb des Worklets löschen oder Antwort-Header mit delete() verwenden. Wenn Sie alle Schlüssel gleichzeitig löschen möchten, verwenden Sie clear() in einer der beiden Ansichten.

• JavaScript verwenden

  So löschen Sie Elemente aus dem Shared Storage von außerhalb des Worklets:

  window.sharedStorage.delete('myKey');
  

  So löschen Sie Elemente aus dem Shared Storage direkt im Worklet:

  sharedStorage.delete('myKey');
  

  So löschen Sie alle Schlüssel auf einmal von außerhalb des Worklets:

  window.sharedStorage.clear();
  

  So löschen Sie alle Schlüssel gleichzeitig im Worklet:

  sharedStorage.clear();
  

• Antwortheader verwenden

  Wenn Sie Werte mit Antwortheadern löschen möchten, können Sie auch Shared-Storage-Write im Antwortheader verwenden, um den zu löschenden Schlüssel zu übergeben.

  delete;key="myKey"
  

  So löschen Sie alle Schlüssel mit Antwortheadern:

  clear;
  

Interessengruppen vom Typ „Protected Audience“ aus dem freigegebenen Speicher lesen

Sie können die Interessengruppen von Protected Audience über ein Shared Storage-Worklet lesen. Die Methode interestGroups() gibt ein Array von StorageInterestGroup-Objekten zurück, einschließlich der Attribute AuctionInterestGroup und GenerateBidInterestGroup.

Im folgenden Beispiel wird gezeigt, wie Sie die Interessengruppen des Browserkontexts lesen und welche möglichen Vorgänge auf die abgerufenen Interessengruppen angewendet werden können. Zwei mögliche Vorgänge sind die Ermittlung der Anzahl der Interessengruppen und die Ermittlung der Interessengruppe mit der höchsten Gebotsanzahl.

async function analyzeInterestGroups() {
  const interestGroups = await interestGroups();
  numIGs = interestGroups.length;
  maxBidCountIG = interestGroups.reduce((max, cur) => { return cur.bidCount > max.bidCount ? cur : max; }, interestGroups[0]);
  console.log("The IG that bid the most has name " + maxBidCountIG.name);
}

Der Ursprung des Browser-Kontexts, aus dem das Worklet-Modul geladen wurde, bestimmt den Ursprung der standardmäßig gelesenen Interessengruppen. Weitere Informationen zum Standardursprung von Worklets und dazu, wie Sie ihn ändern, finden Sie im Abschnitt „Shared Storage und Private Aggregation ausführen“ der Anleitung zur Shared Storage API.

Optionen

Alle Modifiziermethoden für freigegebenen Speicher unterstützen ein optionales Optionsobjekt als letztes Argument.

withLock

Die Option withLock ist optional. Wenn diese Option angegeben ist, wird die Methode angewiesen, vor dem Fortfahren eine Sperre für die definierte Ressource über die Web Locks API zu erwerben. Bei der Anfrage der Sperre wird ein Schlossname übergeben. Der Name steht für eine Ressource, deren Nutzung über mehrere Tabs, Worker oder Code innerhalb des Ursprungs koordiniert wird.

Die Option withLock kann mit den folgenden Modifiziermethoden für freigegebenen Speicher verwendet werden:

• set
• append
• Löschen
• löschen
• Batch-Update

Sie können die Sperre mit JavaScript oder dem Antwortheader festlegen:

• JavaScript verwenden

  sharedStorage.set('myKey', 'myValue', { withLock: 'myResource' });
  

• Antwortheader verwenden

  Shared-Storage-Write : set;key="myKey";value="myValue";with_lock="myResource"
  

Sperren für freigegebenen Speicher werden nach der Datenquelle partitioniert. Die Sperren sind unabhängig von Sperren, die mit der Methode request() von LockManager abgerufen wurden, unabhängig davon, ob sie sich in einem window- oder worker-Kontext befinden. Sie haben jedoch denselben Umfang wie Sperren, die mit request() im Kontext SharedStorageWorklet abgerufen werden.

Die request()-Methode bietet zwar verschiedene Konfigurationsoptionen, aber für Sperren, die im freigegebenen Speicher erworben werden, gelten immer die folgenden Standardeinstellungen:

• mode: "exclusive": Es können keine anderen Sperren mit demselben Namen gleichzeitig gehalten werden.
• steal: false: Vorhandene Sperren mit demselben Namen werden nicht freigegeben, um anderen Anfragen nachzukommen.
• ifAvailable: false: Die Anfragen warten unbegrenzt, bis die Sperre verfügbar ist.

Verwendung von withLock

Sperren sind nützlich in Szenarien, in denen mehrere Worklets gleichzeitig ausgeführt werden (z.B. mehrere Worklets auf einer Seite oder mehrere Worklets auf verschiedenen Tabs), die alle auf dieselben Daten zugreifen. In diesem Fall sollten Sie den entsprechenden Worklet-Code mit einem Sperrmechanismus umschließen, damit nur ein Worklet gleichzeitig Berichte verarbeitet.

Eine weitere Situation, in der Sperren nützlich sind, ist, wenn mehrere Schlüssel in einem Worklet zusammen gelesen werden müssen und ihr Status synchronisiert werden soll. In diesem Fall sollten die get-Aufrufe in einen Sperrmechanismus gewickelt werden und beim Schreiben in diese Schlüssel muss derselbe Sperrmechanismus verwendet werden.

Reihenfolge der Schlösser

Aufgrund der Natur von Websperren werden Modifiziermethoden möglicherweise nicht in der von Ihnen angegebenen Reihenfolge ausgeführt. Wenn für den ersten Vorgang eine Sperre erforderlich ist und es zu einer Verzögerung kommt, wird der zweite Vorgang möglicherweise gestartet, bevor der erste abgeschlossen ist.

Beispiel:

// This line might pause until the lock is available.
sharedStorage.set('keyOne', 'valueOne', { withLock: 'resource-lock' });

// This line will run right away, even if the first one is still waiting.
sharedStorage.set('keyOne', 'valueTwo');

Beispiel für die Änderung mehrerer Schlüssel

In diesem Beispiel wird eine Sperre verwendet, damit die Lese- und Löschvorgänge innerhalb des Worklets gleichzeitig ausgeführt werden. So werden Störungen von außerhalb des Worklets verhindert.

Im folgenden modify-multiple-keys.js-Beispiel werden mit modify-lock neue Werte für keyOne und keyTwo festgelegt und dann wird der Vorgang modify-multiple-keys aus dem Worklet ausgeführt:

// modify-multiple-keys.js
sharedStorage.batchUpdate([
    new SharedStorageSetMethod('keyOne', calculateValueFor('keyOne')),
    new SharedStorageSetMethod('keyTwo', calculateValueFor('keyTwo'))
], { withLock: 'modify-lock' });

const modifyWorklet = await sharedStorage.createWorklet('modify-multiple-keys-worklet.js');
await modifyWorklet.run('modify-multiple-keys');

Anschließend können Sie innerhalb des modify-multiple-keys-worklet.js das Schloss mit navigator.locks.request() anfordern, um die Schlüssel nach Bedarf zu lesen und zu ändern.

// modify-multiple-keys-worklet.js
class ModifyMultipleKeysOperation {
  async run(data) {
    await navigator.locks.request('modify-lock', async (lock) => {
      const value1 = await sharedStorage.get('keyOne');
      const value2 = await sharedStorage.get('keyTwo');

      // Do something with `value1` and `value2` here.

      await sharedStorage.delete('keyOne');
      await sharedStorage.delete('keyTwo');
    });
  }
}
register('modify-multiple-keys', ModifyMultipleKeysOperation);

Kontextwechsel

Daten aus dem freigegebenen Speicher werden an den Ursprung (z. B. https://beispiel.adtech.com) des Browser-Kontexts geschrieben, von dem aus der Aufruf stammt.

Wenn du den Code des Drittanbieters über ein <script>-Tag lädst, wird er im Browserkontext des Einbettungspartners ausgeführt. Wenn der Drittanbietercode also sharedStorage.set() aufruft, werden die Daten in den freigegebenen Speicher des Embedders geschrieben. Wenn Sie den Code des Drittanbieters in einem iFrame laden, erhält der Code einen neuen Browserkontext und sein Ursprung ist der Ursprung des iFrames. Daher werden die Daten durch den sharedStorage.set()-Aufruf aus dem Iframe im Shared Storage des Iframe-Ursprungs gespeichert.

Kontext mit selbst erhobenen Daten

Wenn auf einer selbst gehosteten Seite eingebetteter JavaScript-Code von Drittanbietern vorhanden ist, der sharedStorage.set() oder sharedStorage.delete() aufruft, wird das Schlüssel/Wert-Paar im selbst gehosteten Kontext gespeichert.

Drittanbieterkontext

Das Schlüssel/Wert-Paar kann im Kontext der Anzeigentechnologie oder des Drittanbieters gespeichert werden. Dazu müssen Sie einen iFrame erstellen und set() oder delete() im JavaScript-Code innerhalb des iFrames aufrufen.

Private Aggregation API

Wenn Sie aggregierbare Daten messen möchten, die in Shared Storage gespeichert sind, können Sie die Private Aggregation API verwenden.

Wenn Sie einen Bericht erstellen möchten, rufen Sie contributeToHistogram() in einem Worklet mit einem Bucket und einem Wert auf. Der Bucket wird durch eine vorzeichenlose 128‑Bit-Ganzzahl dargestellt, die als BigInt an die Funktion übergeben werden muss. Der Wert ist eine positive Ganzzahl.

Aus Datenschutzgründen wird die Nutzlast des Berichts, die den Bucket und den Wert enthält, während der Übertragung verschlüsselt. Sie kann nur mit dem Aggregationsdienst entschlüsselt und aggregiert werden.

Außerdem wird der Browser die Beiträge einer Website zu einer Ausgabeabfrage einschränken. Das Beitragsbudget begrenzt die Gesamtzahl aller Berichte von einer einzelnen Website für einen bestimmten Browser in einem bestimmten Zeitraum über alle Buckets hinweg. Wenn das aktuelle Budget überschritten wird, wird kein Bericht erstellt.

privateAggregation.contributeToHistogram({
  bucket: BigInt(myBucket),
  value: parseInt(myBucketValue)
});

Shared Storage und Private Aggregation ausführen

Sie müssen ein Worklet erstellen, um auf Daten aus freigegebenem Speicher zuzugreifen. Rufen Sie dazu createWorklet() mit der URL des Worklets auf. Wenn Sie freigegebenen Speicher mit createWorklet() verwenden, ist standardmäßig der Ursprung der Datenpartition der Ursprung des aufrufenden Browser-Kontexts, nicht der Ursprung des Worklet-Scripts selbst.

Wenn Sie das Standardverhalten ändern möchten, legen Sie die Eigenschaft dataOrigin fest, wenn Sie createWorklet aufrufen.

• dataOrigin: "context-origin": (Standard) Die Daten werden im freigegebenen Speicher des Ursprungs des aufgerufenen Browser-Kontexts gespeichert.
• dataOrigin: "script-origin": Die Daten werden im freigegebenen Speicher des Ursprungs des Worklet-Scripts gespeichert. Hinweis: Sie müssen diesen Modus aktivieren.

sharedStorage.createWorklet(scriptUrl, {dataOrigin: "script-origin"});

Wenn du "script-origin" verwenden möchtest, muss der Script-Endpunkt mit dem Header Shared-Storage-Cross-Origin-Worklet-Allowed antworten. Für ursprungsübergreifende Anfragen muss CORS aktiviert sein.

Shared-Storage-Cross-Origin-Worklet-Allowed : ?1

Die Einstellung von „dataOrigin“ für „createWorklet()“ und das Erstellen plattformübergreifender Worklets mit „addModule()“ wurden in M130 eingeführt.

Cross-Origin-iFrame verwenden

Für die Aufrufung des Shared Storage-Worklets ist ein Iframe erforderlich.

Laden Sie im IFrame der Anzeige das Worklet-Modul durch Aufrufen von addModule(). Wenn Sie die in der Worklet-Datei sharedStorageWorklet.js registrierte Methode ausführen möchten, rufen Sie im selben JavaScript-Code des Anzeigen-iFrames sharedStorage.run() auf.

const sharedStorageWorklet = await window.sharedStorage.createWorklet(
  'https://any-origin.example/modules/sharedStorageWorklet.js'
);
await sharedStorageWorklet.run('shared-storage-report', {
  data: { campaignId: '1234' },
});

Im Worklet-Script müssen Sie eine Klasse mit einer asynchronen run-Methode erstellen und register sie so konfigurieren, dass sie im IFrame der Anzeige ausgeführt wird. Im Inneren vonsharedStorageWorklet.js:

class SharedStorageReportOperation {
  async run(data) {
    // Other code goes here.
    bucket = getBucket(...);
    value = getValue(...);
    privateAggregation.contributeToHistogram({
      bucket,
      value
    });
  }
}
register('shared-storage-report', SharedStorageReportOperation);

Ursprungsübergreifende Anfrage verwenden

Mit der Shared Storage API und der Private Aggregation API können ursprungsübergreifende Worklets erstellt werden, ohne dass ursprungsübergreifende iFrames erforderlich sind.

Die Seite mit selbst erhobenen Daten kann auch einen createWorklet()-Aufruf an den plattformübergreifenden JavaScript-Endpunkt auslösen. Sie müssen beim Erstellen des Worklets den Ursprung der Datenpartition des Worklets auf den Ursprung des Scripts festlegen.

async function crossOriginCall() {
  const privateAggregationWorklet = await sharedStorage.createWorklet(
    'https://cross-origin.example/js/worklet.js',
    { dataOrigin: 'script-origin' }
  );
  await privateAggregationWorklet.run('pa-worklet');
}
crossOriginCall();

Der Cross-Origin-JavaScript-Endpunkt muss mit den Headern Shared-Storage-Cross-Origin-Worklet-Allowed antworten und angeben, dass CORS für die Anfrage aktiviert ist.

Shared-Storage-Cross-Origin-Worklet-Allowed : ?1

Mit der createWorklet() erstellte Worklets haben selectURL und run(). addModule() ist dafür nicht verfügbar.

Hinweis :Mit addModule() können Sie plattformübergreifende Worklets erstellen. Die Verwendung von createWorklet() ist jedoch vorzuziehen, da damit eine datenpartition zwischen verschiedenen Ursprüngen erstellt werden kann und im Gegensatz zu addModule() mehrere Worklets erstellt werden können.

class CrossOriginWorklet {
  async run(data){
    // Other code goes here.
    bucket = getBucket(...);
    value = getValue(...);
    privateAggregation.contributeToHistogram({
      bucket,
      value
    });
  }
}

Nächste Schritte

Auf den folgenden Seiten werden wichtige Aspekte der Shared Storage API und der Private Aggregation API erläutert.

• Einführung in den freigegebenen Speicher (Chrome für Entwickler)
• Anwendungsfälle für freigegebenen Speicher (Chrome für Entwickler)
• Einführung in die private Aggregation (Chrome für Entwickler)
• Erläuterung zu freigegebenen Speichern (GitHub)
• Erläuterung zur privaten Aggregation (GitHub)
• Demo für Shared Storage und Private Aggregation

Sobald Sie mit den APIs vertraut sind, können Sie mit dem Erfassen der Berichte beginnen. Diese werden als POST-Anfrage an die folgenden Endpunkte als JSON im Anfragetext gesendet.

• Debug-Berichte – context-origin/.well-known/private-aggregation/debug/report-shared-storage
• Berichte – context-origin/.well-known/private-aggregation/report-shared-storage

Sobald Berichte erfasst wurden, können Sie sie mit dem Tool für lokale Tests testen oder die Trusted Execution Environment for Aggregation Service einrichten, um die zusammengefassten Berichte abzurufen.

Feedback geben

Sie können Ihr Feedback zu den APIs und zur Dokumentation auf GitHub teilen.

• Shared Storage
• Private Aggregation