Interfejs API Marketplace

Przegląd

Authorized Buyers Marketplace API to zbiór zasobów, za pomocą których kupujący mogą automatycznie zarządzać tymi elementami:

  • Negocjacje z wydawcami
  • Pakiety aukcji
  • Dostęp klientów do interfejsu Marketplace w Authorized Buyers

Ten przewodnik przedstawia interfejs Marketplace API i wyjaśnia, w jaki sposób zasoby interfejsu Marketplace API są mapowane na funkcje Marketplace w interfejsie Authorized Buyers.

Licytujący i kupujący

Interfejs Marketplace API jest spójny ze strukturą interfejsu API do określania stawek w czasie rzeczywistym. Oba interfejsy API używają bidders i buyers jako zasobów najwyższego poziomu na potrzeby działań licytującego i kupujących. Możesz używać tych samych nazw licytujących i kupujących w ścieżkach zasobów interfejsów API określania stawek w czasie rzeczywistym i Marketplace.

Klienci i ich użytkownicy

Interfejs Marketplace API umożliwia tworzenie klientów i użytkowników klientów oraz zarządzanie nimi, a także automatyczne przyznawanie agencjom i reklamodawcom dostępu do karty Rynek w interfejsie Authorized Buyers.

Client oznacza klienta, agencję lub reklamodawcę powiązanych z Twoim kontem w programie Authorized Buyers.

ClientUser oznacza konkretną osobę, która ma dostęp do interfejsu na poziomie Client. Użytkownicy klienta nie mają dostępu do interfejsu Marketplace API. Użytkownicy klienta mają ograniczony dostęp do karty Rynek na Twoim koncie. Uprawnienia użytkownika klienta są określane przez właściwość role podaną w jego nadrzędnym Client.

Inne zasoby w interfejsie Marketplace API odwołują się do klientów pod nazwą podaną w zasobie Clients.

Więcej informacji o klientach i ich użytkownikach w interfejsie Marketplace w Authorized Buyers znajdziesz w tych artykułach w Centrum pomocy:

Media plannerzy

Media planner to agencja lub inny podmiot, który niezależnie negocjuje umowy z wydawcami i pozwala co najmniej jednemu systemowi licytującemu ustalać stawki w imieniu sfinalizowanych umów. Są to albo aukcje prywatne, albo umowy preferencyjne. Do czasu ich sfinalizowania nie będzie można ich zobaczyć ani wchodzić z nimi w interakcję. Później pojawią się w odpowiedzi bidders.finalizedDeals.list.

Aby ustalić, czy określona umowa została wynegocjowana przez media plannera, możesz sprawdzić, czy pole mediaPlanner umowy zostało wypełnione. Media plannerzy tworzą listę identyfikatorów stanowisk DSP, które mogą dokonywać transakcji w ramach umowy. Można ją wyświetlić w polu eligibleSeatIds. W pytaniach o stawkę z określaniem stawek w czasie rzeczywistym identyfikatory stanowisk mogą pojawiać się na listach dozwolonych lub zablokowanych utworzonych przez wydawcę. Określają one, czy stawki są odfiltrowywane z aukcji. Mogą się wyświetlać w tych BidRequest polach:

  • Protokół OpenRTB
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Protokół Google RTB
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

Pakiety aukcji

Interfejs Marketplace API umożliwia subskrybowanie i anulowanie subskrypcji kupujących i klientów w pakietach aukcji oraz wyświetlanie pakietów aukcji, które subskrybujesz.

Element AuctionPackage jest podobny do pakietu kierowania w przypadku zasobów reklamowych na Rynku. Na przykład pakiet aukcji może być kierowany na zbiór adresów URL i aplikacji mobilnych, które są zgodne z interesami biznesowymi kupującego.

Nie możesz tworzyć nowych pakietów aukcji za pomocą interfejsu Marketplace API. Pakiety aukcji możesz tworzyć w interfejsie Marketplace w Authorized Buyers. Interfejs Marketplace API nie zawiera konkretnych informacji o kierowaniu powiązanych z pakietami aukcji.

Możesz udostępniać pakiety aukcji innym kupującym i klientom, a także korzystać z pakietów aukcji utworzonych przez Google lub innych kupujących.

Więcej informacji znajdziesz w sekcji Pakiety aukcji.

Profile wydawcy

Za pomocą interfejsu Marketplace API możesz wyświetlać profile wydawców, z którymi możesz negocjować.

PublisherProfile oznacza wydawcę w interfejsie Marketplace API. Inne zasoby w interfejsie Marketplace API odnoszą się do wydawców o nazwie określonej w pliku PublisherProfile.

Informacje w profilach wydawców są podobne do informacji na karcie Wydawcy na karcie Odkrywanie w interfejsie Marketplace w Authorized Buyers.

Więcej informacji znajdziesz w artykule Znajdowanie wydawców.

Oferty pakietowe i umowy

Do negocjowania umów z wydawcami możesz używać interfejsu Marketplace API. Oto kilka sposobów na zarządzanie umowami za pomocą interfejsu Marketplace API:

Oferty pakietowe przedstawiają ostatni stan negocjacji co najmniej 1 umowy między kupującym lub klientem a wydawcą i są podobne do karty Negocjacje w interfejsie Marketplace w Authorized Buyers.

Umowy to najnowsze warunki umowy negocjowanej w ramach danej oferty pakietowej i są porównywalne z listą umów w interfejsie platformy Authorized Buyers, która w przypadku danej oferty pakietowej jest oznaczona jako AKTUALNE.

Sfinalizowane umowy to umowy, które zostały zakończone fazę negocjacji i są gotowe do wyświetlenia. Obejmuje to umowy, które już są realizowane. Sfinalizowane umowy przypominają kartę Umowy w interfejsie Marketplace w Authorized Buyers.

W zależności od typu negocjowanego umowy działanie może się różnić w zależności od zasobu interfejsu Marketplace API. Kupujący nie mogą na przykład inicjować negocjacji w przypadku wszystkich typów umów. Więcej informacji o wdrażaniu interfejsu API Marketplace na potrzeby negocjacji znajdziesz w tych materiałach:

Więcej informacji o negocjacjach w interfejsie Marketplace w Authorized Buyers znajdziesz w tych artykułach: