Protected Audience API-Auktionsberichte

Protected Audience API-Auktionsdaten und ‑ergebnisse analysieren

In diesem Artikel finden Sie einen allgemeinen Überblick über die verschiedenen Mechanismen, mit denen Sie Protected Audience API-Auktionsdaten an Ihren Server senden können. Außerdem werden die Übergangsmechanismen beschrieben, die Sie während der Migration verwenden können, bis alternative Lösungen verfügbar sind.

Die Protected Audience API kann mit folgenden Tools verwendet werden, um Berichte zu wichtigen Messwerten zu erstellen, die Sie aus einer Anzeigenauktion erfassen:

• Private Aggregation, mit der Auktionssignale und ‑ergebnisse erfasst werden, um Zusammenfassungsberichte zu erstellen.
• Ads Reporting API für Fenced Frames und Iframes, ein Kanal innerhalb der Frames, um mit Protected Audience API-Worklets zu kommunizieren. Mit der API können Daten auf Ereignisebene mit Auktionssignalen verknüpft werden. Die Berichte auf Ereignisebene der Ads Reporting API sind ein Übergangsmechanismus, bis ein datenschutzfreundlicherer Berichtsmechanismus entwickelt wird.
• Attributionsberichte, mit denen Sie Conversion-Daten mit Auktionssignalen verknüpfen können.
• Shared Storage: Mit dieser Funktion können Sie Auktionssignale in einen speicherübergreifenden Speicher schreiben und diese Daten dann später mit Private Aggregation erfassen.

Protected Audience API-Berichte – Übersicht

Es gibt drei Hauptzeiträume, in denen Daten aus dem Auktionsablauf der Protected Audience API an Ihren Server gesendet werden können: Auktionszeit, wenn die Auktion von der Publisher-Website ausgeführt wird, Renderingszeit, wenn die Anzeige in einen eingegrenzten Frame oder einen Iframe auf der Publisher-Website gerendert wird, und Conversion-Zeit, wenn der Nutzer eine Aktion auf einer anderen Website ausführt, die der Auktion zugeordnet werden kann.

Während der Auktion können Sie die Auktionsdaten mithilfe von Berichts-Worklets erfassen. Während des Renderings können Sie Interaktionsdaten aus einem IFrame oder einem eingegrenzten Frame erfassen. Während des Conversion-Zeitraums können Sie mit der Attribution Reporting API Attributionsdaten von der Zielseite erfassen.

Standorte melden

Käufer können in einer Auktion Signale in generateBid()- und reportWin()-Worklets erfassen. Verkäufer können Signale in scoreAd()- und reportResult()-Worklets erfassen. Außerhalb einer Auktion können Käufer und Verkäufer Daten aus einem Frame erfassen, in dem die Anzeige gerendert wurde, und von der Website, auf der die Conversion erzielt wurde.

In jedem der aufgeführten Zeiträume haben Käufer und Verkäufer Zugriff auf verschiedene Berichts-APIs, mit denen sie Daten wie Auktionssignale, Daten auf Ereignisebene und Conversion-Daten erfassen können.

In einer Protected Audience API-Auktion verfügbare Daten

Die folgenden Daten können während der Auktion über ein Protected Audience API-Worklet erfasst werden.

Signale

Signale sind die Auktionskontextdaten, Nutzerdaten, Echtzeitdaten und Browserdaten, die den Käufern und Verkäufern in einem Worklet zur Verfügung stehen, um ein Gebot abzugeben, eine Anzeige zu bewerten und die Ergebnisse einer Auktion zu erfassen.

Das Objekt auction config ist die Hauptdatenquelle, die als Signale in Worklets verfügbar gemacht wird. Der Publisher und der Verkäufer können in der Auktionskonfiguration Kontextdaten und selbst erhobene Daten angeben. Diese Signale können mit den Daten der Interessengruppe des Käufers, den Daten auf Ereignisebene aus dem Anzeigen-Rendering-Frame und den Attributionsdaten der Klick-Weiterleitungsseite angereichert werden. Die gemeldeten Daten können unter anderem für Käufer-/Verkäuferberichte, Abrechnung, Budgetierung und ML-Modelltraining verwendet werden.

Andere verfügbare Daten

• Ergebnisdaten zu Auktionsgewinnen und ‑verlusten, z. B. Preis des erfolgreichen Gebots und Grund für die Ablehnung eines Gebots.
• Leistungsdaten mit Informationen zur Latenz, z. B. wie lange das Abrufen und Ausführen des Gebots-Worklets gedauert hat.

Daten, die außerhalb einer Protected Audience API-Auktion verfügbar sind

Außerhalb einer Protected Audience API-Auktion gibt es zwei Zeiträume, in denen Daten für Berichte verfügbar sind.

Während der Anzeigenauslieferung auf der Publisher-Website können die Daten auf Ereignisebene aus dem IFrame oder eingezäunten Frame mit Auktionsdaten der Protected Audience API verknüpft und an Ihren Server gesendet werden. Beispiele für Daten auf Ereignisebene sind Anzeigenimpressionen, Klicks, Mausbewegungen und alle anderen Ereignisse, die im Frame auftreten.

Wenn ein Nutzer während des Conversion-Zeitraums eine Aktion auf der Klick-through-Seite ausführt, die der Auktion zugeordnet wird, können die Daten auf Ereignisebene von der Conversion-Seite mit Auktionsdaten der Protected Audience API verknüpft und an Ihren Server gesendet werden.

Berichte auf Ereignisebene

In Berichten auf Ereignisebene finden Sie detaillierte Informationen zu einem oder mehreren Ereignissen. Ein Ereignis kann ein gewonnener Auktionsauftrag, eine Anzeigenimpression oder eine Conversion sein. Bis mindestens 2026 sind Berichte zu Geboten auf Ereignisebene weiterhin verfügbar. Für das Rendern einer Protected Audience-Anzeige sind keine eingezäunten Frames mehr erforderlich und für Berichte auf Ereignisebene kann ein Iframe mit uneingeschränktem Netzwerkzugriff verwendet werden. Außerdem ist die Ads Reporting API in abgegrenzten Frames und Iframes verfügbar, damit Sie Auktions- und Conversion-Daten mit Daten auf Ereignisebene aus dem Frame verknüpfen können. So soll die Migration für das gesamte System einfacher werden, da Sie Ihre vorhandene Berichtsinfrastruktur bis mindestens 2026 weiter verwenden können, während Sie Ihr System zu Protected Audience migrieren.

Berichte zu Geboten auf Ereignisebene mit sendReportTo()

Ein Mechanismus zum Erfassen von Daten auf Ereignisebene in einer Protected Audience-Auktion ist das sendReportTo() function bei einem Auktionsgewinn. Die Funktion ist in den Worklets für Käufer- und Verkäuferberichte verfügbar. Der Browser sendet eine GET-Anfrage an den angegebenen URL-String, wenn das Anzeigen-Rendering beginnt. Sie können alle in Ihren Worklets verfügbaren Signale als Abfrageparameter der URL codieren.

Ein Käufer kann beispielsweise den Betrag des Gewinnergebots aus dem reportWin()-Worklet zu Abrechnungszwecken melden:

// Buyer reporting worklet
function reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals, directFromSellerSignals) {
  sendReportTo(`https://buyer-reporting-server.example/reporting?bid=${browserSignals.bid}`);
}

Mit der Funktion sendReportTo() können Sie einen Bericht zu Geboten für den Verkäufer generieren, wenn sie von reportResult() aufgerufen wird, und einen Bericht zu Geboten für den Käufer, wenn sie von reportWin() aufgerufen wird. Die Funktion sendReportTo() ist mindestens bis 2026 verfügbar.

Bericht zu Interaktionen

Ein Bericht zu Interaktionen enthält Daten auf Ereignisebene von einem Creative, z. B. Impressions- oder Klickdaten, die mit den Signalen der Protected Audience API-Auktion verknüpft sind, in der die Anzeige gerendert wurde. Da die Anzeige nach Abschluss der Auktion gerendert wird, sind die Auktionssignale nicht im Frame verfügbar, in dem die Anzeige gerendert wird. Um diese Daten aus verschiedenen Zeiträumen zu verknüpfen, stehen Ihnen zwei Umstellungsmechanismen zum Erstellen von Berichten zu Interaktionen zur Verfügung.

Mit der oben beschriebenen Funktion sendReportTo() können Auktionsdaten mit Daten auf Ereignisebene aus einem Iframe verknüpft werden. Sie funktioniert jedoch nicht für einen eingegrenzten Frame, da keine eindeutige ID vom Embedder übergeben werden kann, da die Kommunikation zwischen dem Embedder und dem eingegrenzten Frame eingeschränkt ist. Mit der Google Ads Reporting API können Auktionsdaten mit Daten auf Ereignisebene aus einer Anzeige mit eingeblendetem Frame verknüpft werden.

Ads Reporting API für abgegrenzte Frames und iFrames

Die Ads Reporting API für eingeblendete Frames und Iframes bietet einen Mechanismus, mit dem Sie Daten auf Nutzerereignisebene aus einem Anzeigenframe mit Signalen in einer Protected Audience-Auktion verknüpfen können.

In einem Protected Audience API-Berichts-Worklet können Sie mit der Funktion registerAdBeacon() ein Anzeigen-Beacon registrieren und Ihre Berichts-URL mit den Signalen als Abfrageparameter übergeben. Sie geben auch das benutzerdefinierte Ereignis an, das Sie der Berichts-URL zuordnen möchten. Wenn die Anzeige später in einem eingegrenzten Frame gerendert wird, können Sie das benutzerdefinierte Ereignis durch Aufrufen der Funktion window.fence.reportEvent() auslösen. Daten, die sich im eingezäunten Frame befinden, können als Nutzlast hinzugefügt werden.

Die Funktion registerAdBeacon() ist nur in den Berichtsfunktionen verfügbar und nicht in der Gebotslogik des Käufers und der Bewertungslogik des Verkäufers.

Im folgenden Beispiel ist einer Nutzlast auf Ereignisebene eine Kampagnen-ID mit den Klickkoordinaten zugeordnet:

// Protected Audience API buyer win reporting worklet
function reportWin(auctionSignals) {
  const { campaignId } = auctionSignals

  registerAdBeacon({
    click: `https://buyer-server.example/report/click?campaignId=${campaignId}`
  })
}

// Protected Audience API seller reporting worklet
function reportResult(auctionConfig) {
  const { campaignId } = auctionConfig.auctionSignals;

  registerAdBeacon({
    click: `https://seller-server.example/report/click?campaignId=${campaignId}`
  })
}

// Ad frame
window.fence.reportEvent({
  eventType: 'click',
  eventData: JSON.stringify({'clickX': '123', 'clickY': '456'}),
  destination:['buyer', 'seller']
});

Die Fenced Frames Ads Reporting API ist aus denselben Gründen wie die Berichte zu Anzeigenaufrufen ebenfalls bis mindestens 2026 verfügbar.

Weitere Informationen finden Sie in der Erläuterung.

Uneingeschränkter Netzwerkzugriff

Mit abgegrenzten Frames können Netzwerkressourcen auf die gleiche Weise wie bei einem Iframe geladen werden. Außerdem können Sie Daten auf Ereignisebene innerhalb abgegrenzter Frames an Ihren Server senden. Sie können Berichte auf Ereignisebene später auf der Serverseite generieren, indem Sie die Daten auf Ereignisebene aus einem eingezäunten Frame mit den Auktionsdaten verknüpfen, die mit sendReportTo() gesendet wurden. Weitere Informationen finden Sie oben im Abschnitt Berichtsmechanismus auf Ereignisebene für Auktionen.

Der Netzwerkzugriff wird in Zukunft eingeschränkt.

Attributionsbericht

In einem Attributionsbericht können Sie eine Conversion auf einer Website einer Anzeige zuordnen, die in einer Protected Audience API-Auktion ausgewählt wurde. Ein Nutzer klickt beispielsweise auf eine von Ihnen ausgelieferte Produktanzeige, wird zur Website des Werbetreibenden weitergeleitet und tätigt dort einen Kauf. Sie möchten den Kauf der ausgelieferten Anzeige zuordnen. Die Attribution Reporting API wird in die Protected Audience API eingebunden, um die Auktionsdaten von der Publisher-Website und die Conversion-Daten von der Werbetreibenden-Website zu kombinieren.

Bis wir eine dauerhafte Lösung entwickeln, können Sie die Ads Reporting API für abgegrenzte Frames als Übergangsmechanismus verwenden, um einen Bericht auf Ereignisebene mit Attribution Reporting zu erstellen. Diese Berichte dienen der Conversion-Analyse und sind unabhängig von den Berichten zur Interaktion auf Ereignisebene und den aggregierten Berichten zur Interaktion, die aus der Auktion und dem Anzeigen-Frame generiert werden. Sobald eine dauerhaftere Lösung verfügbar ist, veröffentlichen wir eine entsprechende Erläuterung.

Übergangsmechanismus

Wenn Sie ein Anzeigen-Beacon registrieren, können Sie das Keyword reserved.top_navigation verwenden. Dadurch wird automatisch die Attribution-Reporting-Eligible-Überschrift hinzugefügt, damit das Beacon als Attributionsquelle registriert werden kann.

registerAdBeacon({
 'reserved.top_navigation': 'https://adtech.example/click?buyer_event_id=123',
});

Wenn Sie dem von Ihnen registrierten Beacon Daten auf Ereignisebene hinzufügen möchten, können Sie setReportEventDataForAutomaticBeacons() aus dem eingezäunten Frame mit der Ereignisnutzlast aufrufen.

window.fence.setReportEventDataForAutomaticBeacons({
  eventType: 'reserved.top_navigation',
  eventData: 'data from the frame',
  destination:['seller', 'buyer']
})

Weitere Informationen finden Sie im Abschnitt zu Attributionsberichten in der Erläuterung zur Ads Reporting API.

Beispiel für Berichte zu Interaktionen und Conversions

In diesem Beispiel betrachten wir die Situation aus der Perspektive eines Käufers, der die Daten aus der Auktion, dem Anzeigen-Frame und der Conversion-Website verknüpfen möchte.

Bei diesem Workflow koordiniert der Käufer mit dem Verkäufer, dass eine eindeutige ID in die Auktion gesendet wird. Während der Auktion sendet der Käufer diese eindeutige ID mit den Auktionsdaten. Während des Renderings und der Conversion werden die Daten aus dem eingegrenzten Frame oder Iframe ebenfalls mit derselben eindeutigen ID gesendet. Später können Sie diese Berichte anhand der eindeutigen ID verknüpfen.

Workflow:

1. Vor Beginn der Auktion sendet der Käufer im Rahmen seiner programmatischen Gebotsantwort für Echtzeitgebote („RTB“) eine eindeutige ID an den Verkäufer. Die ID kann als Variable wie auctionId festgelegt werden. Die ID wird im auctionConfig als perBuyerSignals übergeben und ist in den Worklets des Käufers verfügbar.
2. Während der Auktion kann der Käufer ein Anzeigen-Beacon registrieren, das während der Anzeigendarstellung und der Conversion-Zeit (registerAdBeacon()) ausgelöst wird.
   1. Wenn Sie Auktionssignale für ein Anzeigen-Frame-Ereignis verknüpfen möchten, legen Sie die auctionId als Abfrageparameter der Beacon-URL fest.
   2. Wenn Sie Auktionssignale für ein Conversion-Ereignis verknüpfen möchten, setzen Sie das auctionId in der Beacon-URL.
3. Beim Rendern der Anzeige können die während der Auktion registrierten Beacons ausgelöst oder mit Daten auf Ereignisebene erweitert werden.
   1. Lösen Sie das Frame-Ereignis mit reportEvent() aus und übergeben Sie die Daten auf Ereignisebene.
   2. Dem Attributions-Beacon mit setReportEventDataForAutomaticBeacons() eine Nutzlast auf Ereignisebene hinzufügen
   3. Registrieren Sie die Anzeige bei der Attribution Reporting API, indem Sie auf die Anzeigen-Beacon-Anfragen mit dem Attribution-Reporting-Register-Source-Header antworten.
4. Während des Conversion-Zeitraums können Sie die Quelle auslösen, die Sie während der Auktion registriert haben.

Nach dem oben beschriebenen Vorgang hat der Käufer einen Auktionsbericht, einen Bericht zu Interaktionen und einen Conversion-Bericht, die alle über einen eindeutigen Schlüssel verknüpft sind, mit dem sie miteinander verknüpft werden können.

Ein ähnlicher Workflow gilt für einen Verkäufer, wenn er Zugriff auf Attributionsdaten benötigt. Der Verkäufer kann auch eine eindeutige ID verwenden, die mit registerAdBeacon() gesendet wird. Im Frame enthält der reportEvent()-Aufruf eine Ziel-Property, mit der der Bericht sowohl an den Käufer als auch an den Verkäufer gesendet werden kann. Die SSP muss auch auf der Landingpage vorhanden sein, damit der Trigger der Quelle zugeordnet werden kann.

Protected Audience-Daten aggregieren

Die Private Aggregation API ist der Mechanismus, mit dem Protected Audience-Daten erfasst werden, um einen Zusammenfassungsbericht zu erstellen. Dabei handelt es sich um einen Bericht mit vielen Daten, der aus in Buckets erfassten Daten aggregiert wird. Ein Bucket wird durch einen Aggregationsschlüssel dargestellt. Einige Informationen können in den Schlüssel codiert werden.

Ein Ereignis vom Typ „Anzeigenimpression“ kann beispielsweise in verschiedene Bereiche eingeteilt werden, wobei jeder Bereich eine andere Werbekampagne darstellt. Ein Zusammenfassungsbericht unterscheidet sich von einem Bericht auf Ereignisebene dadurch, dass er keine Informationen zu einzelnen Ereignissen enthält. Mit einem Bericht auf Ereignisebene können Sie feststellen, dass Nutzer A, B und C die Kampagne 123 gesehen haben. Mit Zusammenfassungsberichten können Sie die Anzahl der Nutzer messen, die Kampagne 123 gesehen haben. Zum Schutz der Privatsphäre der Nutzer wird Rauschen hinzugefügt.

Weitere Informationen zur API finden Sie im Artikel Private Aggregation.

Auktionssignale zusammenfassen

Mit der privaten Aggregation können Sie die in Worklets verfügbaren Signale auf Ihrem Server aggregieren. Für die Signalaggregation können Sie die Methode privateAggregation.contributeToHistogram() verwenden, die im Worklet für Gebote von Käufern, im Worklet für die Bewertung von Verkäufern und in den Worklets für Berichte zu Käufern und Verkäufern verfügbar ist.

In diesem Beispiel wird das Gewinnergebot im Bucket für den Inhaber der Interessengruppe zusammengefasst:

function convertBuyerToBucket(igOwner) {}
function convertWinningBidToValue(winningBid) {}

function reportResult(auctionConfig, browserSignals) {
  privateAggregation.contributeToHistogram({
    bucket: convertBuyerToBucket(browserSignals.interestGroupOwner),
    value: convertWinningBidToValue(browserSignals.bid)
  });
} 

Dieser Mechanismus wird allgemein verwendet, wenn die Signale, die Sie aggregieren möchten, nicht mit Daten auf Ereignisebene verknüpft sind und nicht durch ein Ereignis außerhalb der Auktion ausgelöst werden. Weitere Informationen

Auktionssignale mit Ereignisdaten aggregieren

Sie können Auktionssignale mit begrenzten Informationen zu einem Ereignis zusammenfassen, das in einem Anzeigenframe auftritt. So können Sie beispielsweise die Anzahl der Klicks auf eine Anzeige für eine Kampagne insgesamt messen, indem Sie einen Bucket erstellen, der diese Kampagne und das Klickereignis darstellt. Im Anzeigen-Frame können Sie angeben, welches Ereignis stattgefunden hat, aber keine Nutzlast auf Ereignisebene anhängen.

Wenn Sie Auktionssignale nach Ereignissen zusammenfassen möchten, können Sie privateAggregation.contributeToHistogramOnEvent(eventType, contribution) verwenden. Dabei wird ein String mit dem Ereignistyp und dem Beitrag übergeben, der erfasst werden soll, wenn dieses Ereignis ausgelöst wird. Sie können die Methode mit einem benutzerdefinierten Ereignistyp aufrufen und dann window.fence.reportEvent(eventType) über den Anzeigen-Frame aufrufen, um das Senden des Berichts auszulösen.

Angenommen, Sie möchten messen, wie viele Klicks eine Anzeige für eine Kampagne erhalten hat.

// Protected Audience API worklet
function getClickReportBucketForCampaign(campaignId) {
  // return a bucket for the campaign ID and the click event
}

function generateBid(interestGroup) {
  privateAggregation.contributeToHistogramOnEvent('click', {
    bucket: getClickReportBucketForCampaign(interestGroup.ads.metadata.campaignId), 
    value: 1
  });
}

In der Funktion zur Gebotsgenerierung können Sie einen Bucket als Kombination aus der Kampagnen-ID und dem Klickereignis definieren und den Wert für diesen Bucket jedes Mal um 1 erhöhen, wenn das Ereignis ausgelöst wird.

// Ad frame
window.fence.reportEvent('click');

Später können Sie dann über den Anzeigen-Frame die Berichtseinreichung durch Aufrufen von reportEvent(eventType) auslösen:

Weitere Informationen zum Auslösen von Beiträgen zur privaten Aggregation über einen Frame findest du in diesem Hilfeartikel.

Auktionsergebnisse und Leistung erfassen

Sie können Auktionsergebnisse, die durch ein Ereignis vom Typ „Auktion gewonnen“ oder „Auktion verloren“ ausgelöst wurden, auch mit contributeToHistogramOnEvent(eventType, contribution) zusammenfassen, wenn Sie Keywords für reservierte Ereignistypen (reserved.win, reserved.loss und reserved.always) übergeben.

Die private Aggregation bietet eine Liste mit Basiswerten, anhand derer du den Bucket und den Wert deines Beitrags berechnen kannst. Die verfügbaren Basiswerte für Auktionsergebnisse sind der Gebotswert der Gewinneranzeige, der Gebotswert, der als zweithöchster bewertet wurde, und der Grund, warum ein Gebot von der Auktion abgelehnt wurde.

Wenn ein Basiswert angegeben ist, z. B. der Betrag des Gewinnergebots, können Sie festlegen, wie viel zu diesem Wert addiert oder von ihm abgezogen werden soll, und dann den Endwert erfassen. Wenn beispielsweise das Höchstgebot von 5 € als Basiswert angegeben ist, können Sie Ihr Gebot von 2 € abziehen, um den tatsächlichen Wert von 3 € zu berechnen, um den Sie die Auktion verloren haben.

Berichte zu Auktionsergebnissen

Angenommen, Sie haben eine Auktion verloren und möchten wissen, wie weit Ihr Gebot vom Auktionsabrechnungspreis entfernt war.

Wenn Sie wissen möchten, um wie viel Sie die Auktion verloren haben, können Sie Ihren Gebotspreis vom Preis des Gewinnergebots abziehen:

function generateBid() {
  const bid = calculateBidAmount();

  privateAggregation.contributeToHistogramOnEvent('reserved.loss', {
    bucket: getBucketForCampaign(interestGroup.ads.metadata.campaignId),
    value: {
      baseValue: 'winning-bid',
      scale: 1 // Scale the value to minimize noise-to-signal ratio 
      offset: -bid, // Numbers added to browser value after scaling 
    }
  });
}

Wenn der Bericht eingereicht wird, ist der tatsächliche gemeldete Wert der skalierte baseValue, der um den Wert offset verschoben wurde. Weitere Informationen finden Sie in der Erläuterung.

Leistungsberichte

Käufer und Verkäufer können melden, wie lange die Ausführung eines Scripts gedauert hat und wie lange es gedauert hat, die vertrauenswürdigen Signale abzurufen. Verkäufer können mit der Erlaubnis der Käufer die Zeit der Gebotserzeugung und die Zeit des vertrauenswürdigen Gebotssignals jedes Käufers erfassen.

Weitere Informationen

Auktionssignale im Shared Storage speichern

Gemeinsamer Speicher ist ein nicht partitionierter und plattformübergreifender Speicher, in den Sie frei schreiben können. Beim Lesen und Verarbeiten der gespeicherten Werte wird er jedoch durch Gates geschützt. Eines der verfügbaren Gates für die Shared Storage API ist Private Aggregation. Sie können die Werte im freigegebenen Speicher nur innerhalb eines Worklets lesen und diese Werte mithilfe der privaten Aggregation aus dem Worklet in Berichte aufnehmen.

Sie können auch über Gebote, Bewertungen und Berichte der Protected Audience API in den Shared Storage schreiben. Später können Sie diese Werte im freigegebenen Speicher mithilfe der privaten Aggregation an Ihren Server senden . Sie können die gespeicherten Werte auch für den Vorgang URL-Auswahl verwenden.

Über ein Protected Audience API-Worklet können Sie beliebige Schlüssel und Werte in den freigegebenen Speicher schreiben:

// Protected Audience API worklet
function generateBid() {
  sharedStorage.set('test-bucket', 123);
}

Später können Sie ein Shared Storage-Worklet laden, um diesen Wert mit Private Aggregation zu lesen und zu senden:

// Shared Storage worklet
class SendReachReport{
  async run() {
    const testBucket = await this.sharedStorage.get('test-bucket');

    privateAggregation.contributeToHistogram({
      bucket: testBucket,
      value: 1
    });
  }
}

register('send-report', SendReachReport);

Weitere Informationen zur Shared Storage API finden Sie im Abschnitt „Shared Storage“ des Entwicklerhandbuchs für die Protected Audience API, in der Erläuterung, in der Live-Demo und im Democode auf GitHub.

Nächste Schritte

Wir möchten mit Ihnen ins Gespräch kommen, um eine API zu entwickeln, die für alle funktioniert.

Über die API diskutieren

Wie andere Privacy Sandbox APIs wird auch diese API dokumentiert und öffentlich diskutiert.

Mit der API experimentieren

Sie können Tests zur Protected Audience API durchführen und sich an Diskussionen beteiligen.