Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.topsort.com/llms.txt

Use this file to discover all available pages before exploring further.

Führen Sie vor dem Wechsel zur Produktion gründliche User Acceptance Tests (UAT) durch, um einen reibungslosen Übergang zu gewährleisten. Dieser Leitfaden führt Sie durch die Vorbereitungen vor dem Start, Testverfahren, Bereitstellungsschritte und Überwachung nach dem Start.
Ihr Go-Live-Prozess kann variieren je nach Ihrem Integrationspfad und Anzeigenformaten. Dieser Leitfaden deckt die häufigsten Szenarien ab, aber Ihre spezifische Implementierung kann abweichen. Zum Beispiel:
  • Sponsored Listings erfordern vollständige Katalogintegration mit Produktdaten
  • Banner Ads benötigen möglicherweise nur Vendor-/Advertiser-Setup ohne produktebenen Katalog
  • Platzierungskonfigurationen variieren je nach Ihren Anzeigenformat-Auswahlmöglichkeiten
Arbeiten Sie mit Ihrem Topsort-Kontakt zusammen, um zu bestätigen, welche Abschnitte auf Ihre Integration zutreffen.

​
Checkliste vor dem Start

​
Gemeinsame Konfiguration (Alle Anzeigenformate)

API-Zugangsdaten:
  • Sandbox-API-Schlüssel sind korrekt konfiguriert
  • Produktions-API-Schlüssel sind bereit (noch nicht wechseln)
  • API-Schlüssel sind sicher in Umgebungsvariablen gespeichert
  • Schlüsselrotationsprozess ist dokumentiert
Umgebungs-Setup:
  • Staging-Umgebung spiegelt Produktionskonfiguration wider
  • Alle API-Endpoints sind korrekt konfiguriert
  • Timeout-Werte sind angemessen (empfohlen: 500-1000ms)
  • Fehlerbehandlung ist implementiert
Anzeigendarstellung:
  • Anzeigenplatzierungen werden auf allen Gerätetypen korrekt gerendert
  • Anzeigenkennzeichnungen sind deutlich sichtbar (siehe Kennzeichnungsrichtlinien unten)
  • Anzeigenbilder/-creatives laden korrekt mit Fallbacks
  • Klick-Verhalten funktioniert wie erwartet
Leistung:
  • Seitenladezeiten sind mit Anzeigen akzeptabel
  • Anzeigen blockieren nicht das kritische Seiten-Rendering
  • Mobile-Erfahrung ist optimiert (Touch-Ziele, responsive Layouts, schnelle Ladezeiten)
  • Barrierefreiheitsanforderungen sind erfüllt
Instrumentierung:
  • Error-Tracking ist konfiguriert (Sentry, Datadog, etc.)
  • Performance-Monitoring ist eingerichtet
  • Benutzerdefinierte Dashboards sind eingerichtet
  • Alarm-Schwellenwerte sind definiert
Protokollierung:
  • API-Request/Response-Protokollierung ist aktiviert
  • Fehlerprotokolle werden erfasst
  • Audit-Trail für Anzeigen-Events ist konfiguriert
  • Log-Retention-Richtlinien sind festgelegt

​
Richtlinien zur Anzeigenkennzeichnung

Empfohlene Kennzeichnungen

Verwenden Sie Kennzeichnungen, die werbliche Inhalte klar kennzeichnen und gleichzeitig Ad-Blocker-Trigger vermeiden:
  • “Empfohlen”
  • “Vorgestellt”
  • “Kundenwahl”
  • “Top-Auswahl”
Vermeiden Sie die Verwendung von “Gesponsert” oder “Werbung”, da diese Begriffe häufig von Ad-Blockern anvisiert werden.

Europäische Kunden (DSA-Konformität)

Wenn Sie in der Europäischen Union tätig sind, verlangt das Gesetz über digitale Dienste (DSA):
  • Klare Kennzeichnung, dass der Inhalt eine Anzeige ist
  • Anzeige des Advertiser-Namens in den Anzeigendetails
  • Transparenz darüber, warum die Anzeige dem Nutzer gezeigt wurde
Arbeiten Sie mit Ihrem Rechtsteam zusammen, um vollständige DSA-Konformität sicherzustellen.

​
User Acceptance Testing (UAT)

​
1. Katalog-Tests

​
2. Auktions- & Event-Tests

Mit zwei verschiedenen Benutzern testen: Führen Sie alle Tests mit mindestens zwei eindeutigen Benutzersitzungen durch, um ordnungsgemäßes Benutzer-Tracking und Attribution zu überprüfen.

​
3. Datenvalidierung

1

Testnachweis erfassen

Für jeden Testbenutzer:
  • Machen Sie Screenshots von Anzeigenplatzierungen
  • Erfassen Sie Netzwerkanfragen, die API-Aufrufe zeigen
  • Dokumentieren Sie Bestelldetails für Purchase-Events (falls zutreffend)
  • Notieren Sie Zeitstempel für jede Aktion
2

An Topsort senden

Senden Sie Folgendes an Ihren Topsort-Kontakt:
  • Screenshots von Anzeigen-Impressionen
  • Netzwerk-Logs, die Auktions- und Event-Aufrufe zeigen
  • Test-Kampagnenname und Zeitraum
  • In Tests verwendete Benutzeridentifikatoren
3

Datenzusammenfassung überprüfen

Topsort stellt eine Zusammenfassung bereit, die Folgendes enthält:
  • Insgesamt empfangene Auktionen
  • Impression- und Click-Zählungen
  • Purchase-Zählungen (für Listing-Anzeigen-Integrationen)
  • Datenqualitätsscore
  • Eventuelle Datendiskrepanzen oder -probleme
Abstimmung überprüfen:
  • Zahlen stimmen mit Ihren Testaktionen überein
  • Attributionskette ist vollständig
  • Keine fehlenden oder doppelten Events

​
Produktions-Bereitstellung

​
Bereitstellungsschritte

1

Produktions-Katalog verbinden

2

Produktions-Zugangsdaten erhalten

Verwendung von Topsort UI:
  1. Topsort stellt Admin-Panel-Anmeldeinformationen bereit
  2. Sie erhalten Produktions-API-URL
  3. Generieren Sie API-Schlüssel im Admin
  4. Speichern Sie Schlüssel sicher in Produktionsumgebung
Verwendung einer Custom UI:
  1. Erhalten Sie Produktions-API-URL von Topsort
  2. Erhalten Sie Produktions-API-Schlüssel
  3. Konfigurieren Sie Schlüssel in Ihrer Umgebung
Committen Sie niemals API-Schlüssel in die Versionskontrolle. Verwenden Sie Umgebungsvariablen oder sichere Secret-Management-Systeme.
3

Integrations-Code bereitstellen

Vor der Bereitstellung:
  • Überprüfen Sie alle Code-Änderungen ein letztes Mal
  • Stellen Sie sicher, dass Sandbox-Anmeldeinformationen parametrisiert sind
  • Bestätigen Sie, dass Rollback-Verfahren dokumentiert ist
  • Planen Sie Bereitstellung während verkehrsschwacher Zeit
Bereitstellungsprozess:
  1. Stellen Sie Code in Produktionsumgebung bereit
  2. Aktualisieren Sie Umgebungsvariablen mit Produktions-Anmeldeinformationen
  3. Starten Sie Dienste neu, um neue Konfiguration zu übernehmen
  4. Überprüfen Sie, ob Anwendung erfolgreich startet
Sofortige Überprüfung:
  • Prüfen Sie Anwendungsprotokolle auf Fehler
  • Testen Sie grundlegende Funktionalität (Seitenladevorgänge)
  • Überprüfen Sie API-Konnektivität

​
Traffic-Ramping-Strategie

Schrittweiser Rollout

Empfohlener Ansatz:Tag 1-2: 10% des Traffics
  • Überwachen Sie genau auf Fehler
  • Validieren Sie Datengenauigkeit
  • Prüfen Sie Performance-Metriken
Tag 3-5: 50% des Traffics
  • Vergleichen Sie Metriken mit Baseline
  • Stellen Sie Systemstabilität sicher
  • Feinabstimmung bei Bedarf
Tag 6+: 100% des Traffics
  • Vollständiger Produktionsstart
  • Überwachung fortsetzen
  • Performance optimieren

Feature Flags

Feature Flags verwenden zur Steuerung:
  • Welche Platzierungen Anzeigen zeigen
  • Prozentsatz der Nutzer, die Anzeigen sehen
  • A/B-Test-Konfigurationen
  • Notfall-Kill-Switch
Vorteile:
  • Sofortiger Rollback ohne Bereitstellung
  • Schrittweise Rollout-Kontrolle
  • Platzierungsspezifische Konfiguration
  • Reduziertes Bereitstellungsrisiko

​
Überwachung nach dem Start

​
Kritische zu überwachende Metriken

API-Leistung:
  • Auction API Antwortzeit (Ziel: <500ms p95)
  • Event API Erfolgsrate (Ziel: >99.5%)
  • Fehlerraten und -typen
  • API-Timeout-Häufigkeit
Anwendungs-Leistung:
  • Auswirkung auf Seitenladezeit
  • Zeit bis zur ersten Anzeigen-Darstellung
  • JavaScript-Fehler
  • Speichernutzungsmuster
Maßnahmen bei erkannten Problemen:
  • Antwortzeit >1s: Timeout-Einstellungen überprüfen
  • Fehlerrate >1%: API-Anmeldeinformationen und Netzwerk prüfen
  • Hohe JS-Fehler: Client-seitige Implementierung überprüfen
Event-Tracking:
  • Impression-zu-Click-Verhältnis (typisch: 1-5%)
  • Click-zu-Purchase-Verhältnis (typisch: 2-10%, für Listing-Anzeigen)
  • Event-Volumen-Konsistenz
  • Attributions-Vollständigkeit
Datenintegrität:
  • Benutzer-IDs sind vorhanden und konsistent
  • resolvedBidIds werden für Impressions und Clicks erfasst
  • Purchase-Beträge sind angemessen (Listing-Anzeigen)
  • Doppelte Events sind minimal
Dashboard-Checks:
  • Vergleichen Sie Topsort-Dashboard mit Ihren Analytics
  • Überprüfen Sie, ob Umsatzzuordnung übereinstimmt
  • Prüfen Sie auf Datenlücken oder -spitzen
Kampagnen-Leistung:
  • Insgesamt ausgelieferte Impressions
  • Click-Through-Rate (CTR)
  • Conversion-Rate (Listing-Anzeigen)
  • Return on Ad Spend (ROAS)
Nutzererfahrung:
  • Anzeigen-Sichtbarkeitsraten
  • Nutzerengagement mit Anzeigen
  • Auswirkung auf organische Conversion-Rate
  • Änderungen der Seiten-Bounce-Rate
Umsatzauswirkung:
  • Inkrementeller Umsatz aus Anzeigen
  • Änderungen des durchschnittlichen Bestellwerts
  • Vendor-Adoptionsrate
  • Kampagnenerstellungsgeschwindigkeit

​
Fehlerbehebung häufiger Probleme

Keine Produkte werden angezeigt

Mögliche Ursachen:
  • Keine aktiven Kampagnen
  • Gebotsbeträge zu niedrig
  • Produkt-Targeting zu eng
  • Auction API Fehler
Debugging-Schritte:
  1. Prüfen Sie Browser-Konsole auf Fehler
  2. Überprüfen Sie Auction API Antwort
  3. Bestätigen Sie, dass Kampagnen aktiv sind
  4. Überprüfen Sie Targeting-Kriterien

Fehlende Purchase-Events

Mögliche Ursachen:
  • Event nicht beim Checkout ausgelöst
  • Fehlende Benutzer-ID im Event-Payload
  • Falsches Produkt-ID-Format
  • Netzwerkfehler
Debugging-Schritte:
  1. Testen Sie Purchase-Flow manuell
  2. Prüfen Sie Event-Payload-Struktur
  3. Überprüfen Sie, ob Benutzer-ID enthalten ist
  4. Überprüfen Sie Server-Logs

​
Best Practices

Kommunikation

Interne Koordination:
  • Benachrichtigen Sie Engineering-Team über Bereitstellung
  • Informieren Sie Kundensupport über neue Features
  • Aktualisieren Sie Vertriebsteam über Funktionen
Externe Kommunikation:
  • Koordinieren Sie mit Topsort-Team
  • Planen Sie Launch-Calls
  • Etablieren Sie Eskalationswege

Dokumentation

Pflegen:
  • Bereitstellungs-Runbooks
  • Rollback-Verfahren
  • API-Integrationsspezifikationen
  • Fehlerbehebungsanleitungen
Aktuell halten:
  • Konfigurationsänderungen
  • Bekannte Probleme und Workarounds
  • Performance-Benchmarks

Optimierung

Kontinuierliche Verbesserung:
  • Überprüfen Sie Performance wöchentlich
  • Optimieren Sie langsame Abfragen
  • Verfeinern Sie Targeting
  • Testen Sie neue Platzierungen
A/B-Testing:
  • Anzeigenplatzierungs-Positionen
  • Anzahl der Anzeigen pro Seite
  • Anzeigenformate und -stile
  • Targeting-Strategien

Support

Etablieren:
  • On-Call-Rotation
  • Incident-Response-Prozess
  • Topsort-Eskalationskontakte
  • SLA-Erwartungen
Dokumentieren:
  • Häufige Support-Szenarien
  • Lösungsverfahren
  • Kontaktinformationen
Sobald Sie live sind, können Sie mit der Optimierung beginnen. Wenden Sie sich an Ihren Topsort-Kontakt für Anleitungen zu Kampagnenstrategien, Attributions-Tuning und erweiterten Konfigurationen.