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

# Sponsored Brands Auktionsanfragen und -antworten

export const LastUpdatedDe = ({date}) => {
  const label = "Zuletzt aktualisiert:";
  return <>
      <style>{`
        .last-updated-component {
          display: inline-flex;
          align-items: center;
          gap: 8px;
          padding: 10px 16px;
          border-radius: 8px;
          margin-top: 12px;
          margin-bottom: 16px;
          font-size: 14px;
          background-color: rgba(0, 0, 0, 0.05);
          border: 1px solid rgba(0, 0, 0, 0.12);
          color: rgba(0, 0, 0, 0.75);
          line-height: 1;
        }

        .last-updated-component svg {
          flex-shrink: 0;
          vertical-align: middle;
        }

        .last-updated-component span {
          display: inline-flex !important;
          align-items: center !important;
          line-height: 1 !important;
        }

        [data-theme="dark"] .last-updated-component {
          background-color: #3a3a3a;
          border: 2px solid #888888;
          color: #ffffff;
        }

        [data-theme="dark"] .last-updated-component svg {
          stroke: #ffffff;
        }
      `}</style>
      <div className="last-updated-component">
        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
          <circle cx="12" cy="12" r="10" />
          <polyline points="12 6 12 12 16 14" />
        </svg>
        <span>
          <strong style={{
    fontWeight: 600
  }}>{label}</strong> 
          <time dateTime={date}>{date}</time>
        </span>
      </div>
    </>;
};

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Sponsored Brands Auktionen funktionieren, indem Auktionsanfragen mit
  Platzierungsdetails und Targeting-Triggern gesendet werden und dann strukturierte Antworten mit
  gewinnenden Kampagnen mit allen notwendigen kreativen Elementen und Metadaten empfangen werden.
</div>

## Verfügbare Vorlagen

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Sponsored Brands Kampagnen werden mit einer der drei vorgefertigten Vorlagen erstellt:
</div>

* **Produktkollektion**: Mehrere Produkte auf einer Zielseite angezeigt für umfassende Produktentdeckung
* **Produkt-Spotlight**: Ein einzelnes Produkt und ein Kreativinhalt
* **Store-Schaufenster**: Leitet Traffic direkt zur Seite eines Verkäufer-Stores für Markenbewusstsein

## Auktionsanfrage

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Auktionsanfragen für Sponsored Brands folgen dem Standard-Auktionsformat mit
  spezifischen Triggern für Targeting und Unterstützung für standortbasiertes Filtern:
</div>

```json theme={null}
{
  "auctions": [
    {
      "winners": 2,
      "placementId": "some-placement",
      "triggers": {
        "products": {
          "ids": ["pmk_1", "pmk_8"]
        },
        "category": {
          "id": "electronics"
        },
        "searchQuery": "cool electronics"
      },
      "geoTargeting": "santiago",
      "opaqueUserId": "user-123"
    }
  ]
}
```

### Anfrageparameter

* **winners**: Anzahl der zurückzugebenden Sponsored Brands Kampagnen
* **placementId**: Bezeichner für die Sponsored Brands Platzierung
* **triggers**: Targeting-Kriterien unter Verwendung eines der folgenden:
  * **products.ids**: Array spezifischer Produkt-IDs zum Targeting
  * **category.id**: Produktkategorie für breiteres Targeting
  * **searchQuery**: Suchbegriffe für keyword-basiertes Targeting
* **geoTargeting**: Geografischer Standortbezeichner für standortbasiertes Kampagnenfiltern
* **opaqueUserId**: Anonymisierte Benutzer-ID für Personalisierung und erweitertes Targeting

### Geo-Targeting-Filterverhalten

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Das Auktionssystem filtert automatisch Kampagnen basierend auf Geo-Targeting:
</div>

* **Standortübereinstimmung**: Kampagnen mit spezifischen Geo-Targeting-Einstellungen nehmen nur teil, wenn das `geoTargeting`-Feld mit ihren konfigurierten Standorten übereinstimmt
* **Kein Geo-Targeting**: Kampagnen ohne Geo-Targeting-Einschränkungen nehmen unabhängig vom `geoTargeting`-Wert an allen Auktionen teil
* **Mehrere Standorte**: Kampagnen, die mehrere Standorte anvisieren, nehmen teil, wenn die Anfrage mit einem ihrer konfigurierten Standorte übereinstimmt
* **Rückwärtskompatibilität**: Bestehende Kampagnen ohne Geo-Targeting funktionieren weiterhin wie zuvor

## Auktionsantwort

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Die Auktionsantwort gibt gewinnende Sponsored Brands Kampagnen mit vollständigen
  kreativen Elementen und Metadaten zurück:
</div>

```json theme={null}
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "resolvedBidId": "ChAGc-G66Wt7LKQEOcW8VBdIEhABjz_zDXx7db-ZYpxiwJ3DGhABjr4Lt_J0_a7Xv_uIfyOXIgUKATEQATDrrg8",
          "productId": "pmk_1",
          "type": "url",
          "id": "www.topsort.com",
          "vendorId": "vendor_id",
          "content": {
            "headline": "Campaign Headline",
            "logo": "https://some.url.com/logo.jpeg"
          },
          "campaignId": "018f3ff3-0d7c-7b75-bf99-629c62c09dc3",
          "productIds": ["pmk_1", "pmk_4", "pmk_8"]
        }
      ],
      "error": false
    }
  ]
}
```

### Antwortfelder

#### Winner-Objekt

* **rank**: Positionsrang der gewinnenden Kampagne
* **resolvedBidId**: Eindeutige ID für Auktionsverfolgung und Zuordnung
* **productId**: Hauptprodukt-ID für die Kampagne
* **type**: Kampagnentyp (immer "product" für Sponsored Brands)
* **id**: Kampagnen-ID
* **title**: Kampagnentitel für Anzeigezwecke
* **campaignId**: UUID der Sponsored Brands Kampagne
* **productIds**: Array aller in der Kampagne enthaltenen Produkte (1-5 Produkte)

#### Assets-Array

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Kreative Elemente für das Rendering der Sponsored Brands Anzeige:
</div>

* **url**: CDN-URL für das Asset
* **role**: Asset-Typ ("image" für kreatives Banner, "logo" für Markenlogo)
* **contentType**: MIME-Typ des Assets
* **contentLength**: Dateigröße in Bytes
* **width/height**: Asset-Dimensionen in Pixeln

#### Content-Objekt

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Kampagneninhalt für Rendering:
</div>

* **headline**: Kampagnenüberschriftentext
* **brandName**: Marken- oder Verkäufername
* **creative1**: Zusätzliche kreative Asset-URL (Videos, sekundäre Bilder)

## Implementierungshinweise

### Rendering-Flexibilität

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Kreative Assets, Überschrift und productIds werden separat in der
  Auktionsantwort zurückgegeben, sodass Sie diese Elemente entsprechend Ihren
  Frontend-Design-Anforderungen rendern können. Das Assets-Array enthält alle notwendigen kreativen Komponenten
  mit klarer Rollenidentifikation.
</div>

### Multi-Produkt-Unterstützung

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Sponsored Brands Kampagnen können 1-5 Produkte gleichzeitig bewerben. Das
  `productIds`-Array enthält alle in der Kampagne enthaltenen Produkte, während
  `productId` das Hauptprodukt für Tracking-Zwecke darstellt.
</div>

### Vorlagenintegration

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Obwohl Kampagnen mit den verfügbaren Vorlagen erstellt werden (Produktkollektion,
  Produkt-Spotlight, Store-Schaufenster), liefert die Auktionsantwort alle
  notwendigen Assets und Inhalte unabhängig von der verwendeten Vorlage und gewährleistet
  konsistente Integration über alle Kampagnentypen hinweg.
</div>

### Inhaltsspezifikationen

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Alle kreativen Assets (Bilder und Videos), die für Sponsored Brands Kampagnen hochgeladen werden,
  müssen diese Anforderungen erfüllen:
</div>

* **Unterstützte Formate**: JPEG, PNG, WEBP, GIF, MP4
* **Maximale Dateigröße**: 5 MB pro Kreativinhalt/Video

***

<LastUpdatedDe date="2025-11-18" />