Hier erfahren Sie, wie Sie Zielgruppendaten aktualisieren, indem Sie eine Aktualisierungs-URL für eine Protected Audience API-Interessengruppe konfigurieren. Im Entwicklerleitfaden finden Sie Informationen zum gesamten Lebenszyklus der Protected Audience API. In der Erläuterung zur Protected Audience API finden Sie einen detaillierten Vorschlag, wie Browser Interessengruppen erfassen.
Sie sind kein Entwickler? Weitere Informationen finden Sie in der Übersicht zur Protected Audience API.
Protected Audience API-Interessengruppen
Eine Protected Audience API-Interessengruppe steht für eine Gruppe von Nutzern mit gemeinsamen Interessen und entspricht einer Remarketing-Liste. 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 nicht an den Anbieter des Browsers oder andere Personen weitergegeben.
API-Funktionen
Nutzungsbeispiel
Das folgende Beispiel für die Definition 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);
Der updateUrl stellt eine URL bereit, die JSON zurückgibt, um Interessengruppenattribute zu aktualisieren. Dieser muss denselben Ursprung haben wie der owner.
Attribute aktualisieren
updateUrl gibt einen Webserver an, der JSON zur Definition der Interessengruppeneigenschaften zurückgibt, die dem an joinAdInterestGroup() übergebenen Interessengruppenobjekt entsprechen.
So kann der Gruppeninhaber die Attribute der Interessengruppe regelmäßig aktualisieren. In der aktuellen Implementierung können die folgenden Attribute geändert werden:
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
Felder, die nicht in der JSON-Datei angegeben sind, werden nicht überschrieben. Nur in der JSON-Datei angegebene Felder werden aktualisiert. Beim Aufrufen von navigator.joinAdInterestGroup() werden dagegen alle vorhandenen Interessengruppen überschrieben.
Updates erfolgen bestmöglich und können unter den folgenden Bedingungen fehlschlagen:
- Zeitüberschreitung bei Netzwerkanfrage (derzeit 30 Sekunden).
- Anderer Netzwerkfehler.
- JSON-Parsing fehlgeschlagen.
Updates sind auf maximal ein Update pro Tag beschränkt.
Aktualisierungen können abgebrochen werden, wenn zu viel zusammenhängende Zeit für Aktualisierungen aufgewendet wurde. Dies erzwingt jedoch keine Ratenbegrenzung für abgebrochene (verbleibende) Aktualisierungen. Updates, die aufgrund von Netzwerkfehlern fehlschlagen, werden nach einer Stunde wiederholt. Updates, die aufgrund einer Unterbrechung vom Internet fehlgeschlagen sind, werden sofort nach Wiederherstellung der Verbindung wiederholt.
Manuelle Updates
Aktualisierungen von Interessengruppen, die dem Ursprung des aktuellen Frames gehören, können manuell mit navigator.updateAdInterestGroups() ausgelöst werden.
Die Ratenbegrenzung verhindert, dass zu häufig Updates durchgeführt werden: Wiederholte Aufrufe von navigator.updateAdInterestGroups() führen erst nach Ablauf des Ratenlimits (derzeit ein Tag) zu einer Aktion.
Die Ratenbegrenzung 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 dieselben Ratenbegrenzungen wie für manuelle 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 aus aufgerufen, dessen Ursprung mit diesem Inhaber übereinstimmt.
Alle Protected Audience API-Referenzen
API reference guides are available:
- Developer guide for the Protected Audience API.
- Ad buyer guide to Protected Audience interest groups and bid generation.
- Ad seller guide to Protected Audience ad auctions.
- Guide to reporting auction results
- Best practices for Protected Audience ad auction latency
- Troubleshoot Protected Audience
The Protected Audience API explainer also provides detail about feature support and constraints.