Themenbasierte Lösung testen, bereitstellen und skalieren

Auf dieser Seite wird beschrieben, wie Sie eine Implementierung für die Produktion mit der Topics API erstellen, testen und skalieren.

Backend-Implementierung für Topics

Ihre Backend-Implementierung hängt davon ab, wie Sie die im Browser berechneten Themen verwenden möchten. Wir empfehlen, dass Anzeigentechnologielösungen Themen als zusätzliches IBA-Signal verwenden.

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

Topics als zusätzliches Signal verwenden

Themendaten können als zusätzliches Signal für Ihre Zielgruppe neben anderen Signalen wie URLs, Keywords oder anderen Metadaten berücksichtigt werden.

Wie im Hilfeartikel Anzeigenrelevanz ohne Drittanbieter-Cookies maximieren beschrieben, gibt es mehrere Möglichkeiten, Topics zur Auslieferung relevanter Anzeigen zu nutzen. Bei einigen dieser Ansätze werden Themen verwendet, um Zielgruppen zu erstellen. Bei anderen werden Themen als eines von mehreren Signalen zum Trainieren von Modellen für maschinelles Lernen verwendet, mit denen zusätzliche Interessen der Zielgruppe abgeleitet oder sogar die Gebotslogik optimiert werden kann.

Erstellen und bereitstellen

  1. Themen durch Beobachtung von Nutzern in der Produktion erfassen (geschätzte Implementierungszeit: etwa eine Woche):
    • Informieren Sie sich über die Optionen zum Aufrufen von Topics mit HTTP-Headern oder iFrame und JavaScript.
    • Definieren Sie die Domain des iFrames, mit dem die Topics API aufgerufen wird.
    • Erstellen Sie Ihre Lösung und verwenden Sie die Header-Demo oder die JavaScript-Demo als Code-Referenz.
    • Integrieren Sie Topics in den Code, den Publisher auf ihren Websites einbetten (z. B. Ihr Anzeigen-iFrame). Achten Sie darauf, dass Sie Themen aus dem Einbettungscode aufrufen.
    • Wenn Sie Nutzer-Themen beobachten möchten, müssen Sie die aktuelle Version Ihres Scripts auf Ihren Produktionswebsites einbetten. Wir empfehlen, die Implementierung zuerst auf Ihren eigenen Websites mit einer geringen Anzahl monatlicher Besuche zu testen. In dieser Phase empfehlen wir, Ihre neue themenbasierte Lösung auf mindestens fünf Websites einzubetten.
    • An diesem Punkt wird erwartet, dass die API ein leeres Array als Ergebnis zurückgibt. Das liegt daran, dass für den Nutzer noch keine Themen beobachtet wurden. Es kann bis zu drei Wochen dauern, bis Sie Nutzer-Themen erhalten.
    • Führen Sie Funktionstests und ‑validierungen durch. Sie können Ihre Lösung manuell oder automatisch testen. Beispiel:
  2. Topics-Daten zusammen mit anderen kontextbezogenen Signalen (z. B. URLs, Metadaten usw.) verwenden (geschätzte Dauer: ca. 3 Tage).
    • Nach drei Wochen in der Produktionsumgebung sollten in Ihrem Skript die Themen einiger Nutzer beobachtet worden sein. An diesem Punkt sollten Sie Topics-Daten als zusätzliches Signal verwenden können.
    • Sobald Sie eine nicht leere Liste von Themen erhalten, können Sie sie mit anderen Kontextsignalen an Ihr Backend senden.

Auf Zielwebsites bereitstellen

Nachdem Sie einen Topics-Aufruf in Ihr Script eingebunden haben, sollten Sie ihn zuerst auf einigen Produktionswebsites einbetten, um ihn zu testen. So prüfen Sie, ob Ihre Implementierung wie erwartet funktioniert:

  • Die Topics API wird aufgerufen.
  • Themen können in dieser kontrollierten Umgebung beobachtet werden.
  • Auf Themen kann zugegriffen werden (die API gibt beobachtete Themen für den Nutzer zurück).

Zielwebsites auswählen

Bevor Sie Ihre Lösung auf den Websites von Publishern bereitstellen, empfehlen wir, sie in einer kontrollierten Umgebung auf Ihren eigenen Websites zu testen. Wir empfehlen, Zielwebsites so auszuwählen:

  • Die Website hat nur wenige monatliche Besuche (weniger als etwa eine Million Besuche pro Monat): Sie sollten die API zuerst für eine kleine Zielgruppe bereitstellen.
  • Sie sind der Inhaber der Website und haben die Kontrolle darüber: Bei Bedarf können Sie die Implementierung schnell deaktivieren, ohne dass komplexe Genehmigungen erforderlich sind.
  • Die Website ist nicht geschäftskritisch: Beginnen Sie mit Zielwebsites mit geringem Risiko.
  • Insgesamt maximal fünf Websites: Sie benötigen vorerst nicht so viel Traffic oder Sichtbarkeit.
  • Die Zielwebsites repräsentieren verschiedene Themen. Wählen Sie Websites aus, die verschiedene Kategorien repräsentieren (z. B. eine über Sport, eine über Nachrichten und eine über Essen und Trinken). Sie können das interne Tool für Themen in Chrome verwenden, um Domains und ihre Klassifizierung durch den ML-Klassifikator für Themen zu validieren.

Funktionstests und ‑validierung

Wenn Sie die Topics API in dieser eingeschränkten Umgebung aufrufen, erwarten Sie die folgenden Ergebnisse:

  • Ein leeres Themen-Array [], wenn dies der erste Aufruf dieses Geräts für diese Website und diesen Aufrufer in den letzten sieben Tagen ist.

  • Eine Liste mit null bis drei Themen, die die Interessen dieses Nutzers repräsentieren. Nach sieben Tagen Beobachtung sollten Sie Folgendes erhalten:

    • Ein Thema, das aus den fünf wichtigsten Themen des Nutzers ausgewählt wird. Diese werden anhand der Hostnamen von Seiten berechnet, auf denen der Aufrufer in dieser Woche Themen beobachtet hat.

  • Die API-Antwort ist genau dieselbe wie bei allen vorherigen Topics API-Aufrufen. Für denselben Aufrufer, Nutzer und dieselbe Website der obersten Ebene gibt die API für die gesamte Epoche dieselben Themen zurück. So wird verhindert, dass zu viele Interessen des Nutzers offengelegt werden. Weitere Informationen auf GitHub

  • Ein neues Thema, das eines der drei alten Themen ersetzt, wenn Sie die Topics API nach vier Wochen Beobachtung aufrufen.

  • Wenn für den Nutzer in den letzten drei Wochen oder länger keine Themen beobachtet wurden, gibt die Topics API wieder ein leeres Array [] zurück.

Leistungsmesswerte erfassen, um die Nutzerfreundlichkeit zu bewerten:

  • Die Laufzeit der JavaScript-Aufrufe der Topics API in einem ursprungsübergreifenden iFrame sollte gemessen werden, um sie in zukünftigen Leistungsanalysen zu verwenden.
  • Die Zeit, die zum Erstellen eines iFrames und von postMessage()-Themen benötigt wird, nachdem die Themen empfangen wurden.

Informationen zur Fehlerbehebung finden Sie im Abschnitt Support.

Für die Produktion skalieren

Sie sollten Topics zu diesem Zeitpunkt in einer kontrollierten Umgebung (auf einigen Ihrer Websites) getestet haben. Wenn alles wie erwartet funktioniert, können Sie die Implementierung skalieren. Derselbe Code kann auf mehreren Zielwebsites bereitgestellt werden. So können Sie mehr Nutzer beobachten, mehr Daten zu Themen erheben und Ihre Zielgruppen besser verstehen.

Hier finden Sie eine Schritt-für-Schritt-Zusammenfassung, wie Sie die Produktion skalieren können:

  1. Testen Sie Ihre themenbasierte Lösung mit einem höheren Traffic-Volumen.
    • Fügen Sie das iFrame auf weiteren Websites ein, die Ihnen gehören und eine höhere Anzahl von Besuchen aufweisen, und führen Sie dann Lastentests durch.
  2. Stellen Sie Ihre Lösung auf den Websites von Publishern bereit.
    • Wenn Ihre Lösung in Ihrer eigenen Testumgebung richtig funktioniert, arbeiten Sie mit Publishern zusammen, um Ihr iFrame in ihre Websites einzubinden. Möglicherweise müssen sie die Bibliothek aktualisieren, die Ihr iFrame enthält.
  3. Themendaten verarbeiten und verwenden (geschätzte Dauer: etwa vier Wochen).
    • Themenbezogene Daten als zusätzliches Signal neben anderen Daten einbeziehen.
    • Suchen Sie nach Partnern für Echtzeitgebote-Tests.
    • Führen Sie Utility-Tests mit Themen als zusätzlichem Signal zu Ihren anderen Daten durch.

Lasttests

Damit Ihr System den Traffic verarbeiten kann, empfehlen wir, vor der Bereitstellung Ihrer themenbasierten Lösung auf den Websites von Publishern Lasttests durchzuführen.

  1. Führen Sie die Bereitstellung schrittweise auf weiteren Zielwebsites durch, die Ihnen gehören, insbesondere auf Websites mit hohem Traffic.
  2. Führen Sie Lasttests für Ihre Themen-Daten entsprechend dem erwarteten Traffic durch.
    • Sie müssen Themeninformationen aus dem iFrame an Ihr Backend senden. So können Sie die Ergebnisse der Topics API weiter verarbeiten und als zusätzliches Signal verwenden, um Anzeigen auszuwählen, die für den Nutzer relevanter sind. Je mehr Websites Ihr Einbettungscode verwenden, desto mehr Aufrufe werden an Ihr Backend gesendet. Prüfen Sie, ob Ihr Backend eine große Anzahl von Aufrufen vom iFrame verarbeiten kann.
    • Messwerterfassung und Logs für die Analyse einrichten
  3. Prüfen Sie die Messwerte unmittelbar nach der Bereitstellung der Topics API, um schwerwiegende Probleme für Endnutzer zu erkennen. Prüfen Sie Ihre Messwerte regelmäßig.
  4. Bei Störungen oder unerwartetem Verhalten machen Sie die Bereitstellung rückgängig und analysieren Sie Ihre Logs, um das Problem zu verstehen und zu beheben.

Weitere Informationen

In unseren Ressourcen finden Sie weitere Informationen zur Topics API im Web.