Opis
Interfejs API Marketplace w Authorized Buyers to zbiór zasobów, za pomocą którego kupujący mogą automatycznie zarządzać tymi elementami:
- Negocjacje z wydawcami
- Pakiety aukcji
- Dostęp klientów do interfejsu platformy handlowej Authorized Buyers
W tym przewodniku omawiamy interfejs Marketplace API i wyjaśniamy, w jaki sposób zasoby interfejsu Marketplace API są mapowane na funkcje Marketplace w Authorized Buyers.
Licytujący i kupujący
Interfejs Marketplace API ma spójność 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ących i kupujących. W ścieżkach zasobów związanych z określaniem stawek w czasie rzeczywistym i interfejsami API Marketplace możesz używać tych samych nazw licytujących i kupujących.
Klienci i ich użytkownicy
Interfejs Marketplace API umożliwia tworzenie klientów i użytkowników klientów oraz zarządzanie nimi. Umożliwia też automatyczne przyznawanie agencjom i reklamodawcom dostępu do karty Rynek w interfejsie Authorized Buyers.
Client
reprezentuje klienta, agencję lub reklamodawcę powiązanego z Twoim kontem Authorized Buyers.
ClientUser
oznacza konkretną osobę, która ma dostęp do interfejsu na poziomie Client
. Użytkownicy klientów nie mają dostępu do interfejsu Marketplace API. Użytkownicy klientów mają ograniczony dostęp do karty Rynek na Twoim koncie. Uprawnienia użytkownika klienta są określane przez role
podany w jego nadrzędnym Client
.
Inne zasoby w interfejsie Marketplace API odwołują się do klientów za pomocą nazwy podanej w zasobie Clients
.
Więcej informacji o klientach i użytkownikach w interfejsie Marketplace w Authorized Buyers znajdziesz w tych artykułach w Centrum pomocy:
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. Pakiet aukcji może na przykład być kierowany na zbiór adresów URL i identyfikatorów 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 platformy handlowej 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 oraz udostępniać Ci pakiety aukcji utworzone przez Google lub innych kupujących.
Więcej informacji znajdziesz w artykule Pakiety aukcji.
Profile wydawcy
Za pomocą interfejsu Marketplace API możesz wyświetlać profile wydawców, z którymi możesz negocjować.
PublisherProfile
reprezentuje wydawcę w interfejsie Marketplace API. Inne zasoby w interfejsie Marketplace API odnoszą się do wydawców, których nazwa została określona w polu PublisherProfile
.
Profile wydawców na karcie Odkrywanie w interfejsie Marketplace w Authorized Buyers zawierają podobne informacje jak informacje na temat wydawców.
Więcej informacji znajdziesz w artykule Jak znaleźć wydawców.
Oferty pakietowe i umowy
Do negocjowania umów z wydawcami możesz używać interfejsu Marketplace API. Oto kilka sposobów wykorzystania interfejsu Marketplace API do zarządzania umowami:
- Wysyłanie nowych ofert pakietowych.
- Negocjuj z wydawcami.
- Finalizowanie umów.
- Wyświetlanie sfinalizowanych umów.
- Rozpocznij ponowne negocjacje sfinalizowanych umów.
Oferty pakietowe przedstawiają najnowszy stan negocjacji co najmniej jednej umowy między kupującym lub klientem a wydawcą i są podobne do karty Negocjacje w interfejsie platformy Authorized Buyers Marketplace.
Umowy to najnowsze warunki umowy negocjowanej w ramach danej oferty pakietowej i są porównywalne z listą umów w interfejsie platformy handlowej Authorized Buyers, które w przypadku danej oferty pakietowej są oznaczone etykietą CURRENT NEGOTIATION.
Sfinalizowane umowy to umowy, które zostały zakończone fazę negocjacji i są gotowe do wyświetlenia. Dotyczy to też umów, które są już realizowane. Sfinalizowane umowy są podobne do karty Umowy w interfejsie platformy handlowej Authorized Buyers.
W zależności od typu negocjowanego umowy zachowanie 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 Marketplace API na potrzeby negocjacji znajdziesz w tych materiałach:
Więcej informacji o negocjacjach w interfejsie Marketplace w Authorized Buyers znajdziesz w tych artykułach: