개요
Authorized Buyers Marketplace API는 구매자가 프로그래매틱 방식으로 다음을 관리하는 데 사용할 수 있는 리소스 모음입니다.
- 게시자와의 협상
- 입찰 패키지
- Authorized Buyers 마켓플레이스 UI에 대한 클라이언트 액세스
이 가이드에서는 Marketplace API를 소개하고 Marketplace API 리소스가 Authorized Buyers UI의 Marketplace 기능에 어떻게 매핑되는지 설명합니다.
입찰자 및 구매자
Marketplace API는 실시간 입찰 API의 구조와 일치합니다. 두 API 모두
bidders
및 buyers를
입찰자 및 구매자 작업의 루트 수준 리소스로 사용합니다. 실시간 입찰 API와 Marketplace API의 리소스 경로에서 동일한 입찰자 및 구매자 이름을 사용할 수 있습니다.
고객 및 고객 사용자
Marketplace API를 사용하여 클라이언트와 고객 사용자를 만들고 관리할 수 있으며, 대행사 또는 광고주에게 Authorized Buyers UI의 마켓플레이스 탭에 대한 액세스 권한을 프로그래매틱 방식으로 부여할 수 있습니다.
Client은
Authorized Buyers 계정과 연결된 클라이언트, 대행사 또는 광고주를
나타냅니다.
ClientUser은 Client에서 UI 액세스 권한이 있는 특정 개인을 나타냅니다. 클라이언트 사용자는 Marketplace API에 액세스할 수 없습니다. 클라이언트 사용자는 계정의 Marketplace 탭에 대한 제한된 액세스 권한을 갖습니다. 클라이언트 사용자 권한은 상위 Client에 지정된 role에 따라 결정됩니다.
Marketplace API의 다른 리소스는 Clients 리소스에 지정된 이름으로 클라이언트를 참조합니다.
Authorized Buyers 마켓플레이스 UI의 클라이언트 및 고객 사용자에 대해 자세히 알아보려면 다음 고객센터 도움말을 참고하세요.
미디어 기획자
미디어 기획자는 게시자와 독립적으로 거래를 협상하고 하나 이상의 입찰자가 확정된 거래를 대신하여 입찰할 수 있도록 하는 대행사 또는 기타 법인입니다. 이러한 거래는 비공개 입찰 또는 우선 거래이며 확정될 때까지 보거나 상호작용할 수 없으며, 완료되면 bidders.finalizedDeals.list 응답에 표시됩니다.
미디어 기획자가 특정 체결된 거래를 협상했는지 확인하려면 거래의 mediaPlanner 필드가 채워졌는지 확인하면 됩니다. 미디어 기획자는 거래에서 거래할 수 있는 DSP별 시트 ID 목록을 설정합니다. 이 목록은 eligibleSeatIds 필드를 사용하여 볼 수 있습니다. 실시간 입찰 입찰 요청에서 이러한 시트 ID는 게시자가 설정한 허용 목록 또는 차단 목록에 표시될 수 있으며, 이를 통해 입찰이 입찰에서 필터링되는지 결정됩니다. 다음 BidRequest 필드에 표시될 수 있습니다.
- OpenRTB 프로토콜
BidRequest.wseatBidRequest.bseatBidRequest.imp.pmp.deals.wseat
- Google RTB 프로토콜
BidRequest.adslot.allowed_seat_idsBidRequest.adslot.blocked_seat_idsBidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids
입찰 패키지
Marketplace API를 사용하여 입찰 패키지에서 구매자와 클라이언트를 구독 및 구독 취소하고 구독 중인 입찰 패키지를 볼 수 있습니다.
AuctionPackage는 마켓플레이스 인벤토리 타겟팅 번들과 유사합니다. 예를 들어 입찰 패키지는 구매자의 비즈니스 관심분야와 관련된 URL 및 모바일 애플리케이션 ID 모음을 타겟팅할 수 있습니다.
Marketplace API로는 새 입찰 패키지를 만들 수 없습니다. Authorized Buyers 마켓플레이스 UI를 사용하여 입찰 패키지를 만들 수 있습니다. Marketplace API에는 입찰 패키지와 관련된 특정 타겟팅 정보가 포함되어 있지 않습니다.
입찰 패키지를 다른 구매자 및 클라이언트와 공유할 수 있고, Google이 만든 입찰 패키지를 하거나 다른 구매자가 나와 공유할 수 있습니다.
자세한 내용은 입찰 패키지를 참고하세요.
게시자 프로필
Marketplace API를 사용하여 협상할 수 있는 게시자의 프로필을 볼 수 있습니다.
PublisherProfile은 Marketplace API의 게시자를 나타냅니다. Marketplace API의 다른 리소스는 PublisherProfile에 이름이 지정된 게시자를 참조합니다.
게시자 프로필에는 Authorized Buyers 마켓플레이스 UI의 탐색 탭에 있는 게시자와 정보가 유사합니다.
자세한 내용은 게시자를 찾는 방법을 참고하세요.
제안서 및 거래
Marketplace API를 사용하여 게시자와 거래를 협상할 수 있습니다. Marketplace API를 사용하여 거래를 관리하는 방법은 다음과 같습니다.
제안서는 구매자 또는 고객과 게시자 간의 하나 이상의 거래에 대한 최신 협상 상태를 나타내며, Authorized Buyers 마켓플레이스 UI의 협상 탭과 유사합니다.
거래는 특정 제안서에서 협상 중인 거래의 최신 조건을 나타내며, 특정 제안서에 대한 현재 협상이라고 표시된 Authorized Buyers 마켓플레이스 UI의 거래 목록과 유사합니다.
최종 거래는 협상 단계를 완료했고 게재할 준비가 된 거래를 나타냅니다. 여기에는 이미 게재 중인 거래가 포함됩니다. 확정된 거래는 Authorized Buyers 마켓플레이스 UI의 거래 탭과 비슷합니다.
협상하는 거래 유형에 따라 Marketplace API 리소스 간에 동작이 다를 수 있습니다. 예를 들어 구매자는 모든 거래 유형에 대해 협상을 시작할 수 없습니다. 협상을 위한 Marketplace API 구현에 대한 자세한 내용은 다음 리소스를 참조하세요.
Authorized Buyers 마켓플레이스 UI에서의 협상에 대해 자세히 알아보려면 다음을 참조하세요.