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
Checkliste vor dem Start
- Sponsored Listings
Katalog-Integration
Katalog-Integration
- Produkt-Feed ist verbunden und wird regelmäßig aktualisiert
- Alle Produktattribute (ID, Name, Preis, Bild, Kategorie) sind ausgefüllt
- Produktverfügbarkeit ist genau
- Kategorie-Taxonomie ist korrekt zugeordnet (basierend auf Ihrer vereinbarten Taxonomiestruktur)
Auktions-Integration
Auktions-Integration
- Auktionsanfragen enthalten alle erforderlichen Felder
- Antwortverarbeitung ist implementiert
Event-Integration
Event-Integration
- Impression-Tracking wird ausgelöst, wenn gesponserte Produkte sichtbar sind
- Click-Tracking wird bei Produktklicks ausgelöst (einschließlich “In den Warenkorb” falls zutreffend)
- Purchase-Events enthalten alle Bestelldetails
- Benutzer-IDs sind über alle Events hinweg konsistent
Gemeinsame Konfiguration (Alle Anzeigenformate)
Umgebungskonfiguration
Umgebungskonfiguration
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
- Staging-Umgebung spiegelt Produktionskonfiguration wider
- Alle API-Endpoints sind korrekt konfiguriert
- Timeout-Werte sind angemessen (empfohlen: 500-1000ms)
- Fehlerbehandlung ist implementiert
UI/UX-Überprüfung
UI/UX-Überprüfung
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
- 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
Überwachung & Analytik
Überwachung & Analytik
Instrumentierung:
- Error-Tracking ist konfiguriert (Sentry, Datadog, etc.)
- Performance-Monitoring ist eingerichtet
- Benutzerdefinierte Dashboards sind eingerichtet
- Alarm-Schwellenwerte sind definiert
- 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”
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
User Acceptance Testing (UAT)
1. Katalog-Tests
- Sponsored Listings
Produktdaten überprüfen
Im Topsort Admin-Panel:
- Navigieren Sie zum Katalog-Bereich
- Überprüfen Sie, ob Produkte sichtbar und durchsuchbar sind
- Prüfen Sie, ob Produktdaten vollständig sind:
- Produktnamen, Bilder und Preise sind korrekt
- Kategorien sind korrekt zugeordnet
- Produktverfügbarkeitsstatus ist genau
- Erstellen Sie eine neue Test-Kampagne mit dem Namen
UAT-TEST-[DATUM] - Versuchen Sie, Produkte zur Kampagne hinzuzufügen
- Überprüfen Sie, ob Produktsuche und -filterung funktionieren
- Bestätigen Sie, dass Produktauswahl korrekt gespeichert wird
2. Auktions- & Event-Tests
- Sponsored Listings
Auktions-Tests
Setup:
- Erstellen Sie
UAT-TEST-Kampagne mit 3-5 Produkten - Setzen Sie hohen Gebotsbetrag ($10+), um Gewinne sicherzustellen
- Aktivieren Sie die Kampagne
- Überprüfen Sie, ob Auktionsanfrage gesendet wird
- Prüfen Sie, ob gewinnende Produkte zurückgegeben werden
- Bestätigen Sie, dass Produkte auf der Seite gerendert werden
- Prüfen Sie Browser-Netzwerk-Tab für API-Aufrufe
- Überprüfen Sie, ob Auktionsantwort Produkte enthält
- Stellen Sie sicher, dass resolvedBidId für Event-Tracking erfasst wird
Event-Tests
Alle Event-Typen testen:Impression-Events:
- Laden Sie Seite mit gesponserten Produkten
- Überprüfen Sie, ob Impression-Event ausgelöst wird, wenn Anzeige sichtbar ist
- Prüfen Sie, ob resolvedBidId enthalten ist
- Klicken Sie auf gesponsertes Produkt
- Überprüfen Sie, ob Click-Event sofort ausgelöst wird
- Hinweis: “In den Warenkorb”-Aktionen zählen auch als Klicks, wenn konfiguriert
- Bestätigen Sie, dass Navigation/Aktion korrekt funktioniert
- Schließen Sie einen Kauf mit gesponsertem Produkt ab
- Überprüfen Sie, ob Purchase-Event enthält:
- Produkt-ID und Menge
- Bestellwert und Bestell-ID
- Benutzer-ID (erforderlich für Attribution)
3. Datenvalidierung
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
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
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
- Zahlen stimmen mit Ihren Testaktionen überein
- Attributionskette ist vollständig
- Keine fehlenden oder doppelten Events
Produktions-Bereitstellung
Bereitstellungsschritte
Produktions-Katalog verbinden
- Sponsored Listings
Option 1: Produkt-Feed
- Teilen Sie Ihre Produktions-Feed-URL mit Topsort
- Stellen Sie sicher, dass Feed zugänglich ist und regelmäßig aktualisiert wird
- Empfohlene Update-Frequenz: Alle 15-60 Minuten
- Verwenden Sie die Catalog API für Echtzeit-Updates
- Implementieren Sie Erstellungs-, Update- und Löschoperationen
- Richten Sie geplante vollständige Katalogsynchronisierung ein
- Produktanzahl entspricht Erwartungen
- Alle erforderlichen Felder sind ausgefüllt
- Bilder laden korrekt
Produktions-Zugangsdaten erhalten
Verwendung von Topsort UI:
- Topsort stellt Admin-Panel-Anmeldeinformationen bereit
- Sie erhalten Produktions-API-URL
- Generieren Sie API-Schlüssel im Admin
- Speichern Sie Schlüssel sicher in Produktionsumgebung
- Erhalten Sie Produktions-API-URL von Topsort
- Erhalten Sie Produktions-API-Schlüssel
- Konfigurieren Sie Schlüssel in Ihrer Umgebung
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
- Stellen Sie Code in Produktionsumgebung bereit
- Aktualisieren Sie Umgebungsvariablen mit Produktions-Anmeldeinformationen
- Starten Sie Dienste neu, um neue Konfiguration zu übernehmen
- Überprüfen Sie, ob Anwendung erfolgreich startet
- 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
- Vergleichen Sie Metriken mit Baseline
- Stellen Sie Systemstabilität sicher
- Feinabstimmung bei Bedarf
- 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
- Sofortiger Rollback ohne Bereitstellung
- Schrittweise Rollout-Kontrolle
- Platzierungsspezifische Konfiguration
- Reduziertes Bereitstellungsrisiko
Überwachung nach dem Start
Kritische zu überwachende Metriken
Technische Gesundheit
Technische Gesundheit
API-Leistung:
- Auction API Antwortzeit (Ziel: <500ms p95)
- Event API Erfolgsrate (Ziel: >99.5%)
- Fehlerraten und -typen
- API-Timeout-Häufigkeit
- Auswirkung auf Seitenladezeit
- Zeit bis zur ersten Anzeigen-Darstellung
- JavaScript-Fehler
- Speichernutzungsmuster
- Antwortzeit >1s: Timeout-Einstellungen überprüfen
- Fehlerrate >1%: API-Anmeldeinformationen und Netzwerk prüfen
- Hohe JS-Fehler: Client-seitige Implementierung überprüfen
Datenqualität
Datenqualität
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
- 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
- Vergleichen Sie Topsort-Dashboard mit Ihren Analytics
- Überprüfen Sie, ob Umsatzzuordnung übereinstimmt
- Prüfen Sie auf Datenlücken oder -spitzen
Business-Metriken
Business-Metriken
Kampagnen-Leistung:
- Insgesamt ausgelieferte Impressions
- Click-Through-Rate (CTR)
- Conversion-Rate (Listing-Anzeigen)
- Return on Ad Spend (ROAS)
- Anzeigen-Sichtbarkeitsraten
- Nutzerengagement mit Anzeigen
- Auswirkung auf organische Conversion-Rate
- Änderungen der Seiten-Bounce-Rate
- Inkrementeller Umsatz aus Anzeigen
- Änderungen des durchschnittlichen Bestellwerts
- Vendor-Adoptionsrate
- Kampagnenerstellungsgeschwindigkeit
Fehlerbehebung häufiger Probleme
- Listing Ads
- Häufige Probleme
Keine Produkte werden angezeigt
Mögliche Ursachen:
- Keine aktiven Kampagnen
- Gebotsbeträge zu niedrig
- Produkt-Targeting zu eng
- Auction API Fehler
- Prüfen Sie Browser-Konsole auf Fehler
- Überprüfen Sie Auction API Antwort
- Bestätigen Sie, dass Kampagnen aktiv sind
- Ü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
- Testen Sie Purchase-Flow manuell
- Prüfen Sie Event-Payload-Struktur
- Überprüfen Sie, ob Benutzer-ID enthalten ist
- Ü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
- Koordinieren Sie mit Topsort-Team
- Planen Sie Launch-Calls
- Etablieren Sie Eskalationswege
Dokumentation
Pflegen:
- Bereitstellungs-Runbooks
- Rollback-Verfahren
- API-Integrationsspezifikationen
- Fehlerbehebungsanleitungen
- 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
- Anzeigenplatzierungs-Positionen
- Anzahl der Anzeigen pro Seite
- Anzeigenformate und -stile
- Targeting-Strategien
Support
Etablieren:
- On-Call-Rotation
- Incident-Response-Prozess
- Topsort-Eskalationskontakte
- SLA-Erwartungen
- 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.
