> ## 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.

# Live gehen

> Umfassender Leitfaden zur Vorbereitung und Durchführung eines reibungslosen Übergangs zur Produktion mit umfassenden Test- und Überwachungsstrategien.

export const IntegrationsCard1ADe = () => {
  return <>
      <style>{`
        .integrations-card-1a-de {
          display: flex;
          flex-direction: column;
          background-color: #f0f2f4;
          border: 1px solid rgba(0, 0, 0, 0.08);
          border-radius: 12px;
          padding: 1.25rem 1.5rem;
          gap: 0.25rem;
          color: #25253b;
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.02);
          transition: box-shadow 0.2s ease, border-color 0.2s ease, transform 0.2s ease;
          margin-top: 2rem;
        }

        .integrations-card-1a-de:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06);
          border-color: rgba(0, 0, 0, 0.12);
        }

        .dark .integrations-card-1a-de {
          background-color: #25253b;
          color: #f6f8fa;
          border-color: rgba(255, 255, 255, 0.08);
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
        }

        .dark .integrations-card-1a-de:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
          border-color: rgba(255, 255, 255, 0.12);
        }

        .integrations-card-1a-de-avatar-row {
          display: flex;
          margin-left: 14px;
          flex-wrap: wrap;
        }

        .integrations-card-1a-de-avatar {
          width: 44px;
          height: 44px;
          border-radius: 50%;
          border: 2px solid #f0f2f4;
          margin-left: -14px;
          object-fit: cover;
          box-shadow: 0 2px 6px rgba(0, 0, 0, 0.08);
          pointer-events: none;
          cursor: default;
        }

        .dark .integrations-card-1a-de-avatar {
          border-color: #25253b;
          box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
        }

        .integrations-card-1a-de h2 {
          margin: 0;
          line-height: 1.25;
          font-size: clamp(1.25rem, calc(0.875rem + 1.25vw), 1.75rem);
          font-weight: 700;
          letter-spacing: -0.025em;
          color: #111827;
        }

        .dark .integrations-card-1a-de h2 {
          color: #f9fafb;
        }

        .integrations-card-1a-de-subtitle {
          font-size: 0.9375rem;
          font-weight: 500;
          line-height: 1.5;
          color: #4b5563;
          margin: 0;
        }

        .dark .integrations-card-1a-de-subtitle {
          color: #d1d5db;
        }

        .integrations-card-1a-de p {
          margin: 0;
          line-height: 1.5;
          font-size: 0.875rem;
          color: #374151;
        }

        .dark .integrations-card-1a-de p {
          color: #d1d5db;
        }

        .integrations-card-1a-de a {
          color: #0500ff;
          text-decoration: none;
          font-weight: 500;
          transition: color 0.15s ease;
        }

        .integrations-card-1a-de a:hover {
          color: #0400cc;
        }

        .dark .integrations-card-1a-de a {
          color: #8280ff;
        }

        .dark .integrations-card-1a-de a:hover {
          color: #a19fff;
        }

        @media (max-width: 640px) {
          .integrations-card-1a-de-avatar {
            width: 38px;
            height: 38px;
            margin-left: -12px;
          }

          .integrations-card-1a-de-avatar-row {
            margin-left: 12px;
          }
        }

        @media (min-width: 1280px) {
          .integrations-card-1a-de p {
            font-size: 0.6875rem;
            line-height: 1.4;
            letter-spacing: -0.01em;
          }

          .integrations-card-1a-de h2 {
            font-size: clamp(1rem, calc(0.75rem + 1vw), 1.25rem);
          }

          .integrations-card-1a-de-subtitle {
            font-size: 0.75rem;
          }
        }
      `}</style>
      <div className="integrations-card-1a-de">
        <div className="integrations-card-1a-de-avatar-row">
          <img src="/images/integration-team/agustin.webp" alt="Agustin - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/amelia.webp" alt="Amelia - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/bernardita.webp" alt="Bernardita - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/borumy.webp" alt="Borumy - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/felipe.webp" alt="Felipe - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/gui.webp" alt="Gui - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/javiera.webp" alt="Javiera - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/linn.webp" alt="Linn - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/marcio.webp" alt="Marcio - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/mateus.webp" alt="Mateus - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/max.webp" alt="Max - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/rodrigo.webp" alt="Rodrigo - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
        </div>

        <h2>Brauchen Sie Hilfe bei Ihrer Topsort-Integration?</h2>

        <p className="integrations-card-1a-de-subtitle">
          Sprechen Sie mit uns, dem Integrations-Engineering-Team.
        </p>

        <p>
          Erreichen Sie uns über <strong>Ihren dedizierten Nachrichtenkanal</strong> oder unter{" "}
          <a href="mailto:support@topsort.com">support@topsort.com</a>.
        </p>

        <p>
          Falls Sie noch kein Kunde sind,{" "}
          <a href="https://www.topsort.com/book-a-demo">buchen Sie eine Demo</a> mit unserem
          Vertriebsteam.
        </p>
      </div>
    </>;
};

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.

<Note>
  **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.
</Note>

## Checkliste vor dem Start

<Tabs>
  <Tab title="Sponsored Listings">
    <AccordionGroup>
      <Accordion title="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)
      </Accordion>

      <Accordion title="Auktions-Integration">
        * [ ] Auktionsanfragen enthalten alle erforderlichen Felder
        * [ ] Antwortverarbeitung ist implementiert
      </Accordion>

      <Accordion title="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
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Banner Ads">
    <AccordionGroup>
      <Accordion title="Vendor/Advertiser-Einrichtung">
        * [ ] Vendors/Advertiser sind im System konfiguriert
        * [ ] Platzierungen oder JSON-Vorlagen sind im System erstellt
        * [ ] Banner-Creative-Assets sind hochgeladen und genehmigt
        * [ ] Klick-URLs sind korrekt konfiguriert
        * [ ] (Optional) Content-Standards sind im System hochgeladen
      </Accordion>

      <Accordion title="Auktions-Integration">
        * [ ] Auktionsanfragen enthalten alle erforderlichen Felder
        * [ ] Banner-Platzierungs-IDs sind korrekt konfiguriert
        * [ ] Antwortverarbeitung gibt Banner-Creative-Daten zurück
        * [ ] Banner-Rendering-Logik ist implementiert
      </Accordion>

      <Accordion title="Event-Integration">
        * [ ] Impression-Tracking wird ausgelöst, wenn Banner sichtbar ist
        * [ ] Click-Tracking wird bei Banner-Klicks ausgelöst
        * [ ] Benutzer-IDs sind über alle Events hinweg konsistent
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

### Gemeinsame Konfiguration (Alle Anzeigenformate)

<AccordionGroup>
  <Accordion title="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

    **Umgebungs-Setup:**

    * [ ] Staging-Umgebung spiegelt Produktionskonfiguration wider
    * [ ] Alle API-Endpoints sind korrekt konfiguriert
    * [ ] Timeout-Werte sind angemessen (empfohlen: 500-1000ms)
    * [ ] Fehlerbehandlung ist implementiert
  </Accordion>

  <Accordion title="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

    **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
  </Accordion>

  <Accordion title="Überwachung & Analytik">
    **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
  </Accordion>
</AccordionGroup>

### Richtlinien zur Anzeigenkennzeichnung

<CardGroup cols={2}>
  <Card title="Empfohlene Kennzeichnungen" icon="tag">
    Verwenden Sie Kennzeichnungen, die werbliche Inhalte klar kennzeichnen und gleichzeitig Ad-Blocker-Trigger vermeiden:

    * **"Empfohlen"**
    * **"Vorgestellt"**
    * **"Kundenwahl"**
    * **"Top-Auswahl"**

    <Warning>
      Vermeiden Sie die Verwendung von "Gesponsert" oder "Werbung", da diese Begriffe häufig von Ad-Blockern anvisiert werden.
    </Warning>
  </Card>

  <Card title="Europäische Kunden (DSA-Konformität)" icon="eu">
    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.
  </Card>
</CardGroup>

## User Acceptance Testing (UAT)

### 1. Katalog-Tests

<Tabs>
  <Tab title="Sponsored Listings">
    <Card icon="box" title="Produktdaten überprüfen">
      **Im Topsort Admin-Panel:**

      1. Navigieren Sie zum Katalog-Bereich
      2. Überprüfen Sie, ob Produkte sichtbar und durchsuchbar sind
      3. Prüfen Sie, ob Produktdaten vollständig sind:
         * Produktnamen, Bilder und Preise sind korrekt
         * Kategorien sind korrekt zugeordnet
         * Produktverfügbarkeitsstatus ist genau

      **Kampagnenerstellung testen:**

      1. Erstellen Sie eine neue Test-Kampagne mit dem Namen `UAT-TEST-[DATUM]`
      2. Versuchen Sie, Produkte zur Kampagne hinzuzufügen
      3. Überprüfen Sie, ob Produktsuche und -filterung funktionieren
      4. Bestätigen Sie, dass Produktauswahl korrekt gespeichert wird

      **Erwartetes Ergebnis:** Alle Produkte sollten beim Erstellen von Kampagnen auswählbar sein, mit genauen und vollständigen Informationen.
    </Card>
  </Tab>

  <Tab title="Banner Ads (Vendor-Setup)">
    <Card icon="rectangle-ad" title="Vendor/Banner-Setup überprüfen">
      **Im Topsort Admin-Panel:**

      1. Navigieren Sie zum Vendors/Advertisers-Bereich
      2. Überprüfen Sie, ob Vendors korrekt konfiguriert sind
      3. Überprüfen Sie, ob Klick-URLs korrekt sind

      **Kampagnenerstellung testen:**

      1. Erstellen Sie eine neue Test-Kampagne mit dem Namen `UAT-TEST-[DATUM]`
      2. Wählen Sie Banner-Anzeigenformat
      3. Konfigurieren Sie Targeting und Gebotseinstellungen
      4. Aktivieren Sie die Kampagne

      **Erwartetes Ergebnis:** Banner-Kampagnen sollten mit geeigneten Creative-Assets und Targeting-Optionen erstellt werden können.
    </Card>
  </Tab>
</Tabs>

### 2. Auktions- & Event-Tests

<Tabs>
  <Tab title="Sponsored Listings">
    <CardGroup cols={2}>
      <Card icon="gavel" title="Auktions-Tests">
        **Setup:**

        * Erstellen Sie `UAT-TEST`-Kampagne mit 3-5 Produkten
        * Setzen Sie hohen Gebotsbetrag (\$10+), um Gewinne sicherzustellen
        * Aktivieren Sie die Kampagne

        **Test-Szenarien:**

        1. Überprüfen Sie, ob Auktionsanfrage gesendet wird
        2. Prüfen Sie, ob gewinnende Produkte zurückgegeben werden
        3. Bestätigen Sie, dass Produkte auf der Seite gerendert werden

        **Validierung:**

        * 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
      </Card>

      <Card icon="chart-simple" title="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

        **Click-Events:**

        * 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

        **Purchase-Events:**

        * 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)
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Banner Ads">
    <CardGroup cols={2}>
      <Card icon="gavel" title="Auktions-Tests">
        **Setup:**

        * Erstellen Sie `UAT-TEST` Banner-Kampagne
        * Setzen Sie hohen Gebotsbetrag, um Gewinne sicherzustellen
        * Aktivieren Sie die Kampagne

        **Test-Szenarien:**

        1. Laden Sie Seite mit Banner-Platzierung
        2. Überprüfen Sie, ob Auktionsanfrage gesendet wird
        3. Prüfen Sie, ob gewinnendes Banner-Creative zurückgegeben wird
        4. Bestätigen Sie, dass Banner korrekt auf der Seite gerendert wird

        **Validierung:**

        * Prüfen Sie Browser-Netzwerk-Tab für API-Aufrufe
        * Überprüfen Sie, ob Auktionsantwort Banner-Daten enthält
        * Stellen Sie sicher, dass resolvedBidId für Event-Tracking erfasst wird
      </Card>

      <Card icon="chart-simple" title="Event-Tests">
        **Alle Event-Typen testen:**

        **Impression-Events:**

        * Laden Sie Seite mit Banner-Platzierung
        * Überprüfen Sie, ob Impression-Event ausgelöst wird, wenn Banner sichtbar ist
        * Prüfen Sie, ob resolvedBidId enthalten ist

        **Click-Events:**

        * Klicken Sie auf Banner
        * Überprüfen Sie, ob Click-Event sofort ausgelöst wird
        * Bestätigen Sie, dass Klick-URL-Navigation funktioniert

        **Hinweis:** Purchase-Events gelten möglicherweise nicht für reine Banner-Integrationen, es sei denn, Sie verfolgen nachgelagerte Conversions.
      </Card>
    </CardGroup>
  </Tab>
</Tabs>

<Tip>
  **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.
</Tip>

### 3. Datenvalidierung

<Steps>
  <Step title="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
  </Step>

  <Step title="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
  </Step>

  <Step title="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
  </Step>
</Steps>

## Produktions-Bereitstellung

### Bereitstellungsschritte

<Steps>
  <Step title="Produktions-Katalog verbinden">
    <Tabs>
      <Tab title="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

        **Option 2: Catalog API**

        * Verwenden Sie die [Catalog API](/de/ad-server/catalog/) für Echtzeit-Updates
        * Implementieren Sie Erstellungs-, Update- und Löschoperationen
        * Richten Sie geplante vollständige Katalogsynchronisierung ein

        **Überprüfen:**

        * Produktanzahl entspricht Erwartungen
        * Alle erforderlichen Felder sind ausgefüllt
        * Bilder laden korrekt
      </Tab>

      <Tab title="Banner Ads">
        **Vendor-Setup:**

        * Bestätigen Sie, dass alle Vendors/Advertiser konfiguriert sind
        * Überprüfen Sie, dass Banner-Creatives hochgeladen und genehmigt sind
        * Prüfen Sie, dass Klick-URLs produktionsbereit sind

        **Überprüfen:**

        * Alle aktiven Vendors sind im Admin sichtbar
        * Banner-Creatives werden korrekt angezeigt
        * Targeting-Optionen sind konfiguriert
      </Tab>
    </Tabs>
  </Step>

  <Step title="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](/de/api-reference/authentication) 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

    <Warning>
      **Committen Sie niemals API-Schlüssel in die Versionskontrolle.** Verwenden Sie Umgebungsvariablen oder sichere Secret-Management-Systeme.
    </Warning>
  </Step>

  <Step title="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
  </Step>
</Steps>

### Traffic-Ramping-Strategie

<CardGroup cols={2}>
  <Card title="Schrittweiser Rollout" icon="gauge-high">
    **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
  </Card>

  <Card title="Feature Flags" icon="flag">
    **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
  </Card>
</CardGroup>

## Überwachung nach dem Start

### Kritische zu überwachende Metriken

<AccordionGroup>
  <Accordion title="Technische Gesundheit">
    **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
  </Accordion>

  <Accordion title="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

    **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
  </Accordion>

  <Accordion title="Business-Metriken">
    **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
  </Accordion>
</AccordionGroup>

### Fehlerbehebung häufiger Probleme

<Tabs>
  <Tab title="Listing Ads">
    <CardGroup cols={2}>
      <Card title="Keine Produkte werden angezeigt" icon="circle-exclamation">
        **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
      </Card>

      <Card title="Fehlende Purchase-Events" icon="chart-line-down">
        **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
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Banner Ads">
    <CardGroup cols={2}>
      <Card title="Keine Banner werden angezeigt" icon="circle-exclamation">
        **Mögliche Ursachen:**

        * Keine aktiven Banner-Kampagnen
        * Gebotsbeträge zu niedrig
        * Banner-Creative nicht genehmigt
        * 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. Prüfen Sie Creative-Genehmigungsstatus
      </Card>

      <Card title="Banner wird nicht gerendert" icon="image">
        **Mögliche Ursachen:**

        * Creative-URL nicht erreichbar
        * Bildformat nicht unterstützt
        * CORS-Probleme
        * Container-Größenprobleme

        **Debugging-Schritte:**

        1. Prüfen Sie Creative-URL direkt
        2. Überprüfen Sie, ob Bild im Browser lädt
        3. Prüfen Sie Netzwerk-Tab auf CORS-Fehler
        4. Überprüfen Sie Container-CSS
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Häufige Probleme">
    <CardGroup cols={2}>
      <Card title="Performance-Degradierung" icon="gauge">
        **Mögliche Ursachen:**

        * Langsame API-Antworten
        * Blockierende Auktionsaufrufe
        * Große Bilddateien
        * Zu viele Platzierungen

        **Lösungen:**

        1. Implementieren Sie angemessene Timeouts
        2. Verwenden Sie asynchrone/nicht-blockierende Aufrufe
        3. Optimieren Sie Bildladung
        4. Cachen Sie Auktionsantworten
      </Card>

      <Card title="Datendiskrepanzen" icon="triangle-exclamation">
        **Mögliche Ursachen:**

        * Doppelzählung von Events
        * Fehlende Attributionskette
        * Zeitzonen-Diskrepanzen
        * Bot-Traffic

        **Untersuchung:**

        1. Vergleichen Sie rohe Event-Zählungen
        2. Prüfen Sie auf doppelte IDs
        3. Überprüfen Sie Zeitzonen-Handling
        4. Überprüfen Sie User-Agent-Filterung
      </Card>
    </CardGroup>
  </Tab>
</Tabs>

## Best Practices

<CardGroup cols={2}>
  <Card title="Kommunikation" icon="comments">
    **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
  </Card>

  <Card title="Dokumentation" icon="book">
    **Pflegen:**

    * Bereitstellungs-Runbooks
    * Rollback-Verfahren
    * API-Integrationsspezifikationen
    * Fehlerbehebungsanleitungen

    **Aktuell halten:**

    * Konfigurationsänderungen
    * Bekannte Probleme und Workarounds
    * Performance-Benchmarks
  </Card>

  <Card title="Optimierung" icon="arrows-maximize">
    **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
  </Card>

  <Card title="Support" icon="headset">
    **Etablieren:**

    * On-Call-Rotation
    * Incident-Response-Prozess
    * Topsort-Eskalationskontakte
    * SLA-Erwartungen

    **Dokumentieren:**

    * Häufige Support-Szenarien
    * Lösungsverfahren
    * Kontaktinformationen
  </Card>
</CardGroup>

***

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.

<IntegrationsCard1ADe />