Marketplace-API

Überblick

Die Authorized Buyers Marketplace API ist eine Sammlung von Ressourcen, mit denen Käufer Folgendes programmatisch verwalten können:

  • Verhandlungen mit Publishern
  • Auktionspakete
  • Kundenzugriff auf die Benutzeroberfläche des Authorized Buyers-Marktplatzes

In diesem Leitfaden wird die Marketplace API vorgestellt und die Ressourcen der Marketplace API den Marktplatzfunktionen auf der Authorized Buyers-Benutzeroberfläche zugeordnet.

Bieter und Käufer

Die Marketplace API entspricht der Struktur der Real-time Bidding API. Beide APIs verwenden bidders und buyers als Ressourcen auf Stammebene für Bieter- und Käufervorgänge. Sie können dieselben Bieter- und Käufernamen in Ressourcenpfaden für die Echtzeitgebote und die Marketplace APIs verwenden.

Kunden und Kundennutzer

Mit der Marketplace API können Sie Kunden und Kundennutzer erstellen und verwalten sowie Agenturen und Werbetreibenden programmatisch Zugriff auf den Tab Marktplatz in der Authorized Buyers-Benutzeroberfläche gewähren.

Ein Client repräsentiert einen Kunden, eine Agentur oder einen Werbetreibenden, der bzw. der mit Ihrem Authorized Buyers-Konto verknüpft ist.

Ein ClientUser stellt eine bestimmte Person dar, die unter einer Client Zugriff auf die UI hat. Clientnutzer können nicht auf die Marketplace API zugreifen. Kundennutzer haben eingeschränkten Zugriff auf den Tab Marktplatz Ihres Kontos. Clientnutzerberechtigungen werden durch den role bestimmt, der in der entsprechenden übergeordneten Client angegeben ist.

Andere Ressourcen in der Marketplace API verweisen auf Clients anhand des in der Ressource Clients angegebenen Namen.

Weitere Informationen zu Kunden und Kundennutzern auf der Benutzeroberfläche des Authorized Buyers-Marktplatzes finden Sie in den folgenden Hilfeartikeln:

Mediaplaner

Ein Mediaplaner ist eine Agentur oder eine andere Entität, die unabhängig Deals mit Publishern aushandelt und einem oder mehreren Bietern ermöglicht, Gebote im Namen der abgeschlossenen Deals abzugeben. Es handelt sich entweder um private Auktionen oder Preferred Deals. Sie können sie erst aufrufen oder mit ihnen interagieren, wenn sie abgeschlossen sind. Danach sind sie in der bidders.finalizedDeals.list-Antwort zu sehen.

Wenn Sie feststellen möchten, ob ein bestimmter abgeschlossener Deal von einem Mediaplaner verhandelt wurde, können Sie prüfen, ob das Feld mediaPlanner des Deals ausgefüllt ist. Mediaplaner legen eine Liste mit DSP-spezifischen Nutzer-IDs fest, die für den Deal infrage kommen. Diese Liste wird im Feld eligibleSeatIds angezeigt. In Gebotsanfragen für Echtzeitgebote können diese Nutzer-IDs in vom Publisher festgelegte Zulassungslisten oder Sperrlisten erscheinen. Anhand dieser ID wird bestimmt, ob Gebote aus der Auktion herausgefiltert werden. Sie können in den folgenden BidRequest-Feldern angezeigt werden:

  • OpenRTB-Protokoll
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • RTB-Protokoll von Google
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

Auktionspakete

Mit der Marketplace API können Sie Auktionspakete für Käufer und Kunden abonnieren bzw. abbestellen sowie die Auktionspakete aufrufen, die Sie abonniert haben.

Ein AuctionPackage ähnelt einem Targeting-Set für Marktplatzinventar. Beispielsweise kann ein Auktionspaket auf eine Sammlung von URLs und IDs für mobile Apps ausgerichtet sein, die für die Geschäftsinteressen eines Käufers relevant sind.

Sie können mit der Marketplace API keine neuen Auktionspakete erstellen. Sie können Auktionspakete über die Benutzeroberfläche des Authorized Buyers-Marktplatzes erstellen. Die Marketplace API enthält keine spezifischen Targeting-Informationen, die mit Auktionspaketen verknüpft sind.

Sie können Auktionspakete für andere Käufer und Kunden freigeben und von Google oder anderen Käufern erstellte Auktionspakete für Sie freigeben.

Weitere Informationen finden Sie unter Auktionspakete.

Publisher-Profile

Mit der Marketplace API können Sie sich Profile von Publishern ansehen, mit denen Sie verhandeln können.

Ein PublisherProfile repräsentiert einen Publisher in der Marketplace API. Andere Ressourcen in der Marketplace API beziehen sich auf Publisher, deren Name in der PublisherProfile angegeben ist.

In Publisher-Profilen finden Sie ähnliche Informationen wie Publisher auf dem Tab Inventarsuche der Authorized Buyers-Benutzeroberfläche.

Weitere Informationen findest du unter Publisher finden.

Angebote und Deals

Mithilfe der Marketplace API können Sie Deals mit Publishern verhandeln. Hier sind einige Möglichkeiten, wie Sie mit der Marketplace API Deals verwalten können:

Angebote stellen den aktuellen Verhandlungsstatus eines oder mehrerer Deals zwischen einem Käufer oder Kunden und einem Publisher dar. Sie ähneln dem Tab Verhandlungen auf der Benutzeroberfläche des Authorized Buyers-Marktplatzes.

Deals stellen die aktuellen Bedingungen eines Deals dar, der im Rahmen eines bestimmten Angebots verhandelt wird. Sie sind mit der Liste der Deals auf der Benutzeroberfläche des Authorized Buyers-Marktplatzes mit dem Label AKTUELLE Verhandlung für ein bestimmtes Angebot vergleichbar.

Abgeschlossene Deals stellen Deals dar, die die Verhandlungsphase abgeschlossen haben und zur Auslieferung bereit sind. Dazu gehören auch Deals, die bereits ausgeliefert werden. Abgeschlossene Deals ähneln dem Tab Deals auf der Benutzeroberfläche des Authorized Buyers-Marktplatzes.

Je nach Art des Deals, den Sie verhandeln, kann das Verhalten zwischen Marketplace API-Ressourcen unterschiedlich sein. Beispielsweise können Käufer Verhandlungen nicht für alle Dealtypen initiieren. Weitere Informationen zur Marketplace API-Implementierung für Verhandlungen finden Sie in den folgenden Ressourcen:

Weitere Informationen zu Verhandlungen auf der Benutzeroberfläche des Authorized Buyers-Marktplatzes finden Sie hier: