Protected Audience API-Auktionsberichte

Auktionsdaten und Ergebnisse der Protected Audience API analysieren

In diesem Artikel finden Sie eine allgemeine Übersicht über die verschiedenen Mechanismen, mit denen Sie Protected Audience API-Auktionsdaten an Ihren Server melden können, sowie die Übergangsmechanismen, die Sie während der Migration verwenden können, bis alternative Lösungen verfügbar sind.

Wenn Sie Berichte zu wichtigen Messwerten erstellen möchten, die Sie aus einer Anzeigenauktion erhalten, verwendet die Protected Audience API Folgendes:

• Private Aggregation, bei der Auktionssignale und -ergebnisse erfasst werden, um Zusammenfassungsberichte zu generieren.
• Ads Reporting API für Fenced Frames und iFrames – ein Kanal innerhalb der Frames zur Kommunikation mit Protected Audience API-Worklets. Über die API können Daten auf Ereignisebene mit Auktionssignalen verknüpft werden. Die Berichterstellung auf Ereignisebene der Ads Reporting API ist eine Übergangslösung, bis ein privater Berichtmechanismus entwickelt wird.
• Attributionsberichte, in denen Conversion-Daten Auktionssignalen zugeordnet werden können
• Gemeinsam genutzter Speicher, mit dem Sie Auktionssignale in einen ursprungsübergreifenden Speicher schreiben und diese Daten dann später über die private Aggregation erstellen können.

Hinweis:Wir empfehlen Ihnen, die Dokumentation zu Private Aggregation, Fenced Frames, freigegebener Speicher und Attributionsberichte zu lesen, bevor Sie fortfahren, da in diesem Dokument die wichtigsten Konzepte erläutert werden.

Berichte zur Protected Audience API – Übersicht

Gesamter Workflow für Protected Audience

Es gibt drei Hauptzeiträume, in denen Daten aus dem Auktionsablauf der Protected Audience API an Ihren Server gemeldet werden können: Auktionszeit, wenn die Auktion auf der Publisher-Website durchgeführt wird, Renderingzeit, wenn die Anzeige in einem Fencing Frame oder 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 Berichte zu Auktionsdaten mithilfe von Berichts-Worklets erstellen. Während des Renderings können Sie Interaktionsdaten aus einem iFrame oder einem Fenced Frame melden. Während der Conversion können Sie mithilfe der Attribution Reporting API Attributionsdaten von der Landingpage erstellen.

Standorte melden

Innerhalb einer Auktion können die Käufer Signale melden, die in den Worklets „generateBid()“ und „reportWin()“ verfügbar sind. Die Verkäufer haben die Möglichkeit, Signale zu melden, die in „scoreAd()“ und „reportResult()“ verfügbar sind. 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, über die die Conversion erfolgt ist.

Zeitraum	Ziel	Standort	Daten verfügbar	Reporting APIs verfügbar
Auktion	Käufer	generateBid()	Signale, Auktionsergebnisse und Auktionsleistung	Private Aggregation API
		reportWin()		Private Aggregation API Ads Reporting API
	Verkäufer	scoreAd()		Private Aggregation API
		reportResult()		Private Aggregation API Ads Reporting API
Rendern	Käufer / Verkäufer	Frame auf der Publisher-Website	Daten auf Ereignisebene innerhalb des Anzeigen-Frames	Private Aggregation API Ads Reporting API
Conversion	Käufer / Verkäufer	Conversion-Website	Daten auf Conversion- und Ereignisebene der Conversion-Website	Attribution Reporting API Private Aggregation API Ads Reporting API

Für jeden der aufgeführten Zeiträume haben Käufer und Verkäufer Zugriff auf verschiedene APIs zur Berichterstellung, mit denen Daten wie Auktionssignale, Daten auf Ereignisebene und Conversion-Daten erfasst werden können.

In einer Protected Audience API-Auktion verfügbare Daten

Die folgenden Daten können während der Auktion von einem Protected Audience API-Worklet gemeldet werden.

Signale

Signale sind Kontextdaten aus Auktionen, Nutzerdaten, Echtzeit- und Browserdaten, die Käufern und Verkäufern in einem Worklet zur Verfügung stehen, um ein Gebot zu generieren, eine Anzeige zu bewerten und die Ergebnisse einer Auktion zu erfassen.

Signal	Beschreibung	Ort festlegen	Nutzer	Verfügbarkeit
auctionSignals	Daten, die für den Ort der Auktion verfügbar sind Diese Daten können Informationen zum Seiteninhalt, selbst erhobene Nutzerdaten und mehr umfassen.	Wird vom Verkäufer auf der Publisher-Website in der Auktionskonfiguration festgelegt.	Buyer Seller	generierenGebotsfaktorAnzeige reportWin Berichtergebnis
directFromSellerSignals	Dieselben Daten für auctionSignals, perBuyerSignals und sellerSignals, aber die Signale stammen garantiert vom angegebenen Verkäufer.	Wird über HTTP-Antwortheader des Verkäufers festgelegt	Buyer Seller	generierenGebotsfaktorAnzeige reportWin Berichtergebnis
browserSignals	Verschiedene über den Browser bereitgestellte Daten (topWindowHostname, interestGroupOwner, renderUrl, adComponents, biddingDurationMsec, IGJoinCount, IGRecency, modelingSignals)	Wird vom Browser festgelegt.	Buyer Seller	generierenGebotsfaktorAnzeige reportWin Berichtergebnis
sellerSignals	Signale, die dem Verkäufer für die Anzeigenbewertung zur Verfügung gestellt werden.	Wird vom Verkäufer auf der Publisher-Website in der Auktionskonfiguration festgelegt.	Verkäufer	scoreAd reportWin reportResult
trustedScoringSignals	Echtzeitsignale, die dem Verkäufer für die Anzeigenbewertung zur Verfügung gestellt werden.	Die URL wird vom Verkäufer auf der Publisher-Website in der Auktionskonfiguration festgelegt.	Verkäufer	ScoreAd reportResult
perBuyerSignals	Für bestimmte Käufer bereitgestellte Auktionskontextdaten Der Verkäufer kann die Werte für die Käufer abrufen, bevor die Auktion beginnt. Das ist die Kenntnis des Käufers über die Werbechance.	Wird vom Verkäufer auf der Publisher-Website in der Auktionskonfiguration festgelegt.	Käufer	generierenGebotsfaktorAnzeige reportWin Berichtergebnis
trustedBiddingSignals	Echtzeitsignale, die den Käufern für Anzeigengebote bereitgestellt werden.	Die URL wird vom Käufer auf der Website des Werbetreibenden festgelegt, wenn die Interessengruppe festgelegt ist.	Käufer	generateBid
userBiddingSignals	Vom Käufer bereitgestellte Nutzerdaten.	Wird vom Käufer auf der Website des Werbetreibenden festgelegt, wenn die Interessengruppe festgelegt ist .	Käufer	generateBid

Das Auktionskonfigurationsobjekt ist die primäre Datenquelle, um als Signale in Worklets verfügbar zu werden. Publisher und Verkäufer können Kontext- und selbst erhobene Daten in der Auktionskonfiguration bereitstellen. Diese Signale können mit den Interessengruppendaten des Käufers, Daten auf Ereignisebene aus dem Anzeigen-Rendering-Frame und Attributionsdaten von der Klickseite angereichert werden. Die gemeldeten Daten können unter anderem für Käufer-/Verkäuferberichte, Abrechnung, Budgetierung und das Training des ML-Modells verwendet werden.

Weitere verfügbare Daten

• Ergebnisdaten, die sich auf Daten zu erfolgreichen und verlorenen Auktionen beziehen, z. B. Preis für erfolgreiches Gebot und Grund für die Ablehnung des Gebots.
• Leistungsdaten, die Latenzinformationen enthalten, z. B. wie lange das Abrufen und Ausführen des Bidding-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.

Wenn die Anzeige während des Renderings auf der Publisher-Website gerendert wird, können die Daten auf Ereignisebene aus dem iFrame oder Fencing Frame mit den Auktionsdaten der Protected Audience API verknüpft und an Ihren Server gemeldet werden. Beispiele für Daten auf Ereignisebene sind Anzeigenimpressionen, Klicks, Mouseover-Ereignisse und alle anderen Ereignisse, die innerhalb des Frames auftreten.

Wenn ein Nutzer während der Conversion eine Aktion auf der Klickseite 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 gemeldet werden.

Berichte auf Ereignisebene

Berichte auf Ereignisebene enthalten detaillierte Informationen zu einem oder mehreren Ereignissen. Ein Ereignis kann ein Auktionsgewinn, eine Anzeigenimpression oder eine Conversion sein. Bis mindestens 2026 bleiben Berichte zu Auktionsgewinnen auf Ereignisebene verfügbar. Fenced Frames sind nicht erforderlich, um eine Protected Audience-Anzeige zu rendern, und ein iFrame mit uneingeschränktem Netzwerkzugriff kann für Berichte auf Ereignisebene verwendet werden. Außerdem ist die Ads Reporting API in Fencing Frames und iFrames verfügbar, damit Sie Auktions- und Conversion-Daten mit Daten auf Ereignisebene aus dem Frame verknüpfen können. So wird die Migration für das System einfacher, da Sie Ihre vorhandene Berichtsinfrastruktur bis mindestens 2026 weiter verwenden können, während Sie Ihr System zu Protected Audience migrieren.

Berichte zu Auktionsgewinnen auf Ereignisebene mit sendReportTo()

Ein Mechanismus, mit dem Daten auf Ereignisebene in einer Protected Audience-Auktion erfasst werden können, ist die sendReportTo() function bei einem Auktionsgewinn. Die Funktion ist in den Berichterstellungs-Worklets für Käufer und Verkäufer verfügbar. Der Browser sendet eine GET-Anfrage an den angegebenen URL-String, wenn das Anzeigen-Rendering beginnt. Sie können jedes in Ihren Worklets verfügbare Signal als Suchparameter der URL codieren.

Beispielsweise kann ein Käufer zu Abrechnungszwecken den Betrag des erfolgreichen Gebots aus dem Worklet „reportWin()“ melden:

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

Die Funktion sendReportTo() kann verwendet werden, um einen Gewinnbericht für den Verkäufer zu generieren, wenn er über reportResult() aufgerufen wird, und einen Gewinnbericht für den Käufer, wenn er über reportWin() aufgerufen wird. Die Funktion sendReportTo() ist bis mindestens 2026 verfügbar.

Bericht zu Interaktionen

Ein Interaktionsbericht enthält Daten auf Ereignisebene zu einem Anzeigen-Creative, z. B. Impressions- oder Klickdaten, die mit den Signalen der Protected Audience API-Auktion verknüpft sind, die die Anzeige gerendert hat. Da die Anzeige nach Abschluss der Auktion gerendert wird, sind die Auktionssignale in dem Frame, der die Anzeige rendert, nicht verfügbar. Um diese Daten aus verschiedenen Zeiträumen zuzuordnen, bieten wir dir zwei Übergangsmechanismen zum Generieren von Interaktionsberichten.

Die oben beschriebene sendReportTo()-Funktion kann verwendet werden, um Auktionsdaten mit Daten auf Ereignisebene aus einem iFrame zu verknüpfen. Sie funktioniert jedoch nicht für einen Fenced Frame, da keine eindeutige ID vom Einbettungscode übergeben werden kann, da die Kommunikation zwischen Einbettung und Fenced Frame eingeschränkt ist. Um Auktionsdaten mit Daten auf Ereignisebene aus einer Fencing-Frame-Anzeige zu verknüpfen, kann die Ads Reporting API verwendet werden.

Wichtig :Die heutigen Mechanismen für die Berichterstellung auf Ereignisebene in der Protected Audience API sind Übergangsmechanismen. In Zukunft wird eine alternative Lösung entwickelt, um bestehende Anwendungsfälle besser zu unterstützen.

Ads Reporting API für Fenced Frames und iFrames

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

In einem Worklet für die Berichterstellung der Protected Audience API können Sie ein Anzeigen-Beacon mit der registerAdBeacon()-Funktion registrieren und Ihre Berichts-URL mit den als Suchparametern hinzugefügten Signalen übergeben. Außerdem geben Sie das benutzerdefinierte Ereignis an, das mit der Berichts-URL verknüpft werden soll. Wenn die Anzeige später in einem Fenced Frame gerendert wird, können Sie das benutzerdefinierte Ereignis durch Aufrufen der Funktion window.fence.reportEvent() auslösen. Daten, die im Fenced Frame verfügbar sind, können als Nutzlast hinzugefügt werden.

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

Im folgenden Beispiel wird eine Kampagnen-ID einer Nutzlast auf Ereignisebene 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 wird aus denselben Gründen wie bei Gewinnberichten bis mindestens 2026 verfügbar sein.

Ausführlichere Informationen findest du in der Erläuterung.

Unbeschränkter Netzwerkzugriff

Fenced Frames ermöglichen das Laden von Netzwerkressourcen auf die gleiche Weise wie bei einem iFrame, und Sie können Daten auf Ereignisebene innerhalb von Fencing Frames an Ihren Server senden. Sie können später Berichte auf Ereignisebene serverseitig generieren. Verknüpfen Sie dazu die Daten auf Ereignisebene aus einem Fenced Frame mit den Auktionsdaten, die mit sendReportTo() gesendet wurden. Dies wird im Abschnitt Verfahren zur Berichterstellung auf Auktionsereignisebene weiter oben erläutert.

Der Netzwerkzugriff wird in Zukunft eingeschränkt.

Wichtig :Wir haben noch keinen konkreten Zeitplan für die Einschränkung des Netzwerkzugriffs, erwägen aber schrittweise Abhilfemaßnahmen, damit das System ausreichend Zeit hat, sich an diese Abhilfemaßnahmen anzupassen.

Attributionsbericht

Mithilfe eines Attributionsberichts können Sie eine Conversion auf einer Website einer Anzeige zuordnen, die aus einer Protected Audience API-Auktion ausgewählt wurde. Beispiel: Ein Nutzer klickt auf eine von Ihnen ausgelieferte Produktanzeige, wird auf die Website des Werbetreibenden weitergeleitet, kauft dort etwas und Sie möchten den Kauf der angezeigten Anzeige zuordnen. Die Attribution Reporting API wird in die Protected Audience API eingebunden, um die Auktionsdaten der Publisher-Website und die Conversion-Daten der Website des Werbetreibenden zu kombinieren.

Wir entwickeln zwar eine dauerhaftere Lösung, aber Sie können die Ads Reporting API für Fenced Frames als Übergangsmechanismus zum Generieren eines aggregierbaren Berichts auf Ereignisebene mit Attribution Reporting verwenden. Mit diesen Berichten lassen sich Conversions erfassen. Sie unterscheiden sich von den Berichten auf Ereignisebene und den Berichten zu aggregierbaren Interaktionen, die aus der Auktion und dem Anzeigen-Frame generiert werden. Wir werden eine Erklärung für eine dauerhaftere Lösung veröffentlichen, sobald sie fertig ist.

Übergangsmechanismus

Bei der Registrierung eines Anzeigen-Beacons können Sie das Keyword reserved.top_navigation verwenden. Dadurch wird der Attribution-Reporting-Eligible-Header automatisch hinzugefügt, damit das Beacon als Attributionsquelle registriert werden kann.

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

Wenn Sie Daten auf Ereignisebene an das von Ihnen registrierte Beacon anhängen möchten, können Sie setReportEventDataForAutomaticBeacons() aus dem Fencing 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 „Attributionsberichte“ in der Erläuterung zur Ads Reporting API.

Beispiel für Berichte zu Interaktionen und Conversions

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

Dabei sendet der Käufer in Absprache mit dem Verkäufer eine eindeutige ID an die Auktion. Diese eindeutige ID wird vom Käufer während der Auktion zusammen mit den Auktionsdaten gesendet. Während der Rendering- und Konvertierungszeit werden die Daten aus dem Fenced Frame oder iFrame ebenfalls mit derselben eindeutigen ID gesendet. Später können diese Berichte mithilfe der eindeutigen ID verknüpft werden.

Arbeitsablauf:

1. Vor Beginn der Auktion sendet der Käufer im Rahmen seiner programmatischen Gebotsantwort für Echtzeitgebote eine eindeutige ID an den Verkäufer. Die ID kann als Variable wie auctionId festgelegt werden. Die ID wird als perBuyerSignals in auctionConfig ü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 des Renderings und der Conversion (registerAdBeacon()) ausgelöst wird.
   1. Wenn Sie Auktionssignale für ein Anzeigen-Frame-Ereignis zuordnen möchten, legen Sie auctionId als Abfrageparameter der Beacon-URL fest.
   2. Wenn Sie einem Conversion-Ereignis Auktionssignale zuordnen möchten, müssen Sie die auctionId in der Beacon-URL festlegen.
3. Während des Anzeigen-Renderings können die Beacons, die Sie während der Auktion registriert haben, ausgelöst oder mit Daten auf Ereignisebene optimiert werden.
   1. Lösen Sie das Frame-Ereignis mit reportEvent() aus und übergeben Sie die Daten auf Ereignisebene.
   2. Dem Attributions-Beacon mit setReportEventDataForAutomaticBeacons() Nutzlast auf Ereignisebene hinzufügen
   3. Sie können die Anzeige für die Attribution Reporting API registrieren, indem Sie auf Beacon-Anfragen mit dem Header Attribution-Reporting-Register-Source antworten.
4. Während der Conversion können Sie die Quelle auslösen, die Sie während der Auktion registriert haben.

Nach dem oben beschriebenen Verfahren erhält der Käufer einen Auktions-, einen Interaktions- und einen Conversion-Bericht, die alle durch einen eindeutigen Schlüssel verknüpft sind, der miteinander verknüpft werden kann.

Ein ähnlicher Workflow gilt für Verkäufer, die Zugriff auf Attributionsdaten benötigen. Außerdem kann der Verkäufer eine eindeutige ID zum Senden mit registerAdBeacon() verwenden. Der reportEvent()-Aufruf enthält 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 gemeldet werden, um einen Zusammenfassungsbericht zu generieren. Dabei handelt es sich um einen ungenauen, aggregierten Bericht der in Buckets erfassten Daten. Ein Bucket wird durch einen Aggregationsschlüssel dargestellt. Einige Informationen können in dem Schlüssel codiert werden.

Beispielsweise kann ein Anzeigenimpressionsereignis in verschiedene Gruppen gezählt werden, wobei jede Gruppe für eine andere Werbekampagne steht. Ein zusammenfassender Bericht unterscheidet sich von einem Bericht auf Ereignisebene, da er keine Informationen zu jedem einzelnen Ereignis enthält. Mit einem Bericht auf Ereignisebene können Sie feststellen, dass die Nutzer A, B und C die Kampagne 123 gesehen haben. Mit zusammenfassenden Berichten können Sie die Anzahl der Nutzer messen, die Kampagne 123 gesehen haben, und Rauschen hinzugefügt, um die Privatsphäre der Nutzer zu schützen.

Weitere Informationen zur API finden Sie im Artikel Private Aggregation.

Auktionssignale aggregieren

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 privateAggregation.contributeToHistogram()-Methode verwenden, die im Worklet für Käufergebote, im Worklet für die Verkäuferbewertung und für die Berichterstellung für Käufer/Verkäufer verfügbar ist.

In diesem Beispiel wird das erfolgreiche Gebot in der Interessengruppen-Inhaber-Gruppe zusammengefasst:

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

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

Das ist der allgemeine Mechanismus, 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 Anzeigen-Frame auftritt. Sie können beispielsweise aggregiert messen, wie viele Klicks eine Anzeige für eine Kampagne erhalten hat, indem Sie eine Gruppe erstellen, die diese Kampagne und das Klickereignis repräsentiert. Sie können im Anzeigen-Frame angeben, welches Ereignis aufgetreten ist, aber Sie können keine Nutzlast auf Ereignisebene anhängen.

Wenn Sie Auktionssignale nach Ereignissen aggregieren möchten, können Sie privateAggregation.contributeToHistogramOnEvent(eventType, contribution) verwenden. Dabei wird ein String verwendet, der den Ereignistyp und den Beitrag angibt, der beim Auslösen dieses Ereignisses erfasst werden soll. Sie können die Methode mit einem benutzerdefinierten Ereignistyp aufrufen und dann window.fence.reportEvent(eventType) aus dem Anzeigenframe 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 eine Gruppe als eine Kombination aus Kampagnen-ID und Klickereignis definieren und dann den Wert für diese Gruppe jedes Mal, wenn das Ereignis ausgelöst wird, um 1 erhöhen.

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

Später können Sie dann aus dem Anzeigen-Frame die Berichterstellung durch Aufrufen von reportEvent(eventType) auslösen:

Weitere Informationen zum Auslösen von Beiträgen zur privaten Aggregation aus einem Frame finden Sie in der Erläuterung.

Berichte zu Auktionsergebnissen und zur Leistung erstellen

Sie können Auktionsergebnisse auch aggregieren, wenn sie durch ein Ereignis vom Typ „Auktion“ oder „Auktion“ mit contributeToHistogramOnEvent(eventType, contribution) ausgelöst wird, wenn Sie Keywords vom Typ „Reserviert“ des Ereignistyps (reserved.win, reserved.loss und reserved.always) übergeben.

Die private Aggregation stellt eine Liste von Basiswerten bereit, aus der Sie den Bucket und den Wert Ihres Beitrags berechnen können. Die verfügbaren Basiswerte für Auktionsergebnisse sind der Gebotswert der erfolgreichen Anzeige, der zweithöchste Gebotswert und der Grund für die Ablehnung eines Gebots von der Auktion.

Wenn ein Basiswert angegeben wird, z. B. der Betrag des erfolgreichen Gebots, können Sie festlegen, wie viel dieser Wert addiert oder subtrahiert werden soll, und dann den endgültigen Wert erfassen. Wird beispielsweise das erfolgreiche Gebot von 5 € als Basiswert angegeben, 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

Sehen wir uns ein Beispiel an, bei dem Sie eine Auktion verloren haben und herausfinden möchten, wie weit Ihr Gebot vom Auktions-Clearingpreis entfernt war.

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

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, verschoben um den offset-Wert. Weitere Informationen

Leistungsberichte

Käufer und Verkäufer können ermitteln, wie lange die Ausführung eines Scripts und das Abrufen der vertrauenswürdigen Signale gedauert haben. Verkäufer können mit ihrer Zustimmung den Zeitpunkt der Gebotserstellung und den Zeitpunkt des Trusted-Bidding-Signals jedes Käufers erfassen.

Weitere Informationen

Auktionssignale im freigegebenen Speicher speichern

Gemeinsam genutzter Speicher ist ein nicht partitionierter und ursprungsübergreifender Speicher, in den Sie frei schreiben können, der aber beim Lesen und Verarbeiten der gespeicherten Werte durch Gatter geschützt wird. Eines der verfügbaren Gatter für die Shared Storage API ist die private Aggregation. Sie können die Werte im freigegebenen Speicher nur aus einem Worklet heraus lesen und mit der privaten Aggregation aus dem Worklet in Berichte aufnehmen.

Sie können auch über die Protected Audience API-Worklets für Gebote, Bewertungen und Berichterstellung in den freigegebenen Speicher schreiben. Später können Sie diese Werte im freigegebenen Speicher mithilfe der privaten Zusammenfassung an Ihren Server melden . Sie können die gespeicherten Werte auch für den URL-Auswahlvorgang 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 freigegebenes Speicher-Worklet laden, um diesen Wert mit der privaten 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 zu gemeinsamem Speicher finden Sie im Entwicklerleitfaden zur Berichterstellung der Protected Audience API im Abschnitt zu freigegebenem Speicher, 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.