Topics API einrichten

Bereiten Sie Ihre Umgebung vor, um Webanwendungen mit der Topics API zu verwenden, zu testen und zu entwickeln.

Build lokal erstellen und testen

In diesem Abschnitt wird beschrieben, wie Sie Ihre lokale Umgebung einrichten, um die Topics API als einzelner Entwickler auszuprobieren. Wir empfehlen, sich die Demos anzusehen, um zu verstehen, wie Topics funktioniert, bevor Sie mit der Implementierung beginnen.

„Topics“ in Ihrem Browser aktivieren

Sie haben zwei Möglichkeiten, die Topics API in Ihrer eigenen Chrome-Instanz für lokale Tests zu aktivieren:

  1. Aktivieren Sie alle APIs zum Datenschutz bei Werbung unter chrome://settings/adPrivacy.
  2. (Empfohlen) Führen Sie Chrome über die Befehlszeile mit Chromium-Flags aus und verwenden Sie Topics API-spezifische Parameter, um die Konfiguration nach Bedarf vorzunehmen. Wenn Sie Chrome über die Befehlszeile ausführen, haben Sie eine detailliertere Kontrolle über die Themen-Funktionen. Sie können beispielsweise Topics-Epochen festlegen (der von der API verwendete Zeitraum zum Berechnen der Nutzerinteressen) und das Verhalten der API nach Bedarf konfigurieren.

Wichtige Empfehlungen

  1. Schließen und beenden Sie alle Chrome-Prozesse, bevor Sie den neuen Prozess mit den Flags starten.
  2. Prüfen Sie, ob alle APIs zum Datenschutz bei Werbung unter chrome://settings/adPrivacy aktiviert sind.
  3. Wenn die API nicht wie erwartet funktioniert, probieren Sie unsere Tipps zur Fehlerbehebung aus.
  4. Bei Fragen können Sie sich die GitHub-Probleme für die Erläuterung ansehen.

Topics API mit Chrome-Flags steuern

Chrome-Flags können das Verhalten der Topics API ändern. Führen Sie Chrome über die Befehlszeile mit den angegebenen Parametern aus, um das Testen zu erleichtern. In der Header-Demo wird beispielsweise die Verwendung der folgenden Flags empfohlen:

--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

In der folgenden Tabelle werden die einzelnen Parameter, ihre Standardwerte und ihr Zweck erläutert.

Name des Parameters Standardwert Beschreibung
BrowsingTopics aktiviert Gibt an, ob die Topics API aktiviert ist.
PrivacySandboxAdsAPIsOverride aktiviert Aktiviert Anzeigen-APIs: Attribution Reporting, Protected Audience, Topics, Fenced Frames.
PrivacySandboxSettings4 deaktiviert Aktiviert die vierte Version der Privacy Sandbox-UI-Einstellungen.
OverridePrivacySandboxSettingsLocalTesting aktiviert Wenn diese Option aktiviert ist, müssen die zugrunde liegenden Einstellungen nicht mehr aktiviert sein, damit die Privacy Sandbox-Funktionen im Browser aktiviert werden können.
BrowsingTopicsBypassIPIsPubliclyRoutableCheck deaktiviert Wenn diese Option aktiviert ist, wird die Prüfung, ob die IP-Adresse öffentlich weitergeleitet werden kann, bei der Ermittlung der Berechtigung einer Seite für die Einbeziehung in die Themenberechnung umgangen.
BrowsingTopics:number_of_epochs_to_expose 3 Die Anzahl der Epochen, ab der die Themen für einen anfragenden Kontext berechnet werden sollen. Der Browser speichert intern bis zu N+1 Epochen.
BrowsingTopics:time_period_per_epoch 7d-0h-0m-0s Dauer der einzelnen Epochen. Zum Debuggen kann es hilfreich sein, diesen Wert auf z. B. 15 Sekunden anstatt auf die Standardeinstellung von sieben Tagen festzulegen.
BrowsingTopics:number_of_top_topics_per_epoch 5 Anzahl der Themen, die pro Epoche berechnet werden.
BrowsingTopics:use_random_topic_probability_percent 5 Die Wahrscheinlichkeit, dass ein einzelnes Thema innerhalb einer Epoche zufällig aus der gesamten Taxonomie der Themen ausgewählt wird. Die Zufälligkeit ist an eine Epoche und Website gebunden.
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering 3 Gibt an, wie viele Epochen von API-Nutzungsdaten (d.h. Themenbeobachtungen) zum Filtern der Themen für einen Aufrufkontext verwendet werden.
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic 1000 Die maximale Anzahl von „Beobachtet von“-Kontextdomains, die für jedes Top-Thema beibehalten werden sollen. Der Zweck ist, den verwendeten Arbeitsspeicher zu begrenzen.
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch 100.000 Die maximale Anzahl von Einträgen, die für jede Abfrage für die API-Nutzungskontexte aus der Datenbank abgerufen werden dürfen. Die Abfrage wird einmal pro Epoche zum Zeitpunkt der Themenberechnung ausgeführt. Die maximale Arbeitsspeichernutzung soll begrenzt werden.
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load 30 Die maximale Anzahl von API-Nutzungskontextdomains, die pro Seitenaufruf gespeichert werden dürfen.
BrowsingTopics:config_version 1 Codiert die Konfigurationsparameter der Topics API. Jede Versionsnummer sollte nur einem Konfigurationssatz zugeordnet werden. Das Aktualisieren der Konfigurationsparameter ohne Aktualisierung von config_version sollte in der Regel für lokale Tests in Ordnung sein. In einigen Situationen kann der Browser jedoch in einen inkonsistenten Zustand geraten und abstürzen, z. B. wenn number_of_top_topics_per_epoch aktualisiert wird.
BrowsingTopics:taxonomy_version 1 Die von der API verwendete Taxonomieversion.

Vor der Implementierung

Bevor Sie mit der Implementierung beginnen, empfehlen wir Ihnen, sich mit diesen Ressourcen vertraut zu machen, um sich über die Topics API zu informieren.

  1. Entwicklerdokumentation ansehen:
    1. Zweck der Topics API und ihre Rolle bei interessenbasierter Werbung
    2. Funktionsweise von Topics im Web
    3. Probieren Sie die Demos aus und sehen Sie sich das Walkthrough-Video zu Topics-Demos, Colab und Tools an.
    4. Erstellen Sie einen Fork der Demos und führen Sie sie auf Ihrer eigenen Website aus.
    5. Weitere Informationen finden Sie in der API-Erklärung.
  2. Die API spielt eine wichtige Rolle bei der Unterstützung der Anzeigenrelevanz in einer Zukunft, in der Drittanbieter-Cookies für einen immer größeren Anteil der Nutzer nicht verfügbar sein werden.
  3. Wenn Sie über Statusänderungen in der API benachrichtigt werden möchten, treten Sie der Mailingliste für Entwickler bei und informieren Sie sich über die neuesten Updates zu Topics.
  4. Beteiligen Sie sich an der Diskussion in den GitHub-Problemen oder in den W3C-Anrufen.
  5. Wenn Sie auf unbekannte Begriffe stoßen, lesen Sie das Privacy Sandbox-Glossar.
  6. Weitere Informationen zu Chrome-Konzepten wie Chrome-Flags finden Sie in den kurzen Videos und Artikeln unter goo.gle/cc.

Nächste Schritte

Hier finden Sie Implementierungsdetails und Codebeispiele, mit denen Anrufer Themen beobachten und darauf zugreifen können.
Hier erfahren Sie, wie Sie themenbasierte Lösungen bereitstellen, testen und skalieren.