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.
Berichte zur Protected Audience API – Übersicht
<ph type="x-smartling-placeholder">![Allgemeiner Workflow für Protected Audience](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/protected-audience-overal-cd55be71ecfa2.png?authuser=19&hl=de)
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 Berichts-APIs, 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. Damit können sie ein Gebot generieren, eine Anzeige bewerten und die Ergebnisse einer Auktion 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. | Käufer- Verkäufer |
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 | Käufer- Verkäufer |
generierenGebotsfaktorAnzeige reportWin Berichtergebnis |
browserSignals | Verschiedene über den Browser bereitgestellte Daten (topWindowHostname , interestGroupOwner , renderUrl , adComponents , biddingDurationMsec , IGJoinCount , IGRecency , modelingSignals ) |
Wird vom Browser festgelegt. | Käufer- Verkäufer |
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 Fence 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.
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.
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:
- 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 alsperBuyerSignals
inauctionConfig
übergeben und ist in den Worklets des Käufers verfügbar. - Während der Auktion kann der Käufer ein Anzeigen-Beacon registrieren, das während des Renderings und der Conversion (
registerAdBeacon()
) ausgelöst wird. <ph type="x-smartling-placeholder">- </ph>
- Wenn Sie Auktionssignale für ein Anzeigen-Frame-Ereignis zuordnen möchten, legen Sie
auctionId
als Abfrageparameter der Beacon-URL fest. - Wenn Sie einem Conversion-Ereignis Auktionssignale zuordnen möchten, müssen Sie die
auctionId
in der Beacon-URL festlegen.
- Wenn Sie Auktionssignale für ein Anzeigen-Frame-Ereignis zuordnen möchten, legen Sie
- 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.
- Lösen Sie das Frame-Ereignis mit
reportEvent()
aus und übergeben Sie die Daten auf Ereignisebene. - Dem Attributions-Beacon mit
setReportEventDataForAutomaticBeacons()
Nutzlast auf Ereignisebene hinzufügen - 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.
- Lösen Sie das Frame-Ereignis mit
- 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.
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.