Hier erfahren Sie, wie Sie Zielgruppendaten durch Konfigurieren einer Update-URL für eine Protected Audience API-Interessengruppe aktualisieren. Im Entwicklerleitfaden finden Sie Informationen zum gesamten Lebenszyklus der Protected Audience API. In der Erläuterung der Protected Audience API finden Sie detaillierte Vorschläge dazu, wie Interessengruppen in Browsern aufgezeichnet werden.
Sie sind kein Entwickler? Weitere Informationen finden Sie in der Übersicht über die Protected Audience API.
Interessengruppen der Protected Audience API
Eine Protected Audience API-Interessengruppe repräsentiert eine Gruppe von Personen mit gemeinsamen Interessen, die einer Remarketing-Liste entspricht. Jede Protected Audience API-Interessengruppe hat einen Inhaber.
Inhaber von Interessengruppen agieren als Käufer in der Protected Audience API-Anzeigenauktion. Die Mitgliedschaft in einer Interessengruppe wird vom Browser auf dem Gerät des Nutzers gespeichert und weder an den Browseranbieter noch an Dritte weitergegeben.
API-Funktionen
Anwendungsbeispiel
Dieses Beispiel aus dem Leitfaden zum Definieren von Zielgruppendaten zeigt, wie Sie eine Interessengruppe erstellen und den Browser bitten, der Gruppe beizutreten.
const interestGroup = {
owner: 'https://dsp.example',
name: 'custom-bikes',
biddingLogicUrl: ...,
biddingWasmHelperUrl: ...,
updateUrl: ...,
trustedBiddingSignalsUrl: ...,
trustedBiddingSignalsKeys: ['key1', 'key2'],
userBiddingSignals: {...},
ads: [bikeAd1, bikeAd2, bikeAd3],
adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};
navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);
updateUrl stellt eine URL bereit, die JSON zurückgibt, um Interessengruppenattribute zu aktualisieren. Dieses Element muss denselben Ursprung wie das owner haben.
Attribute aktualisieren
updateUrl gibt einen Webserver an, der JSON-Daten zurückgibt, mit dem auf Interessengruppen basierende Eigenschaften definiert werden, die dem an joinAdInterestGroup() übergebenen Interessengruppenobjekt entsprechen.
So kann der Inhaber der Gruppe die Attribute der Interessengruppe regelmäßig aktualisieren. In der aktuellen Implementierung können die folgenden Attribute geändert werden:
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
Felder, die nicht im JSON-Format angegeben sind, werden nicht überschrieben. Nur die im JSON-Format angegebenen Felder werden aktualisiert. Wenn navigator.joinAdInterestGroup() aufgerufen wird, werden alle vorhandenen Interessengruppen überschrieben.
Updates erfolgen auf Best-Effort-Basis und können unter den folgenden Bedingungen fehlschlagen:
- Zeitlimit für Netzwerkanfragen (derzeit 30 Sekunden).
- Anderer Netzwerkfehler.
- JSON-Parsing-Fehler.
Die Anzahl der Aktualisierungen ist auf maximal ein Update pro Tag beschränkt.
Aktualisierungen können abgebrochen werden, wenn zu viel Zeit für die Aktualisierung aufgewendet wurde. Dies birgt jedoch keine Ratenbegrenzung für abgebrochene (verbleibende) Aktualisierungen. Updates, die aufgrund von Netzwerkfehlern fehlschlagen, werden nach einer Stunde wiederholt. Updates, die aufgrund einer unterbrochenen Internetverbindung nicht ausgeführt werden, werden sofort nach erneuter Verbindung wiederholt.
Manuelle Updates
Aktualisierungen von Interessengruppen, die zum Ursprung des aktuellen Frames gehören, können manuell mit navigator.updateAdInterestGroups() ausgelöst werden.
Durch die Ratenbegrenzung wird verhindert, dass Aktualisierungen zu häufig durchgeführt werden: Wiederholte Aufrufe von navigator.updateAdInterestGroups() bewirken erst nach Ablauf des Zeitraums für die Ratenbegrenzung (derzeit ein Tag).
Das Ratenlimit wird zurückgesetzt, wenn navigator.joinAdInterestGroup() für dieselbe Interessengruppe owner und name noch einmal aufgerufen wird.
Automatische Updates
Alle für eine Auktion geladenen Interessengruppen werden nach Abschluss einer Auktion automatisch aktualisiert. Dabei gelten die gleichen Ratenbegrenzungen wie bei manuellen Aktualisierungen.
Für jeden Inhaber mit mindestens einer Interessengruppe, die an einer Auktion teilnimmt, ist es so, als würde navigator.updateAdInterestGroups() von einem iFrame aufgerufen, dessen Ursprung mit diesem Inhaber übereinstimmt.
Alle Protected Audience API-Referenzen
API-Referenzleitfäden sind verfügbar:
- Entwicklerleitfaden für die Protected Audience API
- Käuferleitfaden für Protected Audience zu Interessengruppen und Gebotserstellung.
- Leitfaden für Anzeigenverkäufer zu Protected Audience-Anzeigenauktionen
- Leitfaden zur Berichterstellung für Auktionsergebnisse
- Best Practices für die Latenz bei der Anzeigenauktion von Protected Audience
- Fehlerbehebung bei Protected Audience
In der Erläuterung der Protected Audience API finden Sie auch Details zur Funktionsunterstützung und zu den Einschränkungen.