Themenbasierte Lösung testen, bereitstellen und skalieren

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

Topics-Backend-Implementierung

Die Back-End-Implementierung hängt davon ab, wie Sie die im Browser berechneten Themen verwenden möchten. Wir empfehlen, Topics als zusätzliches IBA-Signal bei AdTech-Lösungen zu 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 zusammen mit anderen Signalen wie URLs, Keywords oder anderen Metadaten als zusätzliches Signal zu Ihrer Zielgruppe betrachtet werden.

Wie im Abschnitt Anzeigenrelevanz nach Drittanbieter-Cookies maximieren erläutert, gibt es mehrere Möglichkeiten, mit Topics relevante Anzeigen auszuliefern. Bei einigen dieser Ansätze wird die Topics API genutzt, um Zielgruppen zu erstellen, und andere Ansätze empfehlen die Nutzung von Topics als Signal unter anderen, um Machine-Learning-Modelle zu trainieren, um zusätzliche Interessen der Zielgruppe abzuleiten oder sogar die Gebotslogik zu optimieren.

Erstellen und bereitstellen

  1. Themen erheben, indem Sie Nutzer in der Produktion beobachten (geschätzte Implementierungszeit: etwa eine Woche):
    • Informieren Sie sich über Ihre Möglichkeiten: Topics mit HTTP-Headern oder iFrame und JavaScript aufrufen
    • Definieren Sie die Domain des iFrames, der die Topics API aufruft.
    • Erstellen Sie Ihre Lösung mit header demo oder JavaScript demo als Codereferenz.
    • Binden Sie Topics in Ihren Code ein, den Publisher auf ihren Websites einbetten (z. B. Ihren Anzeigen-iFrame). Rufe Themen über den Einbettungscode auf.
    • Um mit der Beobachtung von Nutzerthemen zu beginnen, betten Sie die neueste Version Ihres Skripts auf Ihren Produktionswebsites ein. Wir empfehlen, die Implementierung zuerst auf Ihren eigenen Websites mit einer geringen Anzahl monatlicher Besuche zu testen. Zu diesem Zeitpunkt empfehlen wir, Ihre neue themenbasierte Lösung auf mindestens fünf Websites einzubetten.
    • An dieser Stelle sollte die API ein leeres Array zurückgeben. Das liegt daran, dass noch keine Themen für den Nutzer beobachtet wurden. Es kann bis zu drei Wochen dauern, bis Nutzerthemen angezeigt werden.
    • Führen Sie Funktionstests und Validierungen durch. Sie können Ihre Lösung manuell oder automatisch testen. Beispiel:
  2. Topics-Daten zusammen mit anderen Kontextsignalen (z. B. URLs, Metadaten usw.) verwenden (geschätzte Zeit: ca. 3 Tage).
    • Nach drei Wochen in der Produktion sollte Ihr Script die Themen einiger Nutzer beobachtet haben. Jetzt sollten Sie die Topics-Daten als zusätzliches Signal verwenden können.
    • Sobald Sie eine Liste mit Themen erhalten, die nicht leer ist, können Sie sie zusammen mit anderen Kontextsignalen an Ihr Backend senden.

Auf Zielwebsites bereitstellen

Nachdem Sie einen Topics-Aufruf in Ihr Script eingebunden haben, sollten Sie ihn für einen ersten Test in einige Produktionswebsites einbetten. Prüfen Sie, ob Ihre Implementierung wie erwartet funktioniert:

Zielwebsites auswählen

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

  • Die Website erhält eine geringe Anzahl von monatlichen Besuchen (weniger als eine Million pro Monat): Sie sollten die API zuerst für eine kleine Zielgruppe bereitstellen.
  • Sie sind Inhaber und Kontrolle der Website: Bei Bedarf können Sie die Implementierung ohne komplexe Genehmigungen schnell deaktivieren.
  • Die Website ist nicht geschäftskritisch: Beginnen Sie mit Zielwebsites mit niedrigem Risiko.
  • Maximal fünf Websites: Für den Anfang benötigen Sie nicht so viele Zugriffe oder so viel Aufmerksamkeit.
  • Die Zielwebsites repräsentieren unterschiedliche Themen: Wählen Sie Websites aus, die unterschiedliche Kategorien repräsentieren, z. B. eine zu Sport, eine weitere zu Nachrichten oder eine weitere zu Essen und Trinken. Mit dem internen Topics-Tool in Chrome können Sie Domains und ihre Klassifizierung durch den Topics-Klassifikator für maschinelles Lernen prüfen.

Funktionstests und Validierung

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

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

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

    • Ein Thema, das aus den fünf am häufigsten verwendeten Themen des Nutzers ausgewählt wurde, berechnet aus den Hostnamen der Seiten, auf denen der Anrufer in dieser Woche Themen beobachtet hat.

  • Genau die gleiche API-Antwort wie bei allen vorherigen Topics API-Aufrufen. Für denselben Aufrufer, denselben Nutzer und dieselbe Website auf oberster Ebene gibt die API für die gesamte Epoche dieselben Themen zurück. So wird vermieden, dass zu viele Interessen des Nutzers preisgegeben werden. Weitere Details auf GitHub

  • Ein neues Thema ersetzt eines der drei alten, wenn Sie Topics nach vier Wochen Beobachtung anrufen.

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

Erfassen Sie Leistungsmesswerte, um Ihre Nutzererfahrung zu bewerten:

  • Die Laufzeit der JavaScript-Aufrufe an die Topics API in einem ursprungsübergreifenden iFrame sollte zur zukünftigen Leistungsanalyse gemessen werden.
  • Die Zeit, die zum Erstellen eines iFrames und von postMessage() Themen benötigt wird, nachdem die Themen eingegangen sind.

Informationen zur Fehlerbehebung finden Sie im Abschnitt Support.

Auf Produktion skalieren

Sie sollten Topics in einer kontrollierten Umgebung (auf einigen Ihrer Websites) getestet haben. Wenn alles wie erwartet funktioniert, ist es an der Zeit, diese Implementierung zu skalieren. Sie können denselben Code auf mehreren Zielwebsites bereitstellen. So können Sie mehr Nutzer beobachten, mehr Themendaten erfassen und Ihre Zielgruppen besser verstehen.

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

  1. Testen Sie Ihre themenbasierte Lösung an einem höheren Trafficvolumen.
    • Fügen Sie den iFrame auf weiteren Websites hinzu, die Sie mit einer größeren Anzahl von Besuchen besitzen. Folgen Sie dann der Anleitung unten, um Belastungstests durchzuführen.
  2. Ihre Lösung auf den Websites der Publisher bereitstellen.
    • Sobald Ihre Lösung in Ihrer eigenen Testumgebung ordnungsgemäß funktioniert, können Sie mit den Publishern zusammenarbeiten, um Ihren iFrame in deren Websites zu integrieren. Er muss beispielsweise die Bibliothek aktualisieren, die Ihren iFrame enthält.
  3. Themendaten verarbeiten und verwenden (geschätzte Zeit: etwa vier Wochen).
    • Binden Sie Themendaten als zusätzliches Signal zusammen mit anderen Daten ein.
    • Partner für Echtzeitgebote finden
    • Führen Sie Nutzwerttests mit Themen als zusätzliches Signal zu Ihren anderen Daten durch.

Lasttests

Damit Ihr System den Traffic verarbeiten kann, sollten Sie Lasttests durchführen, bevor Sie die themenbasierte Lösung für Publisher Websites.

  1. Implementieren Sie die Funktion nach und nach auf mehr eigenen Zielwebsites, insbesondere auf solchen mit einem höheren Trafficvolumen.
  2. Führen Sie Belastungstests für Ihre Themendaten entsprechend dem erwarteten Traffic durch.
    • Sie müssen Themeninformationen von dem iFrame an Ihr Back-End 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 Ihre Einbettung verwenden, desto mehr Aufrufe erhalten Ihr Backend. Prüfen Sie, ob Ihr Backend eine große Anzahl von Aufrufen über den Iframe verarbeiten kann.
    • Messwerterfassung und Protokolle für die Analyse einrichten
  3. Prüfen Sie sofort nach der Bereitstellung der Topics API Ihre Messwerte, um schwerwiegende Endnutzerprobleme zu erkennen. Überprüfen Sie Ihre Messwerte regelmäßig.
  4. Bei einer Unterbrechung oder unerwartetem Verhalten führen Sie ein Rollback der Bereitstellung durch und analysieren Ihre Logs, um das Problem zu verstehen und zu beheben.

Weitere Informationen

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