Zielgruppendaten aktualisieren und Anzeigen aktualisieren

Hier erfahren Sie, wie Sie Zielgruppendaten aktualisieren, indem Sie eine Update-URL für eine Protected Audience API-Interessengruppe konfigurieren. Im Entwicklerleitfaden finden Sie Informationen zum gesamten Lebenszyklus der Protected Audience API. Im Protected Audience API-Explainer wird ausführlich beschrieben, wie Browser Interessengruppen aufzeichnen.

Sie sind kein Entwickler? Weitere Informationen finden Sie in der Übersicht zur Protected Audience API.

Protected Audience API-Interessengruppen

Eine Protected Audience API-Interessengruppe stellt eine Gruppe von Personen mit einem gemeinsamen Interesse dar, was einer Remarketing-Liste entspricht. Jede Interessengruppe der Protected Audience API hat einen Inhaber.

Interessengruppeninhaber fungieren als Käufer in der Anzeigenauktion der Protected Audience API. Die Zugehörigkeit zu Interessengruppen wird vom Browser auf dem Gerät des Nutzers gespeichert und nicht an den Browseranbieter oder andere weitergegeben.

API-Funktionen

Nutzungsbeispiel

Hier ist das Beispiel aus dem Leitfaden zum Definieren von Zielgruppendaten, das zeigt, wie Sie eine Interessengruppe erstellen und den Browser auffordern, 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 enthält eine URL, die JSON zurückgibt, um Attribute von Interessengruppen zu aktualisieren. Dieser muss denselben Ursprung wie owner haben.

Attribute aktualisieren

updateUrl gibt einen Webserver an, der JSON zurückgibt, das die Eigenschaften der Interessengruppe definiert, 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:

  • biddingLogicUrl
  • biddingWasmHelperUrl
  • trustedBiddingSignalsUrl
  • trustedBiddingSignalsKeys
  • ads
  • priority

Felder, die nicht im JSON angegeben sind, werden nicht überschrieben. Nur Felder, die im JSON angegeben sind, werden aktualisiert. Beim Aufrufen von navigator.joinAdInterestGroup() wird dagegen jede vorhandene Interessengruppe überschrieben.

Updates werden auf Best-Effort-Basis ausgeführt und können unter den folgenden Bedingungen fehlschlagen:

  • Zeitlimit für Netzwerkanfragen (derzeit 30 Sekunden).
  • Anderer Netzwerkfehler.
  • JSON-Parsing fehlgeschlagen.

Aktualisierungen sind auf maximal eine pro Tag beschränkt.

Updates können abgebrochen werden, wenn zu viel Zeit mit dem Aktualisieren verbracht wurde. Dies führt jedoch nicht zu einer Ratenbegrenzung für abgebrochene (verbleibende) Updates. Updates, die aufgrund von Netzwerkfehlern fehlschlagen, werden nach einer Stunde wiederholt. Updates, die aufgrund einer Unterbrechung der Internetverbindung fehlschlagen, werden sofort nach der 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.

Durch die Ratenbegrenzung wird verhindert, dass Aktualisierungen zu häufig erfolgen: Wiederholte Aufrufe von navigator.updateAdInterestGroups() haben erst dann Auswirkungen, wenn der Zeitraum für die Ratenbegrenzung (derzeit ein Tag) abgelaufen ist.

Das Ratenlimit wird zurückgesetzt, wenn navigator.joinAdInterestGroup() noch einmal für dieselbe Interessengruppe owner und name aufgerufen wird.

Automatische Updates

Alle für eine Auktion geladenen Interessengruppen werden nach Abschluss einer Auktion automatisch aktualisiert. Dabei gelten dieselben Ratenbeschränkungen wie bei manuellen Aktualisierungen.

Für jeden Inhaber mit mindestens einer Interessengruppe, die an einer Auktion teilnimmt, wird navigator.updateAdInterestGroups() so aufgerufen, als ob dies über einen iFrame erfolgt, dessen Ursprung mit dem Inhaber übereinstimmt.

Alle Verweise auf die Protected Audience API

API-Referenzleitfäden sind verfügbar:

In der Erläuterung der Protected Audience API finden Sie auch Details zur Funktionsunterstützung und zu den Einschränkungen.