Skip to main content
Die Sponsored Brand Auction API ermöglicht es Ihnen, Auktionen durchzuführen, um Marken mit Assets, Text und zugehörigen Produkten zu bewerben.

Bevor Sie beginnen

Um die Sponsored Brand Auction API zu verwenden, stellen Sie sicher, dass Sie die folgenden Schritte abgeschlossen haben:
  1. Einen API-Schlüssel erhalten zur Authentifizierung.
  2. Mehrere Kampagnen erstellen, um Gebote für Auktionen verfügbar zu haben.

Anfrage

Der /auctions/sponsored-brand Endpoint ermöglicht es Ihnen, Auktionen für Sponsored Brand-Platzierungen durchzuführen. Die vollständige Spezifikation für diesen Endpoint finden Sie in der API-Dokumentation.

Beispielanfrage

Beispielanfrage mit Geo-Targeting

Wichtige Felder:

  • auctions: Ein Array mit Auktionsobjekten.
  • winners: Die maximale Anzahl von Gewinnern für die Auktion.
  • placementId: Die ID der Platzierung, wo die Anzeige erscheinen wird.
  • triggers: Targeting-Kriterien einschließlich:
    • products.ids: Ein Array von Produkt-IDs, die mit der Auktion verbunden sind.
    • searchQuery: Suchbegriffe für Keyword-basiertes Targeting.
    • category.id: Produktkategorie für breiteres Targeting.
  • geoTargeting: (Optional) Geografischer Standortidentifikator für standortbasierte Kampagnenfilterung.
  • opaqueUserId: (Optional) Anonymer Benutzeridentifikator für erweiterte Personalisierung und Targeting.

Antwort

Diese Antwort nicht cachen oder ihre Ergebnisse. Auktionen müssen pro Seitenaufruf eindeutig bleiben, um eine ordnungsgemäße Funktion zu gewährleisten.Das Caching kann dazu führen, dass wiederholte Ergebnisse für mehrere Benutzer oder Sitzungen angezeigt werden.
Wenn kein Anfragefehler auftritt, gibt der Endpoint die Auktionsergebnisse zurück.

Antwort mit Gewinnern

Beispielantwort, wenn Gewinner gefunden werden:

Deklarationen KI-generierter Assets

content.aiGeneratedAssets ist ein optionales Array mit den URLs von Bild-Assets, die der Advertiser als mit KI generiert oder verändert deklariert hat. Gleichen Sie diese URLs mit den Assets ab, die Sie rendern, um zu bestimmen, welche Creatives eine Advertiser-Deklaration tragen. Nur positiv deklarierte Assets sind enthalten.

Antwort ohne Gewinner

Beispielantwort, wenn keine Gewinner gefunden werden:

Weiterführende Literatur

Für weitere Beispiele und Anwendungsfälle: