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:
- Wyślij nowe oferty pakietowe.
- Negocjowanie z wydawcami.
- Sfinalizuj umowy.
- Wyświetlanie sfinalizowanych umów.
- Rozpocznij ponowne negocjacje sfinalizowanych umów.
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: